source: branches/mbutscher/work/WikidPadHelp/data/WikiMaintenance.wiki @ 195

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

2.0preAlpha (internal)

Works so far, now editing help wiki.

File size: 4.0 KB
Line 
1++ Wiki Maintenance
2
3++ Rebuilding wiki
4
5In menu "Wiki"->"Maintenance"->"Rebuild Wiki".
6
7First you should know that a wiki in WikidPad contains some essential data (mainly the text of the wiki pages) and some cache data which is extracted from the essential data (list of children of a page, todos, attributes,...). Due to an error or some special operations (like adding or deleting page files from outside of WikidPad) it may happen that the cache information is deleted, invalid or not up-to-date anymore.
8
9Rebuilding deletes and recreates all cache information
10
11This feature can also be used to add large numbers of pages to the wiki.  Copy ".wiki" wikiword files into the data directory, then "Rebuild Wiki" to rebuild the database to include these files. This does not work for "Compact Sqlite" database type (see MigrationBetweenDbTypes for details).
12
13[alias: RebuildTheWiki]
14
15
16++ Update cache
17
18This rebuilds only pages for which cache is marked as dirty in the database. If you save a modified page it is initially marked dirty and WikidPad starts updating the cache in the background. If you want to be sure that the cache is up-to-date but do not see a need to rebuild the whole wiki, use this function.
19
20
21++ Initiate update
22
23Marks cache of all wiki pages in the database as dirty and starts updating it in the background (after performing some operations which should be done in the foreground in any case). Use this if you need a rebuild but don't want to wait until the rebuild is done.
24
25
26++ Show job count
27
28Gives a rough estimation of the number of jobs waiting in the background. The number may be inexact.
29
30
31++ Open as Type
32
33Allows to override the database type stored in wiki configuration file. Only needed in very rare cases.
34
35
36++ Reconnect
37
38In menu "Wiki"->"Maintenance"->"Reconnect".
39
40If during a WikidPad session the access to the wiki database files is lost (e.g. network connection drops), you might get an error. To make WikidPad work again after access is reestablished, use "Reconnect".
41
42Initially, WikidPad tries automatically to reconnect and asks if it should try to reconnect each time you try to open another page or try to save a page.
43
44Autosave is automatically disabled after an error until a successful reconnect.
45
46
47++ Optimise Database
48
49In menu "Wiki"->"Maintenance"->"Optimise Database". This function is only available if currently loaded wiki is of type "Original Sqlite" or "Compact Sqlite".
50
51If information is deleted from an Sqlite database, the occupied hard disk space is not freed but later reused for new information to add. "Optimise Database" makes this space available for the system again. After deleting large parts of a wiki, you can use "Optimise Database" to free space, especially recommended for a "Compact Sqlite" wiki (where the page content is also stored in the database).
52
53
54
55
56++ Other things about maintenance
57
58+++ Finding and connecting parentless nodes
59
60As you add and remove links from the various pages in your wiki database you may end up with unlinked, or parentless, nodes.  To view them use the "parentless-nodes" node in the "Views" subtree.
61
62Alternatively you can use menu "Navigate" -> "List Parentless Pages" or press Ctrl-Shift-Up
63
64You can then decide if you need to relink these nodes, or if you want to delete them.
65
66anchor: finding_undefined_links
67+++ Finding undefined wiki word links
68
69There may be also wiki word links to pages which do not exist, e. g. NonExisting. These are underlined and black in the editor. To list all such links, use the "undefined-nodes" node in the "Views" subtree. If you click on one of these links you go to an empty page for this word and can fill it with content.
70
71Sometimes words are unintentionally marked as wiki words. In this case you can either:
72
73    * Prefix the word with a backslash
74    * Add the attribute \[camelCaseWordsEnabled: false] on a page
75    * Enter the word into one of the blacklists, see WordLinking!exclude_from_linking.
76
77
78[icon: cog]
Note: See TracBrowser for help on using the repository browser.