Learn Markdown! Then check out MDwiki's quick start.
Whenever you feel stuck, go to MDwiki's own site for further information.
First off fork this repo and call it something like <MyProject>-wiki.
It all begins by creating an initial file structure for any language that you would like to support. For example, if you're interested having a wiki in English, then you will duplicate ll_CC folder and rename your copy to en. (For a complete list of languages [ll] and country codes [CC] consult here.)
ll_CC is a starter template folder which you shouldn't ever edit directly, since you may loose your changes when MDwiki gets updated later.
If you want to have your wiki in more than one language, then you duplicate
ll_CCas many as necessary and name each copy with the appropriate language and country code. (Country code is optional and it is only useful if you want to distinguish, for instance, American English from British English, such as:en_USanden_GB.)
You should have a language wiki folder by now, if not, go back and read above to create one.
Suppose your first wiki is going to be in English, hence you must have a folder called en, as previously described.
- Open
index.htmlfile with your favorite plain text editor (the one that is at the same level wherell_CCand your language folder is located, NOT the one inside your language folder) - Find where it says "Override
ll_CCbelow with your default language & country code" - Change refresh meta tag from
url=ll_CC/tourl=en/(trailing/is very important)
All file references here are relative to their respective language folder.
| Name | Type | Description |
|---|---|---|
index.md |
File | Starting poing (a.k.a. "home page") for your wiki. Note this is not the index.html, but index.md! |
navigation.md |
File | Various settings of your wiki (e.g., name of your wiki, items in the navigation bar at the top, etc.) |
config.json |
File | If you don't know what this is for, don’t touch it. |
pages |
Folder | Ideally, inside this folder, you create one *.md file for every page inside your wiki (e.g., foo.md, much-longer-names-are-also-okay.md, etc.) You can also create as many subfolders as you need, just remember to link them accordingly. |
uploads |
Folder | An example folder structure where you could put other files. Although it is best to host your files somewhere else, like Dropbox, or a CDN, etc. |
Instead of using absolute URLs when linking one wiki page to another, use relative URLs.
For instance if en/pages/foo.md page had to link to en/pages/bar.md, it is enough to just [Click here](bar.md). Same is true, almost, for the uploads, but a slightly different syntax is necessary: . (Note the leading / is very important.)
Instead of hosting your uploads inside the uploads folder, consider using Dropbox, Google Drive, or any CDN.
In order to preview your changes locally, prior to publishing online, you may need to take some actions. Below some starting points for each operating system, also check out MDwiki's frequently asked questions section for some ideas.
The easiest way to serve up static sites on a Mac is to use Anvil. Go ahead and download it from their website, install and add a site using the status bar icon: simply select the folder where your wiki is located on your Mac.
This section needs some ❤️.
This section needs some ❤️.
You don't need to read below here or do anything at all if you're only interested creating your own wiki. This section is for developers or maintainers of this repository.
Current version: 0.6.2.
- Go to https://github.com/Dynalon/mdwiki/releases/latest
- Click on the green button on that page to download the latest release
- Extract the contents of the archive file
- Copy
mdwiki-slim.htmlfile from the extracted files ontoll_CC/index.htmlfile in this repository by renaming, thus overridingindex.html - Update the version information above
- Commit and push your changes
You can now delete any files downloaded previously, if you want to.