Opencpn 4.1.1108 Documentation

[rgleason]

I don't think this will alone will meet the goals, however it is running.

As an example:
900x370 reduced to 550x226 is a 61% reduction
and I would expect about that reduction in file size.

So we may be much better off:

1. Finding batch file "resizer" program for png down to 550 x max or even better one that we can key in the actual size being used in the content. That would be 724 images, 1400 numbers, but it would give us a much smaller document.

2. The 71 files that are oversize, and getting them resized down to 550 x

Then running optipng!

Easiest first thing to do is move the document identified out to "Document Hold" Folder in Development.

[rgleason]

BoboftheNorth wrote:

I sent you a private email but if you are reading this thread perhaps you could review the changes I made to the BSB4 documentation. If I'm on the right track let me know & I'll wrap it up before we move tomorrow morning.

Yes, Bob you are on the right track!
Please simplify and simplify and get it so it is clear to you. Gilletarom and I spent some time on it, (parts came from his website in French) but I have not organized it properly.

Make it simple and clear please. Just what is needed to install and give some idea of how it works.

Thanks very Much!

[Roel Smidt]

Originally Posted by rgleason

Found it here
OptiPNG Home Page

Will trial run it now.

Rick, maybe useful (easier) for Window-users: PNGGauntlet. It gives a GUI and also works together with OptiPNG. The website says: "Combines PNGOUT, OptiPNG, and DeflOpt to create the smallest PNGs".

Just tried it and looks good.

PNGGauntlet - PNG Compression Software | BenHollis.net

Roel

[rgleason]

Roel,
What a great help! Thank you!!!!!

There are a lot of these files with 600, 700, 750 width do you think I can just tell it to scaled those that are larger than 550 wide, to shrink them to 550? They go from 200kb-30kb down to 100-120 kb.

optipng, reduced it 35mb/46mb or 76%
If we want to have the documentation be 14-15mb that means we can only have 18mb of images at the start.

I think we can do better than that by reducing all images > 550 px wide down to 550. Then optipng.

I will try this program. Thankyou Roel!

Rick, maybe useful (easier) for Window-users: PNGGauntlet. It gives a GUI and also works together with OptiPNG. The website says: "Combines PNGOUT, OptiPNG, and DeflOpt to create the smallest PNGs".

Just tried it and looks good.

PNGGauntlet - PNG Compression Software | BenHollis.ne

[wdkester]

Originally Posted by rgleason

Today,

1. All External and 3rd party plugins
2. Charts - remove Quilting, Formats, Advanced Chart Work, CM93 offsets
3. Advanced Features -Anchor watch, Automated Anchor, Nobj.xml, Keyboard shortcuts, command line, config file, opengl, network repeater, portable opencpn, low power systems.
4. FAQ
5. Links
6. Edit User Manual

Should we also remove Chart Sources too? We have Chart Downloader.

Also I am reluctant to remove Connections, but should we?

Should we move Keyboard shortcuts to just under "Right Click"?
and thus keep it in the abbreviated version. We will not change the URL and so all links should still work. How important is the Keyboard shortcut documentation? It can be moved.

-

Out of the above, the only things that I would not move are Chart Quilting and connections. After those 2 my candidates (ranked order) for leaving in are: OpenGL, config file, Anchor Watch, Chart Formats.

Since this was written perhaps it is not so critical to remove all these sections. My 2 cents.

[Roel Smidt]

Originally Posted by rgleason

Roel,
There are a lot of these files with 600, 700, 750 width do you think I can just tell it to scaled those that are larger than 550 wide, to shrink them to 550?

Rick, I did not find that option in PNGGauntlet or OptiPNG (yet). But for the Watchdog documentation I initially used Faststone Photo Resizer 3.5 for Windows. That program gives you in Advanced Options the option to resize by a predefined side (like width 550 but I used 460).

See the attached screenshots and here is the link for downloading the program
Download FastStone Photo Resizer

Roel

[rgleason]

David wrote:

Out of the above, the only things that I would not move are Chart Quilting and connections. After those 2 my candidates (ranked order) for leaving in are: OpenGL, config file, Anchor Watch, Chart Formats.
Since this was written perhaps it is not so critical to remove all these sections. My 2 cents.

Dave you're the only one responding, so I am listening!
1. Website = Full version
2. Included in program executable < 15 mb (Condensed version)

I will temporarily move the following to "Edit - Temporary Hold" under the Developer Manual. In the following order of priority:

1. External and Other plugins.
2. FAQ
3. Links
4. Edit User Manual
5. Advanced Features (Temp. Move all except the following)
   1. Advanced -OpenGL
   2. Advanced -Config file
   3. Advanced -Anchor Watch
6. Charts (Do not Temp. move any not mentioned below)
   1. Advanced Chart Work (link) - Temp. Move
   2. CM93 - Temp. Move
   3. Chart Formats - Do not Temp. move if possible)

I am not sure this is going to get us down to the 15mb required even with the editing and compression of image files, but we'll try it.

Using optipng we are only down to 35mb!

[rgleason]

I believe Thomas' note explicitly states that we must not have any spaces in
URL for pages
IMAGE file names
They result in %20 and cause trouble on various systems!!

I have found the following images have this condition and must therefore be changed. I note that I have several. We need to put a dash in there!!

AtoN_reallife%20great%20lakes
AtoN_reallife%20great%20lakes
Boundary%20Point%20Properties%20Basic%20dialog
Boundary%20Point%20Properties%20Extended%20dialog
Boundary%20Properties%20dialog
DR%20Point%20Properties%20Basic%20dialog
DR%20Properties%20dialog
Draw%20Toolbar
EBL%20Point%20Properties%20Basic%20dialog
EBL%20Properties%20dialog
OD%20Dead%20Reckoning%20Information%20Dialog
OD%20objects
OD%20Preferences%20About
OD%20Preferences%20Boundary%20Point
OD%20Preferences%20Boundary
OD%20Preferences%20dialog
OD%20Preferences%20DR%20Point
OD%20Preferences%20DR
OD%20Preferences%20EBL
OD%20Preferences%20Text%20Point
Screen%20Shot%202016-01-07%20at%2012
Text%20Point%20Properties%20Basic%20dialog

There are about 23 files. If someone can do this it would be appreciated.
Otherwise I will get to it after moving the various docs to Edit-Temporary Hold.

Thanks.

PS This isn't too bad really, could be a lot worse! But lets try to remember. Thanks..

[rgleason]

Roel,

Faststone Photo Resizer, very nice, easy to use. Brought it down from 35mb to 20mb!

Then we'll run PCGauntlet and compress some more out.

Now have to look at the HTML Page to make sure it doesn't change that much..

Now will make the moves to Temporary Hold.

NOTE: This all a dry run I have to make the phote name %20 to - changes and I need to move stuff into Edit-Temporary-Hold. Then Export download again.

[rgleason]

Ok, the necessary pages have been moved to Dev Manual - Edit-Tempary Hold

Chart Sources and Chart Formats are included because they are mostly text and no images. Chart Quilting has about 5 images x <200kb = 1 mb so that stays.

Next we have to change the 23 image file names (spaces) %20 to -.
Then export and download again.

[rgleason]

In the first dry run FaststoneResizer settings were to change from png to jpg, resulting in good compression, but the html did not work due to file ext change. This is easy to fix with search & replace. We took the full manual down to 20 mb.

With condensed User Manual downloaded (32 mb) I ran FaststoneResizer width < 525px and if already less, don't touch. Some files got bigger & some smaller in this process, the result was (30mb) for all condensed version files (about 498).
PNG Gauntlet is now running, but it is hitting between 70% and 95% so I would be surprised to see a reduction in size below 21mb.

I can try to get this smaller by applying some color filters that reduce color depth. How important is color? -- not very. size is more important.

The other approach is to convert to JPG and compress as much as we need to. I can then run a search and replace on PNG and I am pretty sure we can get this down at 14mb, it will be lossy.

Any objections to JPG?

[rgleason]

Wrote to David:

PNG Resize with Faststone Photo Resizer then use PNG Gauntlet = 32.1 mb *
JPG Resize with Faststone Photo Resizer and covert to JPG (set on 8) = 10.5 mb

* I could merge the smaller files from the original file folder which will lower the total size.
Generally smaller files got a little bigger in the two step PNG process which was not really effective. I don't think this will come close to JPG.

Resized all files that were > 525 px wide to be 525 wide. I could increase this to 550 wide.

In the morning I am going to try
PNG -Just PNG Gauntlet on the original files to see what happens. Don't think it will be nearly as small.

Any objection to using JPG files and doing search and replace on the Html?
Samples attached.

I can zip the image files and html and email or perhaps better, put it on File Thingie for you.

Should I add back the External Plugins Page (with pretty big images)?

[ptulp]

Rick,

Here is the script that Pavel runs when building the docs for a release.
https://github.com/nohal/OpenCPNScri...ter/doc_fix.sh

So it looks like the big image files >100K are converted to JPG's and then compressed.
JPG's are compressed much more efficient.

Peter

[rgleason]

Bdbcat, advises to carry on, and there is more work to do. He will take a snapshot at the very end. [If he does this the normal way he will end up with a 30mb file! -but we will get this sorted out. It can be 10 mb]

Here is some of the current list for those who are helping

4 Check for and delete hidden links, introduced into the wiki by copy/paste from the forum!! These may not show in the wiki but use to be easy to spot in the produced single page. Test by setting all links to be colored or underlined.

-We need to eliminate these hidden links.
-What about "http://" links to the Forum. There are a lot of them.
-These links are going to be a problem on a boat with no internet.
-These links are Not a "help" for a Help Document.
Shouldn't we eliminate them?

5 When naming picture files, pick names that are unique, taking into account that Windows does not differ between cases. Test1.png is considered equal to test1.png.

- Use hypens or underscore instead of spaces.

6 No spaces in picture files names.

I have downloaded the images below, will rename then using "-" instead of a 'space' and resize to 550 width, and then upload to my folder.

We need someone to carefully go through the docs and insert an image without spaces at the following locations, using the images I have changed and uploaded:

AIS Page
AtoN_reallife%20great%20lakes.png

ODraw Plugin
Boundary%20Point%20Properties%20Basic%20dialog.png
Boundary%20Point%20Properties%20Extended%20dialog. png
Boundary%20Properties%20dialogpng
DR%20Point%20Properties%20Basic%20dialog.png
DR%20Properties%20dialog.png
Draw%20Toolbar.png
EBL%20Point%20Properties%20Basic%20dialog
EBL%20Properties%20dialog
OD%20Dead%20Reckoning%20Information%20Dialog
OD%20objects
OD%20Preferences%20About
OD%20Preferences%20Boundary%20Point
OD%20Preferences%20Boundary
OD%20Preferences%20dialog
OD%20Preferences%20DR%20Point
OD%20Preferences%20DR
OD%20Preferences%20EBL
OD Preferences Path
OD%20Preferences%20Text%20Point
OD Text Point Properties Display Text
Text%20Point%20Properties%20Basic%20dialog

Screen%20Shot%202016-01-07%20at%2012

Later : No - This is part of OD I think.

[rgleason]

I think it is just easier for me to insert these images. The tools on line are quite antiquated and one way.

There is no search for photos to do a search and replace!
This is a problem.
Also the tools for changing an image are pretty cumbersome.
I would like to see the entire EDIT interface updated because it is clunky and quite old. Drupal has newer better interfaces.