Static Publishing

Static Publishing turns your wiki into a website-and-blog: a folder of plain HTML you can host anywhere — Dropbox, GitHub Pages, any web server, no moving parts.

Setting up (once)

1. Open the Static palette.
2. Give the site a title and (optionally) a tagline.
3. Set the site URL if you know where it will live — the RSS feed uses it for absolute links.
4. Choose… a publish folder. All of this is remembered per document.

Posting

Open any page and click ＋ Post in the Static palette. The page is stamped with the date and joins the blog. Posts list newest-first in the palette; ✕ Unpost takes one back. Pages don't have to be posts to be published — read on.

Publishing

Click ⌁ Publish Site (or File ▸ Publish Static Site once configured). MojoPad writes, silently and completely:

• index.html — the blog home: your ten newest posts, in full.
• contents.html — every published page, grouped the way you filed it in the sidebar and listed alphabetically inside each folder. This is how a reader reaches a page you never posted, and it is linked from the top of every page.
• archive.html — every post, one line each.
• feed.xml — a valid RSS 2.0 feed of the latest twenty posts.
• Every page in the wiki, published flat alongside — so when a post links to another page, the link works on the web too.
• static.css — a clean, serif, readable design.
• Search — a search box on every page (search-index.js + search.js). Visitors type and get instant, highlighted results across your whole site. It's entirely client-side — a small prebuilt index plus a few KB of JavaScript — so the site stays a fast, private folder of files with nothing to host or configure. (Press /, the forward-slash key, to jump to the box.)
• Your attachments (PDFs and friends).

Write, post, publish, sync the folder to your host. That's the whole pipeline.

A site without a blog

You do not have to post anything at all. Publish a wiki nobody has posted from — a folder of web clippings, a reference you want online, notes for a class — and you get a complete, searchable site whose front page is the contents. Nothing is missing and nothing is hidden; there is simply no blog on it, so the Archive and RSS links stay away rather than pointing at empty rooms.

Post one page later and the front page becomes the blog home, with the contents still one click away in the header. Posting is what turns a site into a blog, and it is reversible.

What stays home

Encrypted pages, pages marked skip-on-export, and special pages (Template:, Event:, Plugin:, Clipping:) are never published.

Make it yours

Create a page named Template: Site containing your own HTML shell, using the tokens $content$, $pageTitle$, $siteTitle$, and $tagline$ — MojoPad pours each page into it. And if a page named Event: Publish exists, its script runs before every publish. See Scripting: Event Pages.