Return to previewing_with_template.mdwn CVS log

Up to [NetBSD Developer Wiki] / wikisrc / wiki

Add page for previewing

    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: 
   31: ## Dump setup file for shorter commandline
   32:     $ ikiwiki --verbose /usr/cvs/wikisrc ~/public_html/wikisrc \
   33:       --url=http://localhost/~your-user-name/wikisrc --cgiurl \
   34:       http://localhost/~your-user-name/wikisrc/ikiwiki.cgi \
   35:       --dumpsetup ~/wikisrc.setup
   36: 
   37: 
   38: # Previewing wikisrc
   39: Open http://localhost/~your-user-name/wikisrc in your web browser.
   40: 
   41: # Rebuild the difference
   42: 
   43:     $ ikiwiki --refresh -setup ~/wikisrc.setup
   44: 
   45: # Rebuild all pages from scratch
   46: 
   47:     $ ikiwiki --rebuild -setup ~/wikisrc.setup