update with new features to deal with large sites

[git.ikiwiki.info.git] / doc / setup / byhand.mdwn

diff --git a/doc/setup/byhand.mdwn b/doc/setup/byhand.mdwn
index b2ff7bd018e0de6d85ee80dedd40a6de240b1418..6d0f37cd9e05333ea35a211ebdc4ed36e3aabd0f 100644 (file)
--- a/doc/setup/byhand.mdwn
+++ b/doc/setup/byhand.mdwn
@@ -93,9 +93,15 @@ will set everything up.
 
 ## Turn on additional features.
 
 
 ## Turn on additional features.
 

+[[!template id="note" text="""
+CGI configuration is heavily dependent on webserver. Figure out (or
+configure) the location and/or filename extension your webserver
+needs to execute a CGI, then set `cgi_wrapper` to a suitable path.
+"""]]
+

 Now you have a basic wiki with a setup file. Time to experiment
 with ikiwiki's many features. 
 Now you have a basic wiki with a setup file. Time to experiment
 with ikiwiki's many features. 

-   
+

 Let's first enable a key wiki feature and set up [[CGI]] to allow
 editing the wiki from the web. Just edit ikiwiki.setup, uncomment the
 settings for the `cgi_wrapper`, make sure the filename for the cgi wrapper
 Let's first enable a key wiki feature and set up [[CGI]] to allow
 editing the wiki from the web. Just edit ikiwiki.setup, uncomment the
 settings for the `cgi_wrapper`, make sure the filename for the cgi wrapper


@@ -104,7 +110,7 @@ is ok, run `ikiwiki --setup ikiwiki.setup`, and you're done!
 There are lots of other configuration options in ikiwiki.setup that you
 can uncomment, configure, and enable by re-running
 `ikiwiki --setup ikiwiki.setup`. Be sure to browse through all the
 There are lots of other configuration options in ikiwiki.setup that you
 can uncomment, configure, and enable by re-running
 `ikiwiki --setup ikiwiki.setup`. Be sure to browse through all the

-[[plugins]]..
+[[plugins]].

 
 ## Put your wiki in revision control.
 
 
 ## Put your wiki in revision control.
 


@@ -124,7 +130,7 @@ revision control.
        ikiwiki-makerepo svn $SRCDIR $REPOSITORY
 """]]
 
        ikiwiki-makerepo svn $SRCDIR $REPOSITORY
 """]]
 

-[[!toggle id=subversion text="CVS"]]
+[[!toggle id=cvs text="CVS"]]

 [[!toggleable id=cvs text="""
        REPOSITORY=~/wikirepo
        ikiwiki-makerepo cvs $SRCDIR $REPOSITORY
 [[!toggleable id=cvs text="""
        REPOSITORY=~/wikirepo
        ikiwiki-makerepo cvs $SRCDIR $REPOSITORY


@@ -177,7 +183,7 @@ about using the git repositories.
 
 Once your wiki is checked in to the revision control system, you should
 configure ikiwiki to use revision control. Edit your ikiwiki.setup, set
 
 Once your wiki is checked in to the revision control system, you should
 configure ikiwiki to use revision control. Edit your ikiwiki.setup, set

-`rcs` to the the revision control system you chose to use.  Be careful, 
+`rcs` to the revision control system you chose to use.  Be careful, 

 you may need to use the 'fullname'.  For example, 'hg' doesn't work, you
 should use mercurial.  Be sure to set `svnrepo` to the directory for your
 repository, if using subversion. Uncomment the configuration for the wrapper
 you may need to use the 'fullname'.  For example, 'hg' doesn't work, you
 should use mercurial.  Be sure to set `svnrepo` to the directory for your
 repository, if using subversion. Uncomment the configuration for the wrapper