Difference between revisions of "WikiSH"

From Christoph's Personal Wiki
Jump to: navigation, search
 
(Notes)
Line 30: Line 30:
  
 
== Notes ==
 
== Notes ==
The default HTML is '''not''' XHTML and should be converted before using it. This, along with the [[CSS]] files, will make WikiSH [[:Category:International Standards|web standards compliant]].
+
The default HTML is '''not''' XHTML and should be converted before using it. This, along with the [[CSS]] files, will make WikiSH [[:Category:International Standards|web standards compliant]]. Simply running the output HTML file through [http://tidy.sourceforge.net/ HTML Tidy] should fix most of the non-XHTML code. Or, you could just modify the script and CSS file (as I have done).
  
 
== External links ==
 
== External links ==

Revision as of 06:41, 8 November 2006

WikiSH is a command line wiki using only /bin/sh and plain Awk. It also includes a Wiki Engine for a web server.

Installation

Installation is extremely easy:

  • Create a folder ~/.wiki/
  • Copy dot.wiki/* to ~/.wiki/
  • Copy wiki.sh to /usr/local/bin/ or some other place on the path

Commandline Usage

To make a HTML file from a wiki file call wiki.sh with the wiki file as parameter:

wiki.sh MyWiki.txt

This creates a HTML file called MyWiki.html.

For more information on wiki edititing see: http://wikish.do.homeunix.org/WikiFormattingGuide.html

Integration with vi

Add the following to your .vimrc:

 map <F6> :call Wikish()<CR><CR>

 " Wiki.sh file
 fun! Wikish()
   :!wiki.sh %
 endfun

Pressing F6 wikifies the currently open file in vi (i.e. runs wiki.sh on it and produces an HTML output file).

Notes

The default HTML is not XHTML and should be converted before using it. This, along with the CSS files, will make WikiSH web standards compliant. Simply running the output HTML file through HTML Tidy should fix most of the non-XHTML code. Or, you could just modify the script and CSS file (as I have done).

External links