Annotation of wikisrc/wiki/previewing_with_template.mdwn, revision 1.2

1.1       ryoon       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 \
1.2     ! ryoon      29:       --cgiurl http://localhost/~your-user-name/wikisrc/ikiwiki.cgi \
        !            30:       --plugin goodstuff --plugin websetup
1.1       ryoon      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 \
1.2     ! ryoon      36:       --plugin goodstuff --plugin websetup \
1.1       ryoon      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