File:  [NetBSD Developer Wiki] / wikisrc / wiki / previewing_with_template.mdwn
Revision 1.7: download - view: text, annotated - select for diffs
Sat May 4 10:44:10 2019 UTC (3 years, 1 month ago) by leot
Branches: MAIN
CVS tags: HEAD
Add a note that `wikisrc.setup' is used to refresh/rebuild the wiki in later
sections.

    1: [[!meta title="Previewing 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: 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: 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.
   42: 
   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: 
   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: 
   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

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