shithub: wiki.9front.org

ref: 16156b6bd2b33291b4e6c62256bd251c275074f6
dir: /index.md/

View raw version
9front Community Wiki
=====================

**THIS IS NOT OFFICIAL DOCUMENTATION**: initial (and main) source of
knowledge is still [FQA](http://fqa.9front.org).

This is the community wiki, a repository of live documents covering
plan9/front theory, usage, and development.

**ACHTUNG!** This wiki is a work-in-progress prototype.
See the [technical details](this.html).<sup>[not up to date]</sup>

How to access
-------

Document updates are periodically fetched by the backend, which
renders the document tree and makes it available for reading via 9p and
HTTP.

### HTTP

Visit [wiki.9front.org](http://wiki.9front.org) with a web browser.

### 9p (NOT BEING UPDATED)

On Plan 9, run:

	9fs tcp!wiki.a-b.xyz!909 /n/wiki

Contributing
------------

The document source repository is currently hosted and available
for browsing
[here](http://shithub.us/garden/wiki.9front.org/HEAD/info.html).

Get it locally for reading:

	git/clone git://shithub.us/garden/wiki.9front.org

For reading and writing:

	git/clone hjgit://shithub.us/garden/wiki.9front.org

Everyone is invited to get write access by joining [Shithub™](http://shithub.us).
Otherwise you may submit patches to the `oftc/#cat-v` IRC channel,
or to the [email protected] mailing list, or communicating with your favorite
contributor.

Contributed documents are mostly expected to be markdown-formatted
files, denoted by the `.md` file extension.

The formatting syntax used by the markdown processor
[discount](https://github.com/Orc/discount)
used by the backend is documented in the manual page
[markdown(6)](http://a-b.xyz/6e/c837).

Additionally, plain text files and HTML documents may be entered into
the repository with file extensions `.txt` and `.shtml`, respectively.
These will be copied verbatim into the rendered document tree.

**Warning** only one of `a.md`, `a.txt`, or `a.shtml` may exist at
the same time.  Otherwise the document generation will fail. This is
a problem with the current implementation and may be fixed in the
future.

Images and other static content is best hosted outside this repository.
Dedicated upload and stable link space may be provided later.