From 82ab2ebb086d3a4e454a0b395a0495bc94bf80c6 Mon Sep 17 00:00:00 2001 From: joey Date: Wed, 22 Nov 2006 14:59:26 +0000 Subject: [PATCH] * Add softwaresite example. --- debian/changelog | 3 +- doc/examples.mdwn | 2 + doc/examples/softwaresite.mdwn | 13 ++++++ doc/examples/softwaresite/contact.mdwn | 7 +++ doc/examples/softwaresite/doc.mdwn | 5 +++ doc/examples/softwaresite/doc/.ikiwiki/index | 43 +++++++++++++++++++ .../softwaresite/doc/.ikiwiki/lockfile | 0 doc/examples/softwaresite/doc/Makefile | 9 ++++ doc/examples/softwaresite/doc/faq.mdwn | 11 +++++ doc/examples/softwaresite/doc/install.mdwn | 10 +++++ doc/examples/softwaresite/doc/setup.mdwn | 4 ++ doc/examples/softwaresite/download.mdwn | 5 +++ doc/examples/softwaresite/index.mdwn | 7 +++ doc/examples/softwaresite/news.mdwn | 5 +++ .../softwaresite/news/version_1.0.mdwn | 1 + 15 files changed, 124 insertions(+), 1 deletion(-) create mode 100644 doc/examples/softwaresite.mdwn create mode 100644 doc/examples/softwaresite/contact.mdwn create mode 100644 doc/examples/softwaresite/doc.mdwn create mode 100644 doc/examples/softwaresite/doc/.ikiwiki/index create mode 100644 doc/examples/softwaresite/doc/.ikiwiki/lockfile create mode 100644 doc/examples/softwaresite/doc/Makefile create mode 100644 doc/examples/softwaresite/doc/faq.mdwn create mode 100644 doc/examples/softwaresite/doc/install.mdwn create mode 100644 doc/examples/softwaresite/doc/setup.mdwn create mode 100644 doc/examples/softwaresite/download.mdwn create mode 100644 doc/examples/softwaresite/index.mdwn create mode 100644 doc/examples/softwaresite/news.mdwn create mode 100644 doc/examples/softwaresite/news/version_1.0.mdwn diff --git a/debian/changelog b/debian/changelog index 7d609b254..900e62de4 100644 --- a/debian/changelog +++ b/debian/changelog @@ -43,8 +43,9 @@ ikiwiki (1.34) UNRELEASED; urgency=low * Change rcs_commit, it is now passed the name of the user doing the commit and their IP address, and needs to construct its own commit message containing them, or do something more appropriate for the given RCS. + * Add softwaresite example. - -- Joey Hess Wed, 22 Nov 2006 09:08:37 -0500 + -- Joey Hess Wed, 22 Nov 2006 09:59:12 -0500 ikiwiki (1.33) unstable; urgency=low 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 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! -- 2.26.2