Input

book: Create a structured PDF document with headings, chapters, etc.
webpage: Specifies that the HTML sources are unstructured (plain web pages.) A page break is inserted between each file or URL in the output.
continuous: Specifies that the HTML sources are unstructured (plain web pages.) No page breaks are inserted between each file or URL in the output.
Title of the document for the front page.
Extract the first heading of the document and use it as title. If checked the title field has no effect.
The title image or HTML page. These file has to be an attachments!
Specify document version to be displayed on the title page.
Intellectual property owner of this document.
Copyright notice for this document.
Information about who and when modified the document are applied at the end.

Output

Specifies the output format.
Grayscale document  Title page
Compression :   JPEG big images 

Pagina

 
User defined page size 
Choose one of the predefined standard sizes or select user defined.
Specifies the page size using a standard name or in points (no suffix or ##x##pt), inches (##x##in), centimeters (##x##cm), or millimeters (##x##mm).
Set the target browser width in pixels (400-1200). This determines the page scaling of images.
   2-Sided   Landscape
   
   
   
Specifies the margin size using points (no suffix or ##x##pt), inches (##x##in), centimeters (##x##cm), or millimeters (##x##mm). Keep empty for default value.
Left
Middle
Right
Sets the page header to use on body pages.
Left
Middle
Right
Sets the page footer to use on body pages.

Indice

Sets the number of levels in the table-of-contents. Empty for unlimited levels.
   Numbered headings Check to number all of the headings in the document.
Sets the title for the table-of-contents. Empty for default title.
Left
Middle
Right
Sets the page header to use on table-of-contents pages.
Left
Middle
Right
Sets the page footer to use on table-of-contents pages.

Colors

Enter the HTML color for the body (background).
Enter the image file for the body (background). These file has to be an attachments!
Enter the HTML color for the text.
Sets the color of links.
Enables generation of links in PDF files.

Fonts

Set the default size of text.
Set the spacing between lines of text.
Choose the default typeface (font) of text.
Choose the default typeface (font) of headings.
Set the size of header and footer text.
Choose the font for header and footer text.
Change the encoding of the text in document.
Check to embed font in the output file.

PDF

Controls the initial viewing mode for the document.
Document: Displays only the docuemnt pages.
Outline: Display the table-of-contents outline as well as the document pages.
Full-screen: Displays pages on the whole screen; this mode is used primarily for presentations.
Controls the initial layout of document pages on the screen.
Single: Displays a single page at a time.
One column: Displays a single column of pages at a time.
Two column left/right: Display two columns of pages at a time; the first page is displayed in the left or right column as selected.
Choose the initial page that will be shown.

Security

Check to number all of the headings in the document.
 Versione stampabile   Modify
 Copy   Annotate
Specifies the document permissions.
Specifies the user password to restrict viewing permissions on this PDF document. Empty for no encryption.
Specifies the owner password to control who can change document permissions etc. If this field is left blank, a random 32-character password is generated so that no one can change the document.

Expert

Specify language to use for date and time format.
Shrink code blocks on page.
Show line numbers for code blocks.
Make spaces visable by dots (·) instead of white spaces.
Make line breaks visable by a extra character (¶) at the end.
Enable this feature if you searching for problems or intent to report a bug report

About

Version 2.4.2 (MoinMoin 1.9.7)


MoinMoin - Generate PDF document using HTMLDOC

This action script generate PDF documents from a Wiki site using
the HTMLDOC (http://www.htmldoc.org) software packages which has
to be preinstalled first.

Copy this script in your's MoinMoin action script plugin directory.

Thanks goes to Pascal Bauermeister who initiated the implementaion.
Lot of things changes since then but the idear using HTMLDOC is the
main concept of this implementation.

Please visit the homepage for further informations:
http://moinmo.in/ActionMarket/PdfAction

@copyright: (C) 2006 Pascal Bauermeister
@copyright: (C) 2006-2010 Raphael Bossek <raphael.bossek@solutions4linux.de>
@license: GNU GPL, see COPYING for details

       

Italiano English
Locked History Actions

HelpMiscellaneous

Other MoinMoin help topics

Subtopics

Contents

Lost password for a user

If you have mail configured for your MoinMoin wiki (see HelpOnConfiguration) then users can have their password sent to the email address in their Preferences. If SMTP is not configured, then the "Mail me my password" button is not shown on UserPreferences, and subscribed pages cannot be sent to users.

Adding a favicon to your wiki setup

You may want to add a custom icon to your wiki site, commonly known as favicon.ico. Favicons usually appear beside bookmarks and with tabbed browsing. To change the default favicon for your wiki, add this to your wikiconfig.py:

html_head = '''
<link rel="shortcut icon" href="/moin_static160/favicon.ico">
<!-- ... more header stuff ... -->
'''

The image size must be 16x16.

Apache tricks

Securing access to a wiki via Apache means

See PasswordProtectedEditing

Serving the wiki from a domain root

httpd.conf modification for MoinMoin installation at "/":

# global section:
LoadModule rewrite_module /usr/lib/apache/1.3/mod_rewrite.so
# virtualhost section:
RewriteEngine on
RewriteRule ^/moin_static160/ -  [last]
RewriteRule ^/robots.txt  -      [last]
RewriteRule ^/favicon.ico -      [last]
RewriteRule ^/?(.*) /file/path/to/moin.cgi/$1  [last,type=application/x-httpd-cgi]

This way you can use short and clean URLs like http://LinuxWiki.de/FrontPage.

Note:

  • /pathto/cgi-bin/.. is absolute file path, not a URL path.
  • Make sure the file path to moin.cgi has ExecCGI privileges in your httpd.conf.

  • There is no need for a ScriptAlias to moin.cgi, but you still need the alias to MoinMoin's htdocs folder: Alias /moin_static160/ "/usr/share/moin/htdocs/"

Redirect /mywiki/MyWiki to the user's language FrontPage

Perhaps you want to use MyWiki in your wiki to refer to your wiki. If a user clicks this link they should be transferred to the FrontPage, that is to the FrontPage of her/his language.

Add this to your httpd.conf before the ScriptAlias:

RedirectPermanent /mywiki/MyWiki    http://www.domain.org/mywiki?action=show

Serving the wiki from wiki.domain.com and home page from www.domain.com

Here is a configuration for virtual hosting with special permissions on Gentoo Linux. The following configuration is for Apache2 config files. Just put it all in httpd.conf for Apache 1.

Add this to /etc/apache2/conf/vhosts/vhosts.conf

NameVirtualHost *
<VirtualHost *>
   ServerName www.domain.org
   ServerAlias domain.org
   DocumentRoot /var/www/domain.org/htdocs
</VirtualHost>
 
<VirtualHost *>
   ServerName wiki.domain.org
   Alias /moin_static160/ "/usr/share/moin/htdocs/"
   Alias /favicon.ico "/var/www/htdocs/favicon.ico"
   ScriptAlias / "/usr/share/moin/mywiki/moin.cgi/"
</VirtualHost>

Add this to /etc/apache2/conf/commonapache2.conf

<Directory /usr/share/moin/htdocs/>
   Order deny,allow
   Allow from all
</Directory>

<Directory /usr/share/moin/domain.org/>
   Order deny,allow
   Allow from all
</Directory>

Special features for wiki farms and intranets

The following shows how certain features can help you to optimize your configuration when you run several wikis on one host, or when you use MoinMoin in intranet environments.

Centralized settings

  • farmconfig.py
  • shared intermap.txt
  • shared code base and icons

Remapping URLs

The configuration variable "url_mappings" can be used to remap URLs, for example to change certain URL prefixes to totally different ones. This is especially useful in intranets, when whole trees of documents hosted outside of the wiki move around. It does not apply to most intra-wiki links as those are relative and are not remapped.

"url_mappings" is a lookup table in the form of a dict, the key is the prefix to be replaced, the value is the replacement.

You could also use "url_mappings" to include a dereferer-script for external links, like this:

url_mappings = {
    'http://my-wiki/': 'http://my-wiki/',
    'http://': '/cgi-bin/derefer.cgi?url=http://'
  }

The reason you might want to use this is to avoid google spamming in your wiki (although this is unlikely to be noticed and would only counter the link spamming if done large-scale) or to keep your wikipages secret. Note that your own wiki needs to be included explicitly because URLs that might be generated automatically (for example for email notifications) would otherwise be remapped to your referrer script as well.

Please notice: If you want to redirect a single page to another, just type #REDIRECT and the name of the page to direct to in the first line of your page. See HelpOnProcessingInstructions.

TODO

<!> TODO: explain the following things in detail, and add more detail to the above sections

Needing more explanation:

  • event logging
  • Page trails (user option)
  • UserPreferences: checkboxes for double-click edit, page trail, fancy links, emoticons, jump to last page visited, and some other yes/no options

  • "Remove trailing whitespace from each line" option in the editor
  • Page templates (create a new page using a template page)
  • Only "normal" URLs (outside of brackets) are converted to inline images ==> document exact rules

  • Highlighting of search results, and of bad words when spellchecking
  • Support for "file:" URLS

  • email notification features
  • "RSS" icon displayed by RecentChanges macro

  • commentary field of editor, recent changes and page info
  • Page caching, for now limited to XSLT processing (where it's absolutely needed); new code & API to add the "DeleteCache" link

  • inline search fields (at the bottom of each page)
  • the interwiki name "Self" now always points to the own wiki
  • page info action

Admin stuff:

  • describe "moin.cgi?action=test" tool in more detail
  • WikiFarm support:

    • <datadir>/plugin/macro and <datadir>/plugin/action can be used to store macros and actions local to a specific wiki instance

    • config.shared_intermap can contain a pathname to a shared "intermap.txt" file (i.e. one stored outside the datadir)
  • $PAGE placeholder in interwiki map

Compatibility:

  • RSS features require a recent PyXML (CVS or 0.7) due to bugs in the namespace handling of xml.sax.saxutils in earlier versions. This is (hopefully) automatically detected on every installation.