The purpose for which this wiki had been created has not been an issue for a few years and only remains temporarily as an historical document.
When creating a new page for the Koha Large Document Wiki, please follow the new page creation note.
You are here: Koha Large Document Wiki.
Trace:
start.1254765568.txt.gz · Last modified: 2009/10/05 17:59 by thd
Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
start [2009/10/05 17:59] thd |
start [2013/06/05 11:35] (current) thd |
||
---|---|---|---|
Line 10: | Line 10: | ||
======Important New Page Creation Note.====== | ======Important New Page Creation Note.====== | ||
- | If creating a new page for this wiki, please first create a matching page at a matching location in the main Koha Developer Wiki. If you can wait until after mid-October before adding new pages, then you may avoid the need for the extra steps now specified as were are hoping corrections will be made to the main Koha Developer Wiki by that time. | + | Please do not create any pages in this wiki unless needed for readability where the main Koha Developer Wiki will not satisfy. |
+ | If creating a new page for this Koha Large Document Wiki, please first create a matching page at a matching location in the main Koha Developer Wiki. While some content might only appear in the Koha Large Document wiki for readability, there should be a symmetry of pages and namespaces between both wikis for any content created for the Koha Large Document Wiki. Only the content of the matching pages and namespaces would differ where between the two wikis. If you can wait until after the problematic issues are corrected on the main Koha Developer Wiki before adding new pages, then you may avoid the need for the extra steps now specified. | ||
- | =====Linking Within Each Wiki.===== | ||
- | In both the main Koha Developer Wiki page and this supplementary Koha Large Document Wiki, create a point of access to your new page in the namespace page above just above the link including the relative namespace path from that point. | + | =====Page and Namespace Creation, and Linking Within Each Wiki.===== |
- | <code>[[your_new_page|Title of Your New Page]]: | + | In both the main Koha Developer Wiki page and this supplementary Koha Large Document Wiki, create a point of access to your new page in the namespace page above just above the link including the relative namespace path from that point. |
+ | <code>[[your_new_page]] | ||
Brief summary of your new page.</code> | Brief summary of your new page.</code> | ||
- | Namespaces represent major content categories and appear in the wiki URLs separated by colons. New namespaces can be created by preceeding them with a colon in the creation link from the namespace above if you want to create your new page as a namespace. | + | Namespaces in the Koha Large Document Wiki should only have content relevant to documents included in this wiki or should otherwise link back to the main Koha Developer Wiki. [The Koha Large Document Wiki is a supplement to the main Koha Developer Wiki, not a fork.] |
- | + | ||
- | <code>[[:your_new_namespace_page|Title of Your New Page]]: | + | |
- | + | ||
- | Brief summary of your new page.</code> | + | |
- | + | ||
- | Any links from the top page should start with a language code namespace. | + | |
- | + | ||
- | <code>[[:en:whatever:the_path:is:to:your_new_page|Title of Your New Page]]: | + | |
- | + | ||
- | Brief summary of your new page.</code> | + | |
- | + | ||
- | Any links from intermediate namespace pages should include the namespaces for that intermediate namespace. | + | |
- | + | ||
- | <code>[[:whatever:the_intermediate:namespace:path:is:to:your_new_page|Title of Your New Page]]: | + | |
- | + | ||
- | Brief summary of your new page.</code> | + | |
+ | Please follow other guidance given in the [[http://wiki.koha.org/doku.php?id=en:wiki:namespace_tutorial|Koha Wiki Contributors' Namespace Tutorial]] in the Main Koha Developer Wiki. | ||
=====Title Headings.===== | =====Title Headings.===== | ||
- | On both the main Koha Developer Wiki page and the content holding page in this supplementary Koha Large Document Wiki, include an initial heading with the page. | + | On both the main Koha Developer Wiki page and the content holding page in this supplementary Koha Large Document Wiki, include an initial heading in the page before any other content. |
<code>======Title of Your New Page.======</code> | <code>======Title of Your New Page.======</code> | ||
Line 48: | Line 34: | ||
This title will appear instead of the wiki namespace for the page in wiki navigation links. | This title will appear instead of the wiki namespace for the page in wiki navigation links. | ||
- | Please include a brief sentence summarising the page content on both wikis if needed. | + | Please include a brief summary of the page content on both wikis if needed. |
Line 67: | Line 53: | ||
We do not want to fork the Koha Developer Wiki but merely supplement it. When problems for large document support in the Koha Developer Wiki have been corrected, all content from this wiki will be moved back to the main wiki and this wiki will be closed. We expect to move the page edit history back as well if we can manage. | We do not want to fork the Koha Developer Wiki but merely supplement it. When problems for large document support in the Koha Developer Wiki have been corrected, all content from this wiki will be moved back to the main wiki and this wiki will be closed. We expect to move the page edit history back as well if we can manage. | ||
+ | |||
+ | ======DokuWiki Syntax Information.====== | ||
+ | |||
+ | [[:wiki:syntax]] contains an explanetory summary of %%DokuWiki%% syntax generally. | ||
+ | |||
+ | * [[http://www.dokuwiki.org/pagename|Page Names]] describes %%DokuWiki%% pagenames and their syntax in detail. | ||
+ | |||
+ | * [[http://www.dokuwiki.org/namespaces|Namespace]] describes %%Dokuwiki%% namespaces and their syntax in detail. | ||
+ | |||
=====Wiki Syntax Hint.===== | =====Wiki Syntax Hint.===== | ||
Line 75: | Line 70: | ||
line 2</code> | line 2</code> | ||
- | See [[:wiki:syntax|DokuWiki syntax]] for more syntax information. | ||
======Temporary Need for this Supplemental Wiki.====== | ======Temporary Need for this Supplemental Wiki.====== | ||
Line 81: | Line 75: | ||
Problems with the default DokuWiki stylesheet currently used on the Koha Developer Wiki are most visible on large documents with complex content but almost every page is somewhat more difficult to read than it ought to be. | Problems with the default DokuWiki stylesheet currently used on the Koha Developer Wiki are most visible on large documents with complex content but almost every page is somewhat more difficult to read than it ought to be. | ||
- | The Koha Large Document Wiki uses the stylesheet from the Monobook template for DokuWiki adapted from the one used for MediaWiki popular for Wikipedia. The Monobook stylesheet may not be more aesthetically appealing than the default DokuWiki stylesheet if one is not attempting to actually read or edit the content but is certainly more aesthetically appealing when usability is a vital component of aesthetic apprehension. | + | The Koha Large Document Wiki uses the stylesheets based upon those from the Monobook template for DokuWiki adapted from the ones used for MediaWiki popular for Wikipedia. The stylesheets and some template code for the placement of page elements have been extensively modified by the administrator of this wiki to enhance their pre-existing good qualities and fix some bugs. |
+ | |||
+ | The Monobook stylesheet together with enhancements may not be more aesthetically appealing than the default DokuWiki stylesheet if one is not attempting to actually read or edit the content but is certainly more aesthetically appealing when usability is a vital component of aesthetic apprehension. |
start.1254765568.txt.gz · Last modified: 2009/10/05 17:59 by thd
Trace:
You are here: Koha Large Document Wiki.