✎ Koha Large Document Wiki. - Koha Large Document Wiki

Views

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.1254765719.txt.gz · Last modified: 2009/10/05 18:01 by thd

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

======Koha Large Document Wiki.======

**A supplement to the main [[http://wiki.koha.org|Koha Developer Wiki]].**
\\

======Purpose.======

This wiki is intended exclusively as a temporary supplement to the main Koha Developer Wiki at http://wiki.koha.org .  The temporary period was intended to only be a few months in 2006 allowing time to evaluate implementing changes to correct for default DokuWiki stylesheet bugs hindering the readabiblity of some content and navigation limitations hindering the finding of content.  Lack of attention from the administrator of the main Koha Developer Wiki has left the issue not receiving consideration.

======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 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.

<code>[[your_new_page|Title of Your New Page]]:

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.  

<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>


=====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.

<code>======Title of Your New Page.======</code>

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.


=====Linking from the Main Koha Developer Wiki.=====

On the main Koha Developer Wiki page, include a link to the new page on this wiki where the content will be held.

<code>Content temporarily moved to

http://kohaldwiki.agogme.com/duku.php?id=en:whatever:the_path:is:to:your_new_page

for large document support.</code>

=====Careful Matching Between the Wikis.=====

Be certain that all the needed namespace pages spearated by colons in the URL are present in both wikis or create them so the locations in the URL after ?id= are identical for the page in both wikis.

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.  
 

=====Wiki Syntax Hint.=====

If line breaks do not occur as expected in text content, they may be forced with the following DokuWiki syntax.

<code>line 1\\
line 2</code>

See [[:wiki:syntax|DokuWiki syntax]] for more syntax information.

======Temporary Need for this Supplemental Wiki.======

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.

start.1254765719.txt.gz · Last modified: 2009/10/05 18:01 by thd

Trace:

You are here: Koha Large Document Wiki.

Views

Search

Navigation

Personal Tools

Toolbox

General Copyright.

Designated Content Licenses.

Non-Designated Content Licenses.

No Warranty.