💾 Archived View for gemini.ctrl-c.club › ~nttp › toys › eyeout.gmi captured on 2024-03-21 at 15:43:46. Gemini links have been rewritten to link to archived content

View Raw

More Information

⬅️ Previous capture (2021-12-03)

-=-=-=-=-=-=-

Keep an EyeOut

A tool to eye the outline of various documents (and convert them).

I'm not sure who needs this, but here it is: Keep an EyeOut can read the outline (i.e. only the headings) out of various file formats and write them out as indented text, or else in one of the same formats. These include:

Of these, OPML is the odd one out; the rest do headings in similar ways.

Download EyeOut 1.0 (7.5K)

Keep an EyeOut is written in Python (2.7 or 3.x) for the command line, and requires only the standard library. Usage:

$ ./eyeout.py -h
usage: eyeout.py [-h] [-v] [-f] [-i FORMAT] [-o FORMAT] [-m NUMBER]
                 [-n NUMBER]
                 [source]

Eye the outline of various documents.

positional arguments:
  source                file to read from (default: standard input)

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  -f, --formats         list supported file formats and exit
  -i FORMAT, --input FORMAT
                        format to read the input file as (default: auto)
  -o FORMAT, --output FORMAT
                        format to write the outline as (default: text)
  -m NUMBER, --minimum NUMBER
                        minimum heading level to read (default: 1)
  -n NUMBER, --nudge NUMBER
                        extra heading levels to add on output (default: 0)

Keep an EyeOut is open source under the MIT License (read the code). See also:

The original browser-based viewer

The latter can't export, but has folding support.

More small things

Last modified: 26 September 2021