the yellows111 wiki
Go to file
yellows111 f931edbfa5 0.0.3 - "mmm cheese"
* Formatted the default template
* Markdown content is now formatted using `@liquify/prettify`
  (not `esthetic` due to implementation issues)
+ Added the ability to specify the virtual prefix for the rendered pages
* Changed GNUmakefile to use double quotes instead of singles.

AC: gak gak gak gak gak gak gak gak gak gak gak gak gak gak gak
2024-04-17 12:39:36 +01:00
.gitignore Initial commit 2024-04-16 14:41:10 +01:00
GNUmakefile 0.0.3 - "mmm cheese" 2024-04-17 12:39:36 +01:00
LICENSE Initial commit 2024-04-16 14:41:10 +01:00
README.md 0.0.3 - "mmm cheese" 2024-04-17 12:39:36 +01:00
compile.js 0.0.3 - "mmm cheese" 2024-04-17 12:39:36 +01:00
package-lock.json 0.0.3 - "mmm cheese" 2024-04-17 12:39:36 +01:00
package.json 0.0.3 - "mmm cheese" 2024-04-17 12:39:36 +01:00
yiki.css 0.0.2 - "you like sausages?" 2024-04-16 22:50:07 +01:00

README.md

yiki - the yellows111 "wiki"

Takes a bunch of Markdown (*.md) files (default is from docs), and renders to HTML with preserved directory paths.

Features

  • Table of Contents on every page.
  • Preserved directory paths.
  • All headers can be jumped to.

Motivation

Just felt like writing it so I could write markdown instead of working with HTML syntax rules for my documentation/research archive.

Licensing

MIT. Review the LICENSE file if required.

How to use

You need a copy of GNU make (GPL-3 licensed software).

Use the gmake (or if it's the system makefile parser, make) command after writing Markdown (*.md) files to the docs directory.

Afterwards, check the build directory for the .html files.

Otherwise, if you just want to use yiki to render one file:

node compile source.md target.htm

Options

WIKINAME Specify what the "A new yiki!" text should be replaced with.

Example: gmake WIKINAME="I love options!"

VPREFIX Specify the virtual root of that the default template links to for the yiki.css and the index.html files.

Example: gmake VPREFIX:="/yiki/"

Contributing

I request (but not require) that you modify files without Carriage Returns, and to terminate new or modified files with a Line Feed character.