Re: Best way to document console steps on a web page?
On 5/2/05, Peter Sebastian Masny <firstname.lastname@example.org> wrote:
> Hi all,
> I've documented several Debian installation processes and would like to
> publish them so other might benefit. I would like to format the steps
> as clearly and easily as possible. Common HOWTOs look like:
> % cd /tmp
> % wget www.someapp.org/theapp.tgz
> % tar -xzvf theapp.tgz
> % su
> # cd install
> # nano config
> GAPING_SECURITY_HOLE=false # this should be turned off
> # ./install
> I figure there is some wiki/docbook thingie out there that can do this.
> Features I would like:
> - console prompt support. This has two aspects:
> -- Copying text off of the web page selects only the code
It's nice and it uses subversion as a backend.
You can edit from $EDITOR or from the web based
If you edit from vim, there's a binary that converts
it to html so you can check your work. It's great for
> and not the prompt or comments
> -- Preformatting with appropriate prompts/colors
> <root>cd install</root>
svnwiki uses GNU enscript, so you can do that for
a lot of languages.
For instance, this code is in the svnwiki page:
chicken-setup srfi-40 sandbox &&
svn checkout http://svn.afc.no-ip.info/svn/home/src/chicken-eggs &&
for ext in stream-cgi stream-ext html-stream iconv stream-parser
stream-wiki content-type svn-client; do
cd $ext && chicken-setup $ext && cd .. ;
We just started a chicken scheme manual,
and we use enscritpt to show the code:
(lambda (x) (+ x 2))
> - search
The author will work on it, really soon.
> - looks nice
Right now it provides a default wiki you can start
from. It supports css.
This is how the default wiki looks like:
> - a table of contents
Yup. It's generated with [[toc:]]
The link is [[hello link]]
> - ability for others to add comments
Each page has a discussion page.
Check the discussion page
of this wiki page.
Quoting is easy. You just have to start the lines
> Any suggestions?
Yes. Install svnwiki :) I can help you if you get to
need assistance. I'm using it a lot.
Please check the wiki syntaxis.