- Notifications
You must be signed in to change notification settings - Fork12
a personal knowledge base system. markdown markup, runs in the browser
License
cblgh/monotome
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
i wanted to start a wiki so i made this
- Clone this project
- Open a terminal
- Navigate to the cloned directory
- Run
python -m http.server 8900
- Browse to
localhost:8900
to use the wiki
Subjects are ordered into a simple directory structure which is mirrored byindex.json
.
You can fillindex.json
'ssubjects
by hand if you want to avoid running a script. You can also runnode monotome/bin/generate.js
, which will updateindex.json
for you.
Thisreadme.md
is the start page of your wiki and eachreadme.md
within a subject folder is the overview page for that subject.
Monotome supports a link syntax for inlining other monotome articles (i.e. plain markdown files) into a source article. This technique is commonly known astransclusion.
Any link<a>
with an href referring to a local file & which has the anchor tag attributedownload
will be inlined into the document. That is, if one file has some content followed by<a href="example/first.md" download></a>
, then the contents ofexample/first.md
is inlined in place of the anchor tag, at the position of the tag definition.
Monotome keeps track of backlinks, or incoming links from one article inside monotome to another. To discover backlinks, runnode monotome/bin/generate.js
. For a taste of what backlinks look like in practice, see the gif below.
Monotome has support for the common[[wiki]]
syntax, although it implements it in a slightlydifferent way. When you use wiki syntax on a word or phrase in your wiki, a link will be created.Clicking that link will perform a search on the subjects and articles of a wiki and navigate tothe first result of that search.
If the result was not what you wanted, you can page the searchlink results with the left andright arrow keys.
Just as[article](subject/file.md)
links are tracked with backlinks, so too are[[wiki]]
links.
monotome's code and resources are licensed under AGPL.
marked.js
is MIT-licensed and Inter UI is available underSIL OPEN FONT LICENSE Version 1.1
Read the respective license files for more information.
About
a personal knowledge base system. markdown markup, runs in the browser