The site is served as GitHub Pages at https://freeplane.github.io/docs/.
The main site is Docs
, with Attic
as a sub-site.
Each one is a separate docsify instance.
Attic
contains MediaWiki pages (pre-2022 wiki) migrated to Markdown for GitHub.
The vision is to bring all MediaWiki content from Attic
to Docs
.
Some content in Attic
might be outdated, some unconverted, some media files missing.
Each attic
page needs to be reviewed/completed before incorporating it to Docs
.
When a page is incorporated to Docs
and removed from Attic
, all existing Attic
pages linking to it should be updated.
The new link should use docsify special instruction ':ignore', e.g. [Page Name](/docs/#/<sub-folder>/Page_Name ':ignore')
Both sites use
- relativePath: true
- nested sidebars with CSS in index.html
- header and footer hook
- search plugin with a dedicated namespace for each site
- image zoom plugin
- Groovy language syntax highlight
- Install python, if not already available → https://www.python.org/downloads/
- Create a directory e.g.
freeplane-github-io
- Change to the directory you created:
cd freeplane-github-io
- Clone the repository:
git clone https://github.com/freeplane/docs.git
- In
freeplane-github-io
run python http server:python -m http.server 3000
→ Manually preview your site - Browse the site at http://127.0.0.1:3000/docs/