Return to previewing_with_template.mdwn CVS log

Up to [NetBSD Developer Wiki] / wikisrc / wiki

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

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: 
1.7     ! leot       39: Please note that `wikisrc.setup` configuration file will be reused
        !            40: to refresh and rebuild the wiki in the next sections with a shorter
        !            41: commandline.
1.1       ryoon      42: 
1.3       ryoon      43: # Setting up bozohttpd webserver
                     44: Put the following line to your /etc/inetd.conf.
                     45: This line enables per-user directories.
                     46: 
                     47:     http       stream  tcp     nowait:600      _httpd  /usr/libexec/httpd      httpd -u /var/www
                     48: 
1.4       ryoon      49: Additionally, if you have disabled inetd, please enable it.
                     50: 
                     51:     $ vi /etc/rc.conf
                     52: 
                     53: and put
                     54: 
                     55:     inetd=YES
                     56: 
                     57: to it.
                     58: 
1.1       ryoon      59: # Previewing wikisrc
                     60: Open http://localhost/~your-user-name/wikisrc in your web browser.
                     61: 
                     62: # Rebuild the difference
                     63: 
                     64:     $ ikiwiki --refresh -setup ~/wikisrc.setup
                     65: 
                     66: # Rebuild all pages from scratch
                     67: 
                     68:     $ ikiwiki --rebuild -setup ~/wikisrc.setup