wiki:FreeDocPlugin

Wiki pages FreeBSD handbook style

Description

This page offers a series of tweaks and tricks to have your wiki pages look like the FreeBSD handbook and articles.

Key features:

  • Man page linking
  • Syntaxing of files and code snippets
  • Information and Warning fields

For example, suppose the following markup is added to your wiki page:

Example(1)

To link to a certain man page use syntax like sshd(8) or nc(1)

 1. After every colon at the end of the line there will be an automagic return:
   example# have your commands detected and formatted in pre
   of course you could also use the non-root variant:
   example$ echo "{{{ preserve command syntax till end of line }}}";
 1. Use a somehow more simple *bold* tag
  Note: Will alert your readers to be careful by a drawing the attention using a grey box
 1. Linking to file:README or dir:/usr/local/etc will automatically syntax it.

Important: Will draw a big fat warning alerting your users of total disaster 

This will be displayed as follows with this plugin:

Rendered example output

Bugs/Feature Requests

Existing bugs and feature requests for FreeDocPlugin are here.

If you have any issues, create a new ticket.

enhancement

0 / 1

Download

Download the zipped source from here.

Source

You can check out FreeDocPlugin from here using Subversion, or browse the source with Trac.

Installation

  1. Download from here and unzip it.
  2. Build like a general egg, for Trac version 0.11 use:
    $ cd freedocplugin/0.11
    $ python setup.py bdist_egg
    
  3. Copy the egg in your plugins by either uploading it using the admin panel. Or copy it on the command line.
  4. Enable this plugin in your trac.ini file as follows:
    [components]
    freedoc.* = enabled
    
  5. Restart/reload your webserver if running mod_python, mod_fsgi or something similar.

Recent Changes

17022 by rickvanderzwet on 2018-01-17 20:14:19
Margin of list had wrong offset
15351 by rickvanderzwet on 2016-02-21 18:55:19
Support of csh style user prompts.
15264 by rjollos on 2016-02-11 04:22:34
Remove unnecessary svn:mime-type on py files

svn:mime-type was set to "plain" for many files.

(more)

Author/Contributors

Author: rickvanderzwet
Maintainer: RIck van der Zwet
Contributors:

Last modified 8 years ago Last modified on Dec 12, 2016, 9:10:26 PM

Attachments (1)

Download all attachments as: .zip