Opencpn Dokuwiki Migration -MOB- Help Needed!!! MOB

[fgd3]

I see the Help page was a better choice for me than the Man Overboard page.

I hope not creating more work for you than I'm contributing.

Fabbian

[rgleason]

I don't have a "source" button on the manual page. Look at these screenshots.

Shouldn't I be able to paste the raw HTML source into the DW Edit window and go from there? It doesn't seem to work, but I can't figure out why.

Darn, sorry I forgot about that. There are two modes "Rich Text Editor" and Plain Text Editor" You need to go to the bottom of the edit area and hit " Switch to Rich Text Editor"

I forgot about that detail! See Fabbian, Druple CKG Edit is just as complicated. Two modes!

Also the Source button at the top left of the rich text editor does the same thing, if you have it showing to click on.

[rgleason]

I've noticed that sometimes the translators html to doku and visa versa, get some little things scrambled, like image ahead of part of a title, and mislabeling titles with something different, like bold. This may also be due to bad formatting in the original document too!

Actually I think it is the original document formatting.
Also one of the pros on the forum, says Chrome does better cut and paste (closer to the actual formating of the orginal document) using the CKG Editor.
so I might try it.

[fgd3]

Originally Posted by rgleason

Fabbian,
For the sort order code which goes at the very top above the title, use
{{indexmenu_n>10}}

the 2 braces are ended by 2 braces. You were using square brackets which is for Internal and External Links and you used that successfully down at the bottom.

No, I used braces. If you saw square brackets it's because dokuwiki changed them.

Originally Posted by rgleason

Just one suggestion, for checking pathnames. If you go to the page you want and look at the url you will see the path which needs to be used.

Although it seems like an easy solution, it makes the manual non-portable. All references to other parts of the manual should be relative references, not absolute ones.

Originally Posted by rgleason

The red link indicates that that page has not been created, and if you click on it you will be prompted do you want to create this page, and you will need to enter content and save, but it will save to the wrong location, because the path is not correct if it turns red.

Good to know.

Originally Posted by rgleason

So ship tracks path is

http://tgp-architects.com/dokuwiki/doku.php?id=opencpn:opencpn_user_manual:toolbar_buttons:ship_track

If you use

{{:opencpn:opencpn_user_manual:toolbar_buttons:ship_track|Ship Track ]]

It will work.

Two comments.
(1) The first form is an absolute reference. If you later move the manual you'll have to revise all those absolute references. The second form is, I believe, a relative reference that will be preserved so long as the directory structure remains unchanged. There's a way to make URLs relative, but I've forgotten it.

(2) Those braces in the second code snippet should be square brackets, shouldn't they?

Fabbian

[rgleason]

Yes sometimes I feel like I am drowning too, particularly starting this up learning the dokuwiki and configuring with no experience. They've been very helpful though on the forum.

Just got the Right Click page done.

[fgd3]

I just finished the Night Navigation page. I was very careful not to disturb the indexmenu line but still it disappeared and Night Navigation is now at the top of the Toolbar Buttons list.

My method on this page was to copy the HTML code (Edit) from the original manual. Using DW Edit I pasted it into the dokuwiki page. To be sure I didn't disturb the existing text with which the page was pre-loaded I moved the cursor to the bottom of the page, then added a carriage return, then pasted.

I went through the code manually looking for formatting instructions that needed to be changed. For example, I replaced <strong> and </strong> with "==== " and " ====". Periodically I previewed the page and compared it with the original manual page (View) to help me figure out what the HTML tags were trying to do. Often there were superfluous tags left over from someone's WYSIWYG editing--we don't need <strong></strong> tags for every word in a sentence, for example.

Everything worked pretty well except for that indexmenu line. If you can fix that problem for me I think I'll have a satisfactory workflow.

Fabbian

[rgleason]

(1) The first form is an absolute reference. If you later move the manual you'll have to revise all those absolute references. The second form is, I believe, a relative reference that will be preserved so long as the directory structure remains unchanged. There's a way to make URLs relative, but I've forgotten it.

(2) Those braces in the second code snippet should be square brackets, shouldn't they?

1. Agreed. I think we want relative, but I was just showing how the URL will help us figure out what path to use.

2. You are exactly right [[ ]] for document links.

[rgleason]

Night Nav page

When in DW Edit mode (with CKG Edit button showing on the bottom menu)
put
{{indexmenu_n>12}} -twelve down

in the first line.

----

Fabbian you are doing fine, and this is great. You might try some experiments because you should be able to have the html automatically transferred to dokuwiki format.

Copy from Druple Edit mode when in Rich Text Format (no html showing)
Paste into Dokuwiki when in CKG Edit mode. Then try Saving it.
When you switch from the CKG Edit mode to the DW Mode, it should translate html to dokuwiki.

Then I have been editing that in DW Edit mode, but whatever works for you is fine!

I'm hitting the hay we have to get up early to catch a plane will be back on line in the afternoon.

[fgd3]

Originally Posted by rgleason

Night Nav page

When in DW Edit mode (with CKG Edit button showing on the bottom menu)
put
{{indexmenu_n>12}} -twelve down

in the first line.

I'm not sure I understand your recommendation. I put
{{indexmenu_n>12}} in the first line. Dokuwiki ate it. Did you fix it? The line is in there now and the page is back where it belongs.

I'm working on the Plugins pages now. I tried
{{indexmenu_n>13}} -thirteen down
on the first line. Dokuwiki changed it to -thirteen down and displayed that text. I tried again with
{{indexmenu_n>13}} and Dokuwiki ate it.

Originally Posted by rgleason

You might try some experiments because you should be able to have the html automatically transferred to dokuwiki format.

Copy from Druple Edit mode when in Rich Text Format (no html showing)
Paste into Dokuwiki when in CKG Edit mode. Then try Saving it.
When you switch from the CKG Edit mode to the DW Mode, it should translate html to dokuwiki.

I don't have an option for Rich Text Format. I can only choose between "View", "Edit", and "Outline". In "View" mode I can read the manual but not edit it. In "Edit" mode I see the HTML source. In "Outline" mode I am offered the opportunity to rearrange parent/child relationships between pages.

Fabbian

[rgleason]

Fabbian,
I wish I could take a sceenshot, but please look down at the bottom of the editing area, just below there should be "Switch to Rich Text Editor" OR "Switch to Plain Text". That will change the editor mode!

[rgleason]

Look at the first screenshot where it shows "Plain text editor" Click on that and you will see the html and the selection will change to "Rich text editor". Hit that and the html dissappears and that content is what you want to copy.
http://opencpn.org/ocpn/Edit-User-Ma...y-move-content

[rgleason]

Actually it starts "Switch to ...."

[fgd3]

Originally Posted by rgleason

Fabbian,
I wish I could take a sceenshot, but please look down at the bottom of the editing area, just below there should be "Switch to Rich Text Editor" OR "Switch to Plain Text". That will change the editor mode!

Not on my screen. I'm running the current version of Firefox and I don't get any choice about editing mode. Maybe you haven't updated your browser in a while so that feature isn't broken yet.

Fabbian

[fgd3]

Originally Posted by rgleason

Look at the first screenshot where it shows "Plain text editor" Click on that and you will see the html and the selection will change to "Rich text editor". Hit that and the html dissappears and that content is what you want to copy.
Copy & Move Content | Official OpenCPN Homepage

According to your link, Rich text editor (misspelled as Rick) is the default. But it just isn't available to me.

Fabbian

[rgleason]

What of this do you have?
| |
| |
| Editing window
-------------------------------------------------------------------------|
Switch to plain text editor

• Web page addresses and e-mail addresses turn into links automatically.
• Allowed HTML tags: <a> <p> <span> <div> <h1> <h2> <h3> <h4> <h5> <h6> <img> <map> <area> <hr> <br> <br /> <ul> <ol> <li> <dl> <dt> <dd> <table> <tr> <td> <em> <b> <u> <i> <strong> <font> <del> <ins> <sub> <sup> <quote> <blockquote> <pre> <address> <code> <cite> <embed> <object> <param> <strike> <caption>

More information about formatting options
Book outline Revision information File attachments
URL path settings Optionally specify an alternative URL by which this node can be accessed. For example, type "about" when writing an about page. Use a relative path and don't add a trailing slash or the URL alias won't work.


Comment settings