wikity

Wikity

Wikity is a tool that allows you to use Wikitext (used by Wikipedia, Fandom, etc) as a templating language to create HTML pages, useful in build tools such as Eleventy.

Install

Wikity is available on npm.

Local install	Global install
npm install wikity	npm install -g wikity

API

Node

• wikity.compile(folder?: string, options?: object): void
  • Compile all Wikitext (.wiki) files into HTML.
  • directory?: string
    • The folder to compile (default: ., the current directory).
  • options?: object
    • outputFolder?: string
      • Where outputted HTML files shall be placed (default: wikity-out).
    • templatesFolder?: string
      • What folder to place templates in (default: 'templates').
    • eleventy?: boolean
      • Whether front matter will be added to the outputted HTML for Eleventy to read (default: false).
    • defaultStyles?: boolean
      • Whether to use default wiki styling (default: true).
    • customStyles?: string
      • Custom CSS to style the wiki pages (default: '').
• wikity.eleventyPlugin(folder?: string, options?: object): void
  • An implementation of compile for use with Eleventy's addPlugin API.
• wikity.parse(input: string): string
  • Parse raw wikitext input into HTML.

const wikity = require('wikity');

// compile all .wiki files inside this directory
wikity.compile();

// parse wikitext from an input string
let html = wikity.parse(`'''bold''' [[link|text]]`); // <b>bold</b> <a href="/link"...>text</a>

Use Wikity along with Eleventy to compile your wiki files during the build process:

// .eleventy.js (eleventy's configuration file)
const wikity = require('wikity');
module.exports = function (eleventyConfig) {
    eleventyConfig.addPlugin( () => wikity.eleventyPlugin() );
}

Command-line

$ wikity help
Display a help message
$ wikity (compile|-c) [<folder>] [-o <folder>] [-t <folder>] [-e] [-d]
Compile Wikity with various options
$ wikity parse <input>
Parse raw input into HTML
$ wikity version
Display the latest version of Wikity

Usage

Use Wikitext (file extension .wiki) to create your pages.

Any wiki templates (called using {{template name}}) must be inside the templates/ folder by default.

Wiki markup

Markup	Preview
'''bold'''	bold
''italic''	italic
'''''bold italic'''''	bold italic
``code``	code
```code block```	code block
=heading=	heading
==subheading==	subheading
*bulleted	bulleted
**sub-bulleted	sub-bulleted
#numbered	numbered
##sub-numbered	sub-numbered
;term	term
:definition	definition
<ref>Text</ref>	[1]
<references/>	1. ↑ Text
[[internal link]]	internal link
[[link|display text]]	display text
[external-link]	[1]
[external-link display text]	display text
{{tp name}}	(contents of templates/tp_name.wiki)
{{tp name|arg=val}}	(ditto but {{{arg}}} is set to 'val')
{{{arg}}}	(value given by template)
{{{arg|default val}}}	(ditto but 'default val' if unset)
{| style="margin:1em"	table opening
! Cell heading	Cell heading
|- class="new-row"	new table row
| Cell content	Cell content
|}	table closing
{{#if:non-empty-string|text}}	text
{{#ifeq:1|2|true|false}}	false
{{#vardefine:varname|text}}	(saved to memory)
{{#var:varname}}	text (from memory)
{{#var:varname|default val}}	(ditto but 'default val' if unset)
{{#switch:a|a=1|b=2|c=3}}	1
{{#time:dd/mm/yy|2021-03-28}}	28/03/21
{{#lc:TEXT}}	text
{{#ucfirst:text}}	Text
{{#len:12345}}	5
{{#sub:string|2|4}}	ring
{{#pos:text|x}}	2
{{#padleft:text|5|_}}	_text
{{#padright:msg|5|_}}	msg__
{{#replace:Message|e|3}}	M3ssag3
{{#explode:A-B-C-D|-|2}}	C
{{#urlencode:t e x t}}	t%20e%20x%20t
{{#urldecode:a%20b%27c}}	a b'c
<noinclude>No</noinclude>	(blank outside a template)
<onlyinclude>Yes</onlyinclude>	Yes
<includeonly>Yes</includeonly>	Yes (blank inside a template)
<nowiki>[[no link]]</nowiki>	[[no link]]

Changelog

1.2.0

2021-04-01

• Added function eleventyPlugin() for use with Eleventy's addPlugin method.
• Added configuration option outputFolder to configure the folder the compiled HTML files are placed in.
• Added configuration option templatesFolder to configure the folder templates are placed in.
• Added CLI options --outputFolder, --templatesFolder, --eleventy, and --defaultStyles to change configuration options.
• Added support for tables.
• Added a warning when the parser detects non-repetition-based #time function syntax is being used.