Skip to content

Self-contained markdown compiler generating self-contained HTML documents

License

Notifications You must be signed in to change notification settings

h3rald/hastyscribe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Nimble

release license

HastyScribe

HastyScribe is a simple command-line program able to convert markdown files into HTML files.

Usage

hastyscribe [ options ] filename-or-glob-expression ...

Where:

  • filename-or-glob-expression is a valid markdown file or glob expression that will be compiled into HTML. Multiple files and/or globs are supported.
  • The following options are supported:
    • --output-file= causes HastyScribe to write output to a local file (Use --output-file=- to output to standard output).
    • --output-dir= or -d= allow you to specify an output directory for the generated HTML files. When used, it will override the --output-file option. Please note that this option does not preserve the input directory structure (that, for example, can be observed while traversing glob patterns); all output files will be placed directly in the specified directory.
    • --field/= causes HastyScribe to define custom field and set it to a specific value.
    • --user-css= causes HastyScribe to insert the contents of the specified local file as a CSS stylesheet.
    • --user-js= causes HastyScribe to insert the contents of the specified local file as a Javascript script.
    • --watermark= causes HastyScribe to embed and display an image as a watermark throughout the document.
    • --notoc causes HastyScribe to output HTML documents without automatically generating a Table of Contents at the start.
    • --noembed causes styles and images not to be embedded.
    • --fragment causes HastyScribe to output just an HTML fragment instead of a full document, without embedding any image, font or stylesheet.
    • --iso enables HastyScribe to use the ISO 8601 date format (e.g., 2000-12-31) in the footer of the generated HTML documents.
    • --minify-css uses an unsophisticated minifier on the built-in stylesheet before embedding it into HTML. Ignored when combined with --noembed.
    • --no-clobber or -n prevents HastyScribe from overwriting existing files. If a file with the same name already exists, HastyScribe will issue a warning and will not overwrite it.
    • --help causes HastyScribe to display the usage information and quit.

→ For more information, see the HastyScribe User Guide