Skip to main content
Deno 2 is finally here šŸŽ‰ļø
Learn more

Simple Wiki

Lume theme to create a simple wiki.

  • Use markdown to save the pages
  • Instant search engine.

Prerequisites

Deno installed on your computer. Make sure to have it installed if you havenā€™t already done so.

Install as remote theme

The fastest and easiest way to use this theme is by importing it as a remote module. It allows to create a wiki in seconds and update it at any time just changing the version number in the import map. Run the following command to create a new project:

deno run -A https://lume.land/init.ts --theme=simple-wiki

Multilanguage support

Use the languages option to configure a multilanguage site:

site.use(wiki({
  languages: ["en", "gl", "es"],
}));

You can see an example in the demo folder. To customize it copy the _data.yml file in your blog root folder and edit it with your own data.

Use it as base template

To use this theme as a base template for a more customized blog, clone this repo and edit the _config.ts file. The source files are in the src folder. And you can remove the /demo folder.

Available options

Edit /src/_data.yml

Set options in your /src/_data.yml, such as, add extra links to the bottom of the sidebar menu:

menu_links: 
  - text: <strong>MyCo</strong>
    href: https://example.com
    icon: building-office
  - text: GitHub repository
    href: https://github.com/me/therepo
    icon: github-logo

Add additional script or css calls to your <head>, such as Fathom Analytics:

extra_head: |
  <!-- Fathom Analytics -->
    <script src="https://cdn.usefathom.com/script.js" data-site="A1B2C3D4" defer></script>
  <!-- / Fathom -->

Set the repository, which will cause an ā€œEdit This Pageā€ link to appear in the footer:

repo: [https://github.com/me/therepo](https://github.com/me/therepo)

In Markdown Content

In your markdown content files, use Github-style ā€œcalloutā€ codes to call attention to asides in your text.

> [!NOTE]  
> Highlights information that users should take into account, even when skimming.

> [!TIP]
> Optional information to help a user be more successful.

> [!IMPORTANT]  
> Crucial information necessary for users to succeed.

> [!WARNING]  
> Critical content demanding immediate user attention due to potential risks.

> [!CAUTION]
> Negative potential consequences of an action.

Set edit to false in page frontmatter, to suppress the ā€œEdit this Pageā€ link:

---
title: My Cool Page
...
edit: false
...
---
# The main topic
Lorem ipsum...

Credit

This theme uses phosphor icons, which are licensed under the MIT License.