pwigen is a minimal wiki based on RestructuredText. pwigen will take a single directory
(and its descendants), converting all RestructuredText files in to
a minimal wiki, where all WikiWord references that exist are immediately
cross-linked. A generic index.html file will be created for each
folder, listing the documents, directories, and breadcrumbs back to
the top of the stack.
What? Another Wiki???
pwigen was designed to solve two issues and one nuisance that I've
always had with wikis, meaning that it might not be suitable for
everyone. Of course, if it meets your needs, or could, please use
it, change it, do whatever you want with it. After all, like
everything I write pwigen is released under the MIT
License.
Features
The two aforementioned features are really quite
simple:
1. global links - I've always thought that it should be possible to
define links in a single file, and share them throughout the wiki.
As an example, I'm tired of maintaining links to my repository.
With pwigen, I simply edit the ourconfig.py to define my
repository link, and voila!
2. text editing - Almost all Wikis require text editing to occur in
the browser, which is a wiki strength. I prefer to write files,
check them into the repository, and use a trigger to generate the
repository. This allows multiple people to edit documents at the
same time, using standard revision control systems to access them,
and merge/track accordingly.
Nuisance
1. Many wikis (TWiki as an example) display a question mark, or
some other text around a WikiWord that doesn't link to anything.
pwigen handles post-linking, meaning that any WikiWord can be used,
and in the future, a document of the same name can be created, with
the links automatically being generated on the next
publishing.
Usage
Once installed, simply type pwigen
Next: Requirements and the Future of
pwigen