Visit our Popular Forums

rgleason · 18-10-2016, 17:45

Because the upgrade path from Drupal 6 to Drupal 7 or 8 is unclear, particularly with respect to necessary plugins and actually moving the documentation. Also since Drupal depends on a CMS database which is difficult to work with, Dave determined that we need a 'flat" wiki for the Manuals. I believe that is why he suggested I try Dokuwiki. Well this is as far as I've gotten so far. The menu structure is almost identical, and can be improved quite readily now that I've learned how it is done.

The method for importing pages and images will need some work and can possibly be improved.

However this should give people some idea of how the Manual would work. Note: only some pages have been imported.

At some point we will need help transferring over by editors at some point, if this is going to be used.
Please let us know what you think.

TOOLBAR Buttons [Opencpn Wiki]

Hakan · 19-10-2016, 00:53

If I understand it correct the change of wiki environment is driven by a hope for an easier method to create and edit the manual. If so I don't have any particular comments since I didn't worked much with the existing one more than it was a rather prolix affair to ad or edit images in the old one, wasn't it. Rick, you must able to judge it since you've done a lot for the existing one.

One of the most important features for a wiki is a reasonable result when using the search function. I did some small tests on the one you've linked to and found it rather good. Every word seems indexed, paragraphs with lot of hits was accordingly sorted and headings connected to the search phrase was emphasized.

Headings in the side bar seems sorted after implementation order? It may be a good idea to check for other possibilities, like user manuals in the upper part and development wikis further down?
Håkan

CarCode · 19-10-2016, 00:57

Believe it or not: There exists people which does not understand english.
So these documents are useless for such people.

Gerhard

bcn · 19-10-2016, 01:07

And therefore some users made an effort to translate and to create extensive support web sites in French or Dutch.

But what else do you want to state?? That cleaning up the Wiki is useless if not translated in 55 languages?

CarCode · 19-10-2016, 02:20

Quote:

Originally Posted by bcn

And therefore some users made an effort to translate and to create extensive support web sites in French or Dutch.

But what else do you want to state?? That cleaning up the Wiki is useless if not translated in 55 languages?

Perhaps you are new to computers. The best software is intuitive and therefore does not need any manual or docu. OpenCPN is just the opposite.

Gerhard

Hakan · 19-10-2016, 03:37

Gerhard
It may be you're not so new to handle code that you cannot contribute to shape the code to self a explained program? I think you're welcome to remake the user interface.

All - BTW - Would it be feasible to handle the new wiki text in Crowdin, is DokuWiki prepared for that in any way?

Håkan

rgleason · 19-10-2016, 06:12

Guys
You're thoughts and feedback are welcome. This is an investigation of possibilities right now, which I hope will develop into a move to a useful wiki!

If you look at dokuwiki documentation here https://www.dokuwiki.org/dokuwiki#
and here under features https://www.dokuwiki.org/features
Support for over 50 languages I have not enabled that yet.

Its going to take some help to get the text, images and links all transferred. I have set up an authorized signup for Editors... but it's not yet ready for prime time as I need some guys to try it and try transferring the pages to be sure we have a good process.

Also when we get it all working and transferred over, if this is the what we are doing, the wiki will need to be transfered over to opencpn.org website.

Gilletarom · 20-10-2016, 10:47

Hello Gerhard,

Quote:

Originally Posted by CarCode

Believe it or not: There exists people which does not understand english.
So these documents are useless for such people.
Gerhard

When you cease to be negative ....

Best regards, Gilletarom.

Gilletarom · 20-10-2016, 10:49

Hello Rick,

Quote:

Originally Posted by CarCode

Believe it or not: There exists people which does not understand english.
So these documents are useless for such people.

Gerhard

For cons, about the remark Gerhard about the English language, it lacks in the manual or on the website, a page in every language possible, explaining to readers how to use the automatic google translator to translate the manual pages a by one.

rgleason · 20-10-2016, 15:27

Gillletarom and Gerhardt,
I will try to install the International plugin and see what happens. It may take several days to get to it.
I think the translation would be supplemental to the native language website.
In fact, there is good additional information on all these websites.

rgleason · 20-10-2016, 15:44

Hakan:

Quote:

One of the most important features for a wiki is a reasonable result when using the search function. I did some small tests on the one you've linked to and found it rather good. Every word seems indexed, paragraphs with lot of hits was accordingly sorted and headings connected to the search phrase was emphasized.

Headings in the side bar seems sorted after implementation order? It may be a good idea to check for other possibilities, like user manuals in the upper part and development wikis further down?
Håkan

Thanks, I was just trying to get menus organized and pages in place, learning the program. Good news that it searches well!

On the left Menu outline I could index it differently so User Manuals are at the top.

rgleason · 21-10-2016, 08:51

There is one small problem with the left nav index. We include some sort index code with a number to get the pages in the correct order for a book with chapters, which works, however when a chapter has other sub pages below, it moves up to the top and gets an expansion + and is ordered with all pages that have sub-pages. I have not yet figured out how to change this behavior. Tried for a long time, so now I am just leaving it until we find a solution.

Things to do next:
1. Get international working even if Gerhardt promoses not to use it.
2. Get registration setup for Users (all users are editor). I am going to assign admins status to several strong editors, so that registrations are vetted!
3. Get the Index in the right corner working.
4. Do a trial export of html chkedit for off line documentation.
5.Try to figure out the easiest and best structure for images. Should all images for a given book be saved in a subdirectory by that book name? With no further breakdown? If dokuwiki can handle this structure, that is how I'd like to do it. Please provide insight and thoughts here! I find user image directories more difficult, but sometimes it helps with sort and finding.
6. Also we need to develop the easiest way to move the documents over. I can copy and paste, but images have to be downloaded and uploaded for each page and the all the links have to be fixed.
Right now I and missing a search and replace function in dokuwiki which would really help.
8. Once we have the technique down, we need to write and Editor Step by Step for transfer of pages.
9. Then we need to get to work and can use all the skilled help available.
10. Right now I need 2 volunteers who can help figure out and develop the best process for tranferring Books and pages into the new structure. Is anyone interested?

rgleason · 21-10-2016, 12:39

For those who would like to understand how Dokuwiki Books / Pages work, there is a thread which explains what was needed to get the Opencpn Dokuwiki to its present state: Migrating from Drupal 6 to Dokuwiki
https://forum.dokuwiki.org/thread/14060,2;nocount

Export books
https://forum.dokuwiki.org/post/53969

Customize Sidebar - Namespace sorting issues
https://forum.dokuwiki.org/thread/14085
There are a few other threads that will explain other aspects