* Add softwaresite example.

14 files changed, 122 insertions, 0 deletions

diff --git a/doc/examples.mdwn b/doc/examples.mdwn
index be6f11e3a..adcb1575e 100644
--- a/doc/examples.mdwn
+++ b/doc/examples.mdwn
@@ -2,6 +2,8 @@ To make it easier to get started using ikiwiki for some common tasks, this
 page gives some examples of ways to use ikiwiki.
 
 * [[blog]] - a weblog with tags, a tag cloud, archives, and an optional sidebar
+* [[softwaresite]] - a website for some software package, the package
+  can also build static html docs from its wiki
 
 Each example is contained in its own subdirectory; just copy the source
 files into your wiki to start using one of the examples.
diff --git a/doc/examples/softwaresite.mdwn b/doc/examples/softwaresite.mdwn
new file mode 100644
index 000000000..2b68ee4e4
--- /dev/null
+++ b/doc/examples/softwaresite.mdwn
@@ -0,0 +1,13 @@
+This is an [[example_software_package_website|index]].
+Just copy the softwaresite subdirectory into your wiki to quickly produce
+a website for a piece of software.
+
+Some additional configuration you might want to do:
+
+* Make sure to configure ikiwiki to generate RSS or Atom feeds.
+
+* The softwaresite/doc subdirectory is intended to hold docs about your
+  software package. These docs can be included in the package itself;
+  there is a [[softwaresite/doc/Makefile]] that will use ikiwiki to build
+  static html documentation from the docs directory. ikiwiki itself uses a
+  similar system to build its documentation.
diff --git a/doc/examples/softwaresite/contact.mdwn b/doc/examples/softwaresite/contact.mdwn
new file mode 100644
index 000000000..facfa900f
--- /dev/null
+++ b/doc/examples/softwaresite/contact.mdwn
@@ -0,0 +1,7 @@
+To reach the authors of FooBar, join channel `#foobar` on the `examplenet`
+irc network.
+
+There's also a mailing list,
+[foobar-l](http://example.com/mailman/listinfo/foobar-l).
+
+Be sure to read the [[doc/FAQ]] first.
diff --git a/doc/examples/softwaresite/doc.mdwn b/doc/examples/softwaresite/doc.mdwn
new file mode 100644
index 000000000..f134febb6
--- /dev/null
+++ b/doc/examples/softwaresite/doc.mdwn
@@ -0,0 +1,5 @@
+Documentation for FooBar.
+
+* First, you'll want to [[install]] it.
+* Then you'll want to [[setup]] the config files.
+* There's also a [[FAQ]].
diff --git a/doc/examples/softwaresite/doc/.ikiwiki/index b/doc/examples/softwaresite/doc/.ikiwiki/index
new file mode 100644
index 000000000..9f38d2ad0
--- /dev/null
+++ b/doc/examples/softwaresite/doc/.ikiwiki/index
@@ -0,0 +1,43 @@
+mtime=1164207299 ctime=1146711708 src=smileys/star_off.png dest=smileys/star_off.png
+mtime=1164207299 ctime=1157693331 src=pagespec.mdwn dest=pagespec.html link=SubPage
+mtime=1164207299 ctime=1158340031 src=local.css dest=local.css
+mtime=1164207299 ctime=1146711708 src=smileys/smile2.png dest=smileys/smile2.png
+mtime=1164207283 ctime=1164122509 src=shortcuts.mdwn dest=shortcuts.html
+mtime=1164207299 ctime=1146711708 src=smileys/alert.png dest=smileys/alert.png
+mtime=1164207299 ctime=1156307042 src=preprocessordirective.mdwn dest=preprocessordirective.html link=WikiLink
+mtime=1164207299 ctime=1146711708 src=smileys/checkmark.png dest=smileys/checkmark.png
+mtime=1164207299 ctime=1146711708 src=smileys/icon-info.png dest=smileys/icon-info.png
+mtime=1164207357 ctime=1164207356 src=Makefile dest=Makefile
+mtime=1164207299 ctime=1150866269 src=subpage/linkingrules.mdwn dest=subpage/linkingrules.html link=SubPage link=WikiLink
+mtime=1164207299 ctime=1146711708 src=smileys/smile4.png dest=smileys/smile4.png
+mtime=1164207299 ctime=1164132019 src=openid.mdwn dest=openid.html
+mtime=1164207357 ctime=1164206463 src=install.mdwn dest=install.html
+mtime=1164207299 ctime=1146711708 src=smileys/tired.png dest=smileys/tired.png
+mtime=1164207299 ctime=1146711708 src=smileys/angry.png dest=smileys/angry.png
+mtime=1164207299 ctime=1146711708 src=smileys/star_on.png dest=smileys/star_on.png
+mtime=1164207299 ctime=1146711708 src=smileys/ohwell.png dest=smileys/ohwell.png
+mtime=1164207299 ctime=1146711708 src=smileys/biggrin.png dest=smileys/biggrin.png
+mtime=1164207299 ctime=1156719536 src=wikilink.mdwn dest=wikilink.html link=WikiLink link=SubPage/LinkingRules link=SubPage link=SandBox
+mtime=1164207299 ctime=1164018990 src=markdown.mdwn dest=markdown.html link=HelpOnFormatting link=WikiLink link=PreProcessorDirective
+mtime=1164207299 ctime=1146711708 src=smileys/thumbs-up.png dest=smileys/thumbs-up.png
+mtime=1164207299 ctime=1146711708 src=smileys/redface.png dest=smileys/redface.png
+mtime=1164207299 ctime=1143078587 src=sandbox.mdwn dest=sandbox.html link=WikiLink
+mtime=1164207299 ctime=1158368977 src=helponformatting.mdwn dest=helponformatting.html link=MarkDown link=WikiLink link=PreProcessorDirective link=smileys
+mtime=1164207299 ctime=1142831466 src=subpage.mdwn dest=subpage.html link=SubPage link=SubPage/LinkingRules link=LinkingRules
+mtime=1164207299 ctime=1156719661 src=smileys.mdwn dest=smileys.html link=smileys/smile.png link=smileys/biggrin.png link=smileys/smile2.png link=smileys/smile3.png link=smileys/smile4.png link=smileys/ohwell.png link=smileys/devil.png link=smileys/angry.png link=smileys/frown.png link=smileys/sad.png link=smileys/tongue.png link=smileys/redface.png link=smileys/tired.png link=smileys/thumbs-up.png link=smileys/icon-error.png link=smileys/checkmark.png link=smileys/idea.png link=smileys/attention.png link=smileys/alert.png link=smileys/star_on.png link=smileys/star_off.png link=WikiLink
+mtime=1164207299 ctime=1146711708 src=smileys/attention.png dest=smileys/attention.png
+mtime=1164207299 ctime=1146711708 src=smileys/frown.png dest=smileys/frown.png
+mtime=1164207299 ctime=1163984655 src=style.css dest=style.css
+mtime=1164207299 ctime=1146711708 src=smileys/devil.png dest=smileys/devil.png
+mtime=1164207357 ctime=1164206582 src=faq.mdwn dest=faq.html
+mtime=1164207299 ctime=1146711708 src=smileys/smile.png dest=smileys/smile.png
+mtime=1164207283 ctime=1162361786 src=blog.mdwn dest=blog.html link=PreProcessorDirective link=PageSpec link=SubPage
+mtime=1164207299 ctime=1146711708 src=smileys/idea.png dest=smileys/idea.png
+mtime=1164207299 ctime=1146711708 src=smileys/smile3.png dest=smileys/smile3.png
+mtime=1164207299 ctime=1146711708 src=smileys/tongue.png dest=smileys/tongue.png
+mtime=1164207299 ctime=1146711708 src=smileys/icon-error.png dest=smileys/icon-error.png
+mtime=1164207357 ctime=1164206513 src=setup.mdwn dest=setup.html
+mtime=1164207357 ctime=1164206388 src=index.mdwn dest=index.html link=install link=setup link=FAQ
+mtime=1164207299 ctime=1162141053 src=favicon.ico dest=favicon.ico
+mtime=1164207299 ctime=1146711708 src=smileys/sad.png dest=smileys/sad.png
+mtime=1164207299 ctime=1125596662 src=wikiicons/diff.png dest=wikiicons/diff.png
diff --git a/doc/examples/softwaresite/doc/.ikiwiki/lockfile b/doc/examples/softwaresite/doc/.ikiwiki/lockfile
new file mode 100644
index 000000000..e69de29bb
--- /dev/null
+++ b/doc/examples/softwaresite/doc/.ikiwiki/lockfile
diff --git a/doc/examples/softwaresite/doc/Makefile b/doc/examples/softwaresite/doc/Makefile
new file mode 100644
index 000000000..5a5fc85ee
--- /dev/null
+++ b/doc/examples/softwaresite/doc/Makefile
@@ -0,0 +1,9 @@
+# Build static html docs suitable for being shipped in the software
+# package.
+
+all:
+	ikiwiki `pwd` html -v --plugin=goodstuff \
+		--no-rcs --exclude=/discussion --exclude=html --no-discussion
+
+clean:
+	rm -rf .ikiwiki
diff --git a/doc/examples/softwaresite/doc/faq.mdwn b/doc/examples/softwaresite/doc/faq.mdwn
new file mode 100644
index 000000000..249c6f779
--- /dev/null
+++ b/doc/examples/softwaresite/doc/faq.mdwn
@@ -0,0 +1,11 @@
+FooBar frequently asked questions.
+
+[[toc ]]
+
+## Is this a real program?
+
+No, it's just an example.
+
+## Really?
+
+Yes, really.
diff --git a/doc/examples/softwaresite/doc/install.mdwn b/doc/examples/softwaresite/doc/install.mdwn
new file mode 100644
index 000000000..1e877a45a
--- /dev/null
+++ b/doc/examples/softwaresite/doc/install.mdwn
@@ -0,0 +1,10 @@
+Installing FooBar is pretty straightforward:
+
+	tar xzvf foobar.tar.gz
+	cd foobar
+	./configure
+	make
+	make install
+
+Note that you'll need `libfrobnicate` installed first. You might also want to
+edit `config.h`.
diff --git a/doc/examples/softwaresite/doc/setup.mdwn b/doc/examples/softwaresite/doc/setup.mdwn
new file mode 100644
index 000000000..aa2b26345
--- /dev/null
+++ b/doc/examples/softwaresite/doc/setup.mdwn
@@ -0,0 +1,4 @@
+FooBar is configured via the config file `/etc/foobarrc`, and the per-user
+`~/.foobarrc`.
+
+The file format should be self-explanatory.
diff --git a/doc/examples/softwaresite/download.mdwn b/doc/examples/softwaresite/download.mdwn
new file mode 100644
index 000000000..799da3504
--- /dev/null
+++ b/doc/examples/softwaresite/download.mdwn
@@ -0,0 +1,5 @@
+FooBar tarballs can be downloaded from
+[here](http://foobar.example.com/download/).
+
+There's also a subversion repository, at
+`svn://foobar.example.com/foobar/trunk`.
diff --git a/doc/examples/softwaresite/index.mdwn b/doc/examples/softwaresite/index.mdwn
new file mode 100644
index 000000000..306084222
--- /dev/null
+++ b/doc/examples/softwaresite/index.mdwn
@@ -0,0 +1,7 @@
+FooBar is an amazing example program that does not exist. Use it for all
+your example program needs. This is its wiki.
+
+* [[download]]
+* [[news]]
+* [[documentation|doc]]
+* [[contact]]
diff --git a/doc/examples/softwaresite/news.mdwn b/doc/examples/softwaresite/news.mdwn
new file mode 100644
index 000000000..cdee4fa59
--- /dev/null
+++ b/doc/examples/softwaresite/news.mdwn
@@ -0,0 +1,5 @@
+This is where annoucements of new releases, features, and other news is
+posted. FooBar users are recommended to subscribe to this page's RSS
+feed.
+
+[[inline pages="*softwaresite/news/* and !*/Discussion" rootpage="news" show="30"]]
diff --git a/doc/examples/softwaresite/news/version_1.0.mdwn b/doc/examples/softwaresite/news/version_1.0.mdwn
new file mode 100644
index 000000000..83c805e6e
--- /dev/null
+++ b/doc/examples/softwaresite/news/version_1.0.mdwn
@@ -0,0 +1 @@
+Version 1.0 of foobar is released. [[Download]] it today!