source: branches/mbutscher/next/WikidPadHelp/data/Options HTML preview_export.wiki @ 178

Last change on this file since 178 was 178, checked in by mbutscher, 11 years ago

2.0preAlpha (internal)

Works so far, now editing help wiki.

File size: 4.9 KB
Line 
1++ Options for HTML preview/export
2
3*Start browser after export*
4Starts the current web browser after exporting one or more HTML pages or an XML document.
5
6*Font name for HTML preview*
7Enter the desired font name for the HTML preview. Clicking on the "..." button shows a list of available fonts.
8
9*Attrs. to (not) include in preview*
10Enter here a regular expression of the properties you want to allow to be shown in the HTML preview. The RE is tested against a "normalized" property where the brackets are removed and key and value are separated by ": ". So even if the property is in the page written as "\[camelCaseWordsEnabled=false]", the RE is tested against "camelCaseWordsEnabled: false".
11
12If you e.g. want to show the "alias" properties only, enter "alias: .* ". Other properties will then be hidden in the preview. The empty text field matches everything.
13
14If you want to show all properties *except* those matching the RE, tick the checkbox to the left of the "not".
15
16If you press the "Ok" button of the options dialog, but the dialog doesn't vanish, instead this text field is red, then the RE contains an error and must be corrected first.
17
18*Attrs. to (not) include in export*
19Same as above, but for the HTML export.
20
21*Shows pics as links in preview*
22If this option is checked, links to image URLs (those ending with .png, .gif or .jpg) are shown like other links in the preview. If it is unchecked, the images (if available) are shown.
23
24*Shows pics as links in export*
25Same for HTML export.
26In the export dialog, you can temporarily override this setting for one export.
27
28*Preview renderer*
29Under Windows you can choose the renderer for the HTML preview:
30
31    * Internal: Internal standard renderer. Not very capable, but it
32      doesn't need external components
33    * IE: Uses Internet Explorer.
34    * Mozilla: Uses Mozilla/Gecko rendering component if installed.
35      You can download it here:
36      http://www.iol.ie/~locka/mozilla/control.htm. *There seems to be
37      a severe bug that crashes WikidPad when pressing any key while
38      the Mozilla preview is shown!*
39
40Changes of this setting only have an effect for newly opened WikidPad windows.
41
42Mozilla and IE renderer can use CSS-files for preview, see [Cascading style sheets].
43
44    *Important remarks*
45    * Using IE or Mozilla as renderers means that any weaknesses of
46      these browsers (esp. regarding security) become part of
47      WikidPad. If e.g. a wiki page contains dangerous scripts in
48      JavaScript they might be executed when showing the page.
49    * If you chose Mozilla and the component is not installed,
50      WikidPad will crash when opening a new window (or when
51      restarting WikidPad). If this happens, try to start WikidPad
52      again. It should then use the internal renderer instead.
53
54
55*Table of contents*
56Choose if you want a table of contents in tree form, list form or not at all, see WikiExport#*Additional# options*
57In the export dialog, you can temporarily override this setting for one export.
58
59*Title of toc*
60Set the title of the table of contents according to your language. The default is "Table of Contents". For German it could be e.g. "Inhaltsverzeichnis".
61
62*Single page separator lines*
63Set the number of separator lines to separate wiki pages in a single HTML page on export.
64
65
66
67+++ HTML header settings
68
69++++ Attributes of "<body>"-tag
70The following settings for HTML export/preview can all be overridden by attributes for a particular wiki and for a particular page. These settings (either in options dialog or as attributes) only have an effect when exporting a set of HTML pages, not when exporting a single page containing multiple wiki words. For HTML preview only some of the settings have an effect at all.
71
72
73*Link color*
74Specify the color of a link in preview/HTML export by pressing the little "..." button to start the color dialog or by entering a numeric HTML color (e.g. "#000000" for black) in the text field. Leaving the field empty chooses the default color.
75
76The attribute to override this for a single page is "html.linkcolor". To set it for a whole wiki, use "global.html.linkcolor". Both attributes take a numeric HTML color as value.
77
78
79*Active link color*
80Color of a link while hovering over it with the mouse or while mouse is pressed (depends on browser). Doesn't work for preview. Attribute to override: "html.alinkcolor".
81
82*Visited link color*
83Color of an already visited link. Doesn't work for preview. Attribute to override: "html.vlinkcolor".
84
85*Text color*
86Color of normal text. Attribute to override: "html.textcolor".
87
88*Background color*
89Color of background. Attribute to override: "html.bgcolor".
90
91*Background image*
92Link (URL) to a background image. Doesn't work for preview. Attribute to override: "html.bgimage".
93
94
95
96++++ DOCTYPE
97Sets the DOCTYPE to use in the header of an HTML file. You should only modify it if you understand what it is doing.
Note: See TracBrowser for help on using the repository browser.