Difference between revisions of "Help:Export"

From SoftMC-Wiki
Jump to: navigation, search
(added PDF and Template:noexport)
Line 55: Line 55:
 
: Example, in which a page in the Category:Help is referenced:
 
: Example, in which a page in the Category:Help is referenced:
 
: <pre>file:///<path>/index.html?title=Help:Editing pages</pre>
 
: <pre>file:///<path>/index.html?title=Help:Editing pages</pre>
 +
 +
== PDF ==
 +
The well-known format...
 +
 +
= Content Exclusion =
 +
The template [[Template:noexport|<nowiki>{{</nowiki>noexport}}]] can be used to exclude content from being exported within pages.
  
 
= Indexing =
 
= Indexing =

Revision as of 10:36, 22 July 2012

The export functionality allows to extract parts of Manz-Wiki as off-line documentation. It is possible to export single pages or whole category structures, including subcategories.

Only users which are in the EXPORT user group are allowed to export pages.

Usage

Export can be started with the Export link in the navigation sidebar.

  • To export a single wiki page, navigate to it and press Export.
  • For category export, navigate to the category and press then Export.

Own password has to be retyped for security reasons.

The export process will start after pressing the Export button. Depending on the page number, the process can take a long time.

Options

Default page
If a category is exported, with this option it is possible to select the default (home) page.
Include subcategories
If set, all sub-categories will also be exported (recursively).
This option is only available, if a category is exported.
Include linked files
If set, links to the File namespace (e.g. all referenced files) will also be included.
Export format
Select one of the available export formats.

Export formats

CHM

Microsoft help file format (extension .chm) is very easy to handle, because it combines all exported pages into one file. Further advantages of this format are:

  • Integrated full-text search
  • Index overview in the sidebar

This format is recommended as off-line documentation, which will be used directly by humans on windows systems.

IMPORTANT.svgIMPORTANT

When the newly exported .CHM file is opened for the first time, the windows system displays a security warning.
The confirm box has to be unchecked! Otherwise the exported pages won't be shown in the viewer.

HTML

In this format a .html file is generated for every exported page. Additionally the file index.html is created, which suits as an entry point for the exported documentation. These files are delivered all together in a single ZIP archive.

This format is suitable for off-line documentation, which will be integrated into other software systems.

Index.html API

When the index.html file is opened directly (without any parameters), it redirects to the default page.

Parameters can be given to the index.html file in the following way:

file:///<path>/index.html?param1=value1&param2=value2&...

The supported parameters are:

title
Index of the page, to which the redirect will go.
Example, in which a page in the Category:Help is referenced:
file:///<path>/index.html?title=Help:Editing pages

PDF

The well-known format...

Content Exclusion

The template {{noexport}} can be used to exclude content from being exported within pages.

Indexing

For every page, an index entry is created from the page name (displaytitle).

Logging

Every page export is logged to Special:log!