welcome: please sign in

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 

Page

 
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.

Contents

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.
 Print   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.9)


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

       

location: HelpOnActions / AttachFile

Disabling the AttachFile action

The AttachFile action lets a page have multiple attached files.

Since file uploads could be abused for DoS (Denial of Service) attacks, AttachFile is an action that can be disabled by the wiki administrator. See Configuration of MoinMoin for details.

Creating attachments

To create a new attachment, you can either add an attachment link to any page (see below on how to do that), or click on the AttachFile link at the bottom of the page. In the first case, you will see an Upload new attachment link after saving the page. Clicking on it will lead you to the upload page, just like directly clicking on the AttachFile link.

The upload form consist of two fields. In addition to the file input there is an optional field (Rename to), used to give the file a different name than on your own computer.

Existing attachments may be viewed, downloaded, or removed, depending on the configuration of the wiki and the access rights of the user. For example, an attachment cannot be deleted if the user doesn't have the delete permission on the particular page.

Any upload or deletion of attachments is reflected on RecentChanges and thus subject to peer review. Unlike page changes, there is no history though, so keep a local copy of files so you can revert possible vandalism.

Listing and information about attachments

Two macros are defined which give information about attachments on a page. The <<AttachInfo>> macro gives a short sentence about any attachments:

There are 9 attachment(s) stored for this page.

The <<AttachList>> macro lists files attached to a page:

  • [get | view] (2010-06-29 09:55:46, 7.4 KB) [[attachment:move_example1.png]]
  • [get | view] (2010-06-29 09:55:46, 4.8 KB) [[attachment:move_example2.png]]
  • [get | view] (2010-06-29 09:55:46, 3.7 KB) [[attachment:unzip1.png]]
  • [get | view] (2010-06-29 09:55:46, 6.6 KB) [[attachment:unzip2.png]]
  • [get | view] (2010-06-29 09:55:46, 3.1 KB) [[attachment:unzip3a.png]]
  • [get | view] (2010-06-29 09:55:46, 13.4 KB) [[attachment:unzip3b.png]]
  • [get | view] (2010-06-29 09:55:46, 5.5 KB) [[attachment:unzip5.png]]
  • [get | view] (2010-06-29 09:55:46, 4.0 KB) [[attachment:unzip6.png]]
  • [get | view] (2010-06-29 09:55:46, 3.2 KB) [[attachment:unzip7.png]]
 All files | Selected Files: delete move to page copy to page

It has two optional parameters:

Linking to attachments

To refer to attachments on a page, use [[attachment:a file with blanks.txt]].

Do not use the URL of the [get] link you can see on the attachments upload page, since these links are subject to change and can break easily on reconfiguration of the wiki. To refer to files attached to other pages, use [[attachment:WikiName/filename.ext]].

Embedding of attachments

If you like to transclude/inline/embed the target, use the {{attachment:image.png}} syntax. When using transclusion, some target file types might get pretty rendering (e.g. syntax highlighting), depending on the support moin has for that mimetype.

Editing vector drawings

An embedding looking like {{drawing:picturename}} will allow you to interactively edit vector diagrams via the built-in Java applet. The applet will then store three attachments, "picturename.draw", "picturename.png" and "picturename.map". After you first saved a drawing, the generated PNG picture is displayed for the {{drawing:picturename}} markup. The MAP is used to activate parts of the image as links. This means that you only need Java enabled for editing, while displaying the results works with any browser.

To edit a drawing after the first save, click on AttachFile and use the [edit] link that is displayed instead of [view] for the .draw attachment. You can also click on the invisible 5 pixel border around the picture to reach the edit mode. Saving a drawing is reflected in RecentChanges.

For details on using the drawing applet, see Plugins/TWikiDrawPlugin.

Installing packages

See HelpOnPackageInstaller.

Unzipping files

To get access to the unzip feature you need the following rights on the page:

e.g.

#acl UserName:admin,read,write,delete All:read

We implemented some protection for the server against abuse of this feature. Zip files in a Zip file are dropped by unzipping them. By definition of the configuration option unzip_attachments_space, only this total amount of bytes can be used to unzip files. If there are already files in the directory, the amount of them are subtracted from this number. The size of a single file in the archive which will be extracted can be limited using the configuration option unzip_single_file_size. By unzip_attachments_count you could restrict the number of files which are extracted from the zip file.

The rules for unzipping are implemented in the same way as for uploading one file. It is not allowed to overwrite an existing file by unzipping a file.

By unzipping a zip file only files from the first layer are unzipped. Files in directories are ignored.

A valid zip file could be created this way:

zip example.zip *.jpg

Uploading a zip file

After you have uploaded a zip file, you can see the unzip link.

No rights to unzip

If you have not enough rights, you only see the usual dialogue.

Not enough free space free

If the resulting unpacked files exceed the limit of filespace for attachments, you get this warning.

Successfully unzipped

unzip3a.png
unzip3b.png

Extracted files would be too large

If a file in the archive exceeds the defined unzip_single_file_size then it is not unzipped.

move a file

A "move" action link will be shown for each attachment file if you have "delete" rights on the wiki page it is attached to.

move_example1.png

Just click on "move" to get to this dialogue:

move_example2.png

Now you can either just rename the file (keeping it attached to the current page) or move the file to a different page (and even rename it, if you like). You need "write" rights on the target page (and the target page must be an already existing page).