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

1.6     ! leot        1: [[!meta title="Previewing NetBSD Wiki with template"]]
1.1       ryoon       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
1.5       ryoon      21: page.tmpl requires cgi support (it has HAVE_ACTIONS conditionals)
1.1       ryoon      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: 
1.3       ryoon      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: 
1.4       ryoon      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: 
1.1       ryoon      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