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

    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: # Previewing wikisrc
   41: Open http://localhost/~your-user-name/wikisrc in your web browser.
   42: 
   43: # Rebuild the difference
   44: 
   45:     $ ikiwiki --refresh -setup ~/wikisrc.setup
   46: 
   47: # Rebuild all pages from scratch
   48: 
   49:     $ ikiwiki --rebuild -setup ~/wikisrc.setup

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