File:  [NetBSD Developer Wiki] / wikisrc / wiki / previewing_with_template.mdwn
Revision 1.4: download - view: text, annotated - select for diffs
Sat Jan 11 01:52:07 2014 UTC (8 years, 4 months ago) by ryoon
Branches: MAIN
CVS tags: HEAD
Add inetd stuff

    1: [[!meta title="Previwing NetBSD Wiki with template"]]
    2: 
    3: Some template requires ikiwiki cgi mode.
    4: If you setup ikiwiki with cgi mode, you can ignore cgi part of ikiwiki
    5: for previewing your changes.
    6: 
    7: # Getting wikisrc
    8: To preview your changes, wikisrc is needed.
    9: See [[cvs]] page, or get wikisrc CVS repository with rsync, and checkout
   10: from it (wikisrc is hosted on wiki.NetBSD.org with rsync).
   11: 
   12: Assuming that your wikisrc tree is in /usr/cvs/wikisrc.
   13: 
   14: # Installing ikiwiki engine
   15: 
   16:     $ cd /usr/pkgsrc/www/ikiwiki
   17:     $ make install clean
   18: 
   19: 
   20: # Setting up ikiwiki with cgi mode
   21: Use page.tmpl requires cgi support (it has HAVE_ACTIONS conditionals)
   22: 
   23: ## Prepare destination directory
   24:     $ mkdir ~/public_html
   25: 
   26: ## Build html files
   27:     $ ikiwiki --verbose /usr/cvs/wikisrc ~/public_html/wikisrc \
   28:       --url=http://localhost/~user-user-name/wikisrc \
   29:       --cgiurl http://localhost/~your-user-name/wikisrc/ikiwiki.cgi \
   30:       --plugin goodstuff --plugin websetup
   31: 
   32: ## Dump setup file for shorter commandline
   33:     $ ikiwiki --verbose /usr/cvs/wikisrc ~/public_html/wikisrc \
   34:       --url=http://localhost/~your-user-name/wikisrc --cgiurl \
   35:       http://localhost/~your-user-name/wikisrc/ikiwiki.cgi \
   36:       --plugin goodstuff --plugin websetup \
   37:       --dumpsetup ~/wikisrc.setup
   38: 
   39: 
   40: # Setting up bozohttpd webserver
   41: Put the following line to your /etc/inetd.conf.
   42: This line enables per-user directories.
   43: 
   44:     http	stream	tcp	nowait:600	_httpd	/usr/libexec/httpd	httpd -u /var/www
   45: 
   46: Additionally, if you have disabled inetd, please enable it.
   47: 
   48:     $ vi /etc/rc.conf
   49: 
   50: and put
   51: 
   52:     inetd=YES
   53: 
   54: to it.
   55: 
   56: # Previewing wikisrc
   57: Open http://localhost/~your-user-name/wikisrc in your web browser.
   58: 
   59: # Rebuild the difference
   60: 
   61:     $ ikiwiki --refresh -setup ~/wikisrc.setup
   62: 
   63: # Rebuild all pages from scratch
   64: 
   65:     $ ikiwiki --rebuild -setup ~/wikisrc.setup

CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb