This wiki is meant to be cloned so that you can consult it while being offline. There are several ways to do it depending on the system you use and the tools you have access to.

You have access to git

Cloning

It's as simple as:

git clone https://git.bleu255.com/repos/permacomputing.git

Markdown source files

Once you have done this you can:

  • open the wiki pages in their native plaintext forms as markdown files;
  • search through the wiki with plaintext file search tools like grep, rg or equivalent on your OS;
  • potentially navigate from pages to pages with the help of plugins in some text editors and or pagers that support markdown files.

HTML rendering

With the markdown source files you can also easily turn them into a local HTML static web site for offline browsing. To do that you need to install ikiwiki.

ikiwiki --rebuild --wikiname permacomputing --verbose /path/git/permacomputing /path/permacomputing-html

But that's not all!

If you call ikiwiki directly to generate HTML files to browse locally you will be disapointed as ikiwiki links points to folder in which an index.html will be found. This is fine for an HTTP server as most will default sending the index.html to the browser upon folder URL request. However, if you browse locally, the web browser will display the content of the folder instead. Making navigation super annoying. This script to be run everytime a new static version is built will fix all the href to actually point to the index.html instead of pointing to the folder.

/path/git/permacomputing/_tools/fix_local_href.sh /path/permacomputing-html

Now you can point your browser to /path/permacomputing-html/index.html and enjoy read only offline access to the wiki.

You don't have access to git

If you do not have access to git on your operating system, you can download a zip file that contains both the markdown source files and the generated HTML files, with the paths fixed. The zip file is generated once a week.

# pick your fav download tool...
wget http(s)://permacomputing.net/permacomputing.net.zip
fetch http(s)://permacomputing.net/permacomputing.net.zip
curl -O http(s)://permacomputing.net/permacomputing.net.zip