Opencpn 4.1.1108 Documentation

[rgleason]

How Links & Headings Work | Official OpenCPN Homepage

They work completely normally as you would expect.

The key thing to remember about links is that they must work!
They do NOT have to match the Heading of the document being referred to.
however the URL pasted into the HYPERLINK must be correct so that the link works.
Then the automated PHP code will create good links in the Exported single page Wiki.

[rgleason]

How Links & Headings Work | Official OpenCPN Homepage

They work completely normally as you would expect.

The key thing to remember about links is that they must work!
They do NOT have to match the Heading of the document being referred to.
however the URL pasted into the HYPERLINK must be correct so that the link works.
Then the automated PHP code will create good links in the Exported single page Wiki.

[rgleason]

David,

Editing and changing the Outline is actually quite straight forward.
The only requirement is that links work correctly.

I've been adding pages to the Editing Manual here and have organized it.

Edit the User Manual | Official OpenCPN Homepage

Need to put some screenshots up when I have time.

Would you mind looking at

Getting Started | Official OpenCPN Homepage

To see what other changes are needed?

[wdkester]

Originally Posted by rgleason

How Links & Headings Work | Official OpenCPN Homepage

This is ironic. I get "page not found" for the above link!

I'll look at this AM but it might be tomorrow before I do anything.

I think we need a standard way to identify links; italics or underline or both.

[rgleason]

Yes it is. I changed the URL. Sorry.
Where was that link? I am sorry.
It is now:
Links & Headings | Official OpenCPN Homepage

Its going to stay that way now.

[wdkester]

Originally Posted by rgleason

David,

Editing and changing the Outline is actually quite straight forward.
The only requirement is that links work correctly.

I've been adding pages to the Editing Manual here and have organized it.

Edit the User Manual | Official OpenCPN Homepage

Need to put some screenshots up when I have time.

Would you mind looking at

Getting Started | Official OpenCPN Homepage

To see what other changes are needed?

I'll look at it this AM but will be busy until tomorrow.

A general comment - There seems to be a lot of redundancy. I'll leave most of it in because of the way the manuual will be used; but, having the open soft ware notice more than once is silly. They will see it when they install the S/W.

I think we should put internal links in italics(this is standard) and underline external links(not standard yet).

[wdkester]

Rick,

Comment on out of date screens- If they are functionally OK I leave them. If they are functionally wrong (e.g. options>charts) I replace them.

I have updated: Getting Started, Windows, (don't know anything about UNIX variants or Mac OS), Troubleshoot Installation looks OK; but a developer should check.

I will start on OpenCPN First Use tomorrow. First impression- lots of out of date sreens

[ptulp]

There is a problem with the naming of AIS.
There are 2 locations with just AIS in the Heading.

In the MenuBar and in the Toolbar Buttons.
This causes problems in the export doc.

Change to AIS Menu in the MenuBar is maybe the best solution??

Peter

[rgleason]

I'll look at it this AM but will be busy until tomorrow.

A general comment - There seems to be a lot of redundancy. YES I'll leave most of it in because of the way the manual will be used; but, having the open soft ware notice more than once is silly. YES They will see it when they install the S/W.

I think we should put internal links in italics(this is standard) and underline external links(not standard yet YES

I would like to whittle it down.
We can do that with what I call Jump Pages

Look at the Plugins that is not under Toolbar_Buttons

OpenCPN User Manual | Official OpenCPN Homepage

Plugins | Official OpenCPN Homepage

Eventually I hope someone will suggest a way to make a direct hyperlink in the menu! That would be useful to eliminate redundancy.

We need to clean up Getting Started more I think.
Chart Installation is kind of a jump page and maybe it should just be a Jump page with nothing but a link to
Chart Installation
Chart Files Tab | Official OpenCPN Homepage

Ptulp, I will look at the link. Thanks.

[rgleason]

There is a problem with the naming of AIS.
There are 2 locations with just AIS in the Heading.
In the MenuBar and in the Toolbar Buttons.
This causes problems in the export doc.
Change to AIS Menu in the MenuBar is maybe the best solution??
Peter

Yes, indeed. Peter you have identified that there is just one important requirement for Headings.

Headings
1. All Headings must be unique, otherwise the PHP program uses the first heading to make the internal link in all following cases. 2. Heading text is used to make the menu to the left, so the heading should be as short as possible, otherwise the menus on the left become terrribly formated and unreadable.
3. A shortened or longer version of the Heading should be put in the URL link below the edit screen so that we can find the page later with searches if it gets lost or disassociated. This URL should start with a single word from the parent title, followed by an underline. EG: toolbar_scale
4. The URL must be used for all hyperlinks in the text, so it is best not to change the URL's once established, otherwise text links will break.

I seem to be doing that a lot lately, but I wanted to "get it right" at the beginning, because I had a title that was way too long "How to ..." Sorry again.

Thanks Peter.

Yes, under Menubar changed AIS to AIS Menubar and now in the single page Export version it works.

Changed Heading to AIS Menubar
http://opencpn.org/ocpn/Menubar_AIS <-- did not change this, they were already unique, and need to be.

Left Heading as AIS
http://opencpn.org/ocpn/toolbar_AIS <-- did not change this. It is a unique identifier of the page.

Now when I click on Toolbar Buttons AIS in the Exported version, the second AIS link in the flat document goes where it should.
AIS

And the MenuBar AIS goes where it should AIS Menubar

[rgleason]

Because it is the second instance using the same Heading the Plugins menu item in the bottom of the main directory, misses the Jump page in the export wiki and goes straight to the page we want it to go to. http://opencpn.org/ocpn/ocpn_manual_export/
Wouldn't it be nice if we had an direct external link for menu items though?

[ptulp]

Rick,

Are you working on the doc for the Chart Downloader Plugin?
We are totally missing that.

Peter

[ptulp]

I see that the Chart Downloader plugin description is under
Charts->Charts Download Tab.

So the plugin link should point there I guess.

Peter

[rgleason]

Yes
Pavel TDan and I wrote it.
I will retrieve it and put it in the pi internal page.

[rgleason]

BTW
The text portion of the documentation is very small.
However the images are 45mb.
Therefore we should try to be smart and sparing in our inage use.