Cruisers Forum
 


Join CruisersForum Today

Reply
 
Thread Tools Rate Thread Display Modes
Old 18-01-2016, 07:12   #181
Registered User
 
rgleason's Avatar

Join Date: Mar 2012
Location: Boston, MA
Boat: 1981 Bristol 32 Sloop
Posts: 9,382
Re: Opencpn 4.1.1108 Documentation

Perhaps Others have known this... I just discovered it.

YOU CAN DRAG AND DROP IMAGES TO AND FROM THE EDIT INTERFACE.

This makes working with images much much easier..
Wish I had know it.

Still need a decent way to search for specific images though.
Also would like to be able to rename the image (even someone else's) and have all the links to that image automatically change.
__________________

__________________
rgleason is offline   Reply With Quote
Old 18-01-2016, 08:01   #182
Registered User

Join Date: Mar 2010
Location: Wandering around North America
Boat: Defever 43 - Gray Hawk
Posts: 602
Re: Opencpn 4.1.1108 Documentation

I went back and fixed my naming. You are correct Rick that even the ability to rename images in the editor would be a huge improvement. If you want to assign a particular section for image resize and rename we expect to have terrestrial Internet for most of this week.

R.J.(Bob) Evans
www.bobandmarilyn.ca
__________________

__________________
R.J.(Bob) Evans
M/V Gray Hawk, 43 Defever Offshore Cruiser
http://www.bobandmarilyn.ca
bobofthenorth is offline   Reply With Quote
Old 18-01-2016, 08:05   #183
Registered User
 
rgleason's Avatar

Join Date: Mar 2012
Location: Boston, MA
Boat: 1981 Bristol 32 Sloop
Posts: 9,382
Re: Opencpn 4.1.1108 Documentation

This is what needs to be done next.

Quote:
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?

After that we will need to work on strategic resize of certain specific photos throughout the text. This will have a great improvement on the final size. I will prepare a list of the photos we need to resize if someone can go through and eliminate these 'Hidden' links that require internet (NOT PAGE LINKS to OpenCPN.org!!!). Be carefully until you get the hang of it. Figure out how to change the color of those hidden links and please advise how you did it.

Thank you.
__________________
rgleason is offline   Reply With Quote
Old 18-01-2016, 08:25   #184
Registered User

Join Date: Feb 2010
Location: On the go. Not in Prague.
Posts: 4,016
Re: Opencpn 4.1.1108 Documentation

Rick...
Don't worry about the external links, we can handle them automatically during the documentation packaging as we do with other stuff (as you can see in the script Peter linked earlier) What is important is the content (=text and logic of the documentation), technical aspects are much less of an issue.

Pavel
__________________
nohal is offline   Reply With Quote
Old 18-01-2016, 12:03   #185
Registered User
 
rgleason's Avatar

Join Date: Mar 2012
Location: Boston, MA
Boat: 1981 Bristol 32 Sloop
Posts: 9,382
Re: Opencpn 4.1.1108 Documentation

Pavel, thanks about the hidden links, I won't do them.
You haven't been reading above probably...Its all there but I'll summarize.

You are going to end up with a very big documentation file if you don't let me convert and use JPG! I have used Optipng and it does not do the job we need, unfortunately:
  • Without the external plugins page and converting to jpg I have 10.5mb for the images.
  • If I compress the images as png using optipng I get about 28 mb
  • If I compress the images as png using PNGGaunlet I get about 24 mb
  • The png files as downloaded are about 32 mb.

I'd like to do another Dry Run -
I have used JPG compression #8 to get down to 10.5 mb, I would like to use JPG compression #7 to get less, but add the External Plugin page back in and see what Total Images size (JPG) I get.

Once I know that. I want to take the largest size images (top 25%-30%) over 200kb and resize them to exactly the resolution used in the manual.

Then do the final download and PNG to JPG conversion with #7 compression.
Then on the HTML do a search on '.png' and replace '.jpg'
Check the file with a browser.

Then you can have it.

Or do you want to do that?
__________________
rgleason is offline   Reply With Quote
Old 18-01-2016, 12:46   #186
Registered User
 
rgleason's Avatar

Join Date: Mar 2012
Location: Boston, MA
Boat: 1981 Bristol 32 Sloop
Posts: 9,382
Re: Opencpn 4.1.1108 Documentation

DRY RUN
------------
Using the smaller version (without the External Plugin documentation)
Resized the top 100 image files (24mb) ranging from 60-885kb and
resized any that are > 525 px wide down to 525px and then compressed them to #7. That resulted in 24mb ----> 3.7mb!

(These 100 files could be manually inserted back into the documentation and the whole website will be faster and better too.)

Will try same again, but including the External Plugins pages (41mb of images)
__________________
rgleason is offline   Reply With Quote
Old 18-01-2016, 13:02   #187
Registered User

Join Date: Nov 2014
Location: Netherlands
Posts: 179
Re: Opencpn 4.1.1108 Documentation

Rick,

I ran Pavel's script on the original total docs and the result was 17Mb for the images.
So that is about 2Mb more than the previous 4.0 doc.

Peter
__________________
ptulp is offline   Reply With Quote
Old 18-01-2016, 13:03   #188
bcn
Registered User

Join Date: May 2011
Location: underway whenever possible
Boat: Rangeboat 39
Posts: 2,761
Re: Opencpn 4.1.1108 Documentation

Rick..

and did you look at the images with different screen sizes and resolutions?

50MB is not a problem - but for very,very few users. Shall we have a solution for them? - yes. But as a fallback, please.
(Exactly the one on a Pacific Island will need a complete in-package manual because he can't just have a look via Internet afterwards)

The main point is to have a manual that is readable (with/without glasses) and complete.

/rant off
__________________
bcn is online now   Reply With Quote
Old 18-01-2016, 13:19   #189
Registered User
 
rgleason's Avatar

Join Date: Mar 2012
Location: Boston, MA
Boat: 1981 Bristol 32 Sloop
Posts: 9,382
Re: Opencpn 4.1.1108 Documentation

Who is working on the User Documentation and creating URL's that are too long?
There are now 8 eight of these and they are pretty obviously IMAGE files that are a part of the documentation!!

Quote:
Request-URI Too Large

The requested URL's length exceeds the capacity limit for this server.

Apache/2.2.29 (Unix) mod_ssl/2.2.29 OpenSSL/1.0.1e-fips mod_bwlimited/1.4 Server at 74.112.249.100 Port 80
The image file does not download, and this html is left in the directory.
How can we find these and fix them?

Later: Who knows? Perhaps it is me. I used drag and drop to fix image file names that had spaces. Perhaps that technique is not permitted? It seemed to work. Is there someone else working on the User Documentation Now? Concurrently?
__________________
rgleason is offline   Reply With Quote
Old 18-01-2016, 13:30   #190
Registered User

Join Date: Jul 2010
Location: Monastir, Tunisia
Boat: Amel Sharki
Posts: 1,774
Re: Opencpn 4.1.1108 Documentation

A good software doesn't need any documentation. It should be intuitive to use for every user without making the user scratching his head...

There are styleguides missing for every port of OpenCPN especially to help plugin developers.

Gerhard
__________________
CarCode is offline   Reply With Quote
Old 18-01-2016, 14:15   #191
Registered User
 
rgleason's Avatar

Join Date: Mar 2012
Location: Boston, MA
Boat: 1981 Bristol 32 Sloop
Posts: 9,382
Re: Opencpn 4.1.1108 Documentation

ANOTHER DRY RUN with the External Plugin Pages
--------------------------------------------------------
After determining that the most effective way to compress is
1. Use FastStone Photo Resizer Batch process: convert, resize & compress
2. Resize all photo with width > 525px to be 525px
- Batch Convert Tab,
-check Advanced Options
- Resize Tab, Check Resize,"Resized based on one side" button.
- Also Select"Predefined width exactly" enter 525.
- Also Check "Do not resize if image is already smaller."
In the main window check keep original date/time and ask before overwrite.
Output Format: Jpeg Settings: Pick Quality 70
Output Folder: Browse to your output folder, select it.
In the main window "Pick All files"
Then "Convert"

User Documentation image files
44.5 mb ----> 12.7 mb
728 files total of 44.5 mb, mostly PNG (875kb max) converted to just 12.7 mb
The quality is fine for our purposes.

Total Expected size HTML 900 kb + 12.7 mb = 13.6 mb
I believe this is slightly less than v4.0

Therefore I am leaving the External Plugins in the documentation.

Pavel, I will now post these image files in a zipped up file on

Opencpn Beta File Thingie rguser rgpass
Under the User Manual directory

You need to edit the HTML file and Search on "*.png" and "*.gif" and replace with "*.jpg" to have it work properly.
__________________
rgleason is offline   Reply With Quote
Old 18-01-2016, 14:30   #192
Registered User
 
rgleason's Avatar

Join Date: Mar 2012
Location: Boston, MA
Boat: 1981 Bristol 32 Sloop
Posts: 9,382
Re: Opencpn 4.1.1108 Documentation

Gerhardt wrote:
Quote:
A good software doesn't need any documentation. It should be intuitive to use for every user without making the user scratching his head...

There are styleguides missing for every port of OpenCPN especially to help plugin developers.
Gerhard
Agreed. - So why are we doing this? Particularly with you on the team reminding us! However I don't feel so good about all the effort so many have put in...

But I wish to thank everyone nevertheless, Peter, David, Roel, Jon, Dirk and many others. I think we've made some improvements for new users. I expect Gerhardt will promise not to use the manual because O is so good and he knows it already*!

Hopefully others will find it useful.

*PS: I can say this because Gerhard has been a great help to me many times, and he knows I am kidding.

PSS: I am glad this stage is finishing...and look forward to 4.2 as all users do.
__________________
rgleason is offline   Reply With Quote
Old 18-01-2016, 16:02   #193
Registered User
 
rgleason's Avatar

Join Date: Mar 2012
Location: Boston, MA
Boat: 1981 Bristol 32 Sloop
Posts: 9,382
Re: Opencpn 4.1.1108 Documentation

Quote:
I ran Pavel's script on the original total docs and the result was 17Mb for the images. So that is about 2Mb more than the previous 4.0 doc. Peter
No Peter, actually the previous was 14 mb I believe.
I have sent Pavel html and image files zipped via O Beta File Thingie with two options that are much much smaller which users of smaller machines will appreciate:

1. 13.5 mb Jpg compressed to 70 good quality.
2. 9.3 mb Jpg image files compressed to 50 and still very legible.

Thanks for letting me know. Did your optipng 7 include the full plugins? because that when downloaded starts out at 44mb and I seriously doubt that optipng could get that down to 17mb. I think it would end up more like 24mb, but I could be wrong.

PS: If you want to try out the html, its on O Beta File Thingie.
__________________
rgleason is offline   Reply With Quote
Old 18-01-2016, 16:07   #194
Registered User
 
rgleason's Avatar

Join Date: Mar 2012
Location: Boston, MA
Boat: 1981 Bristol 32 Sloop
Posts: 9,382
Re: Opencpn 4.1.1108 Documentation

Forgot bobofthenorth and gilletarom who also helped. Thank you.
__________________
rgleason is offline   Reply With Quote
Old 18-01-2016, 16:17   #195
Registered User
 
rgleason's Avatar

Join Date: Mar 2012
Location: Boston, MA
Boat: 1981 Bristol 32 Sloop
Posts: 9,382
Re: Opencpn 4.1.1108 Documentation

Hurbert wrote
Quote:
and did you look at the images with different screen sizes and resolutions?

50MB is not a problem - but for very,very few users. Shall we have a solution for them? - yes. But as a fallback, please.
(Exactly the one on a Pacific Island will need a complete in-package manual because he can't just have a look via Internet afterwards)

The main point is to have a manual that is readable (with/without glasses) and complete.
Hurbert, I hear you. We can't have everything! Its a balance. Thomas was making me redo images last time v4.0 and that turned out to be 14mb total. We are just under that at 13.5mb or 10.5mb. still very legible. I have eye troubles too and miss stuff in small print.

I put the External Plugins back into the manual and the other sections that are out this time are not essential but good for the internet web version.

If you want to try it out I suggest you download the O-Manual.7z with O User Doc html + image files about 13.5 mb unzipped.

Opencpn Beta File Thingie rguser, rgpass
under the User Manual O directory.

Its not perfect, but I've tried it and it works well...speedy, no big image loading. Links seem to be fine and images are working. Quality is just below high..
__________________

__________________
rgleason is offline   Reply With Quote
Reply

Tags
documentation, enc, men, opencpn

Thread Tools
Display Modes Rate This Thread
Rate This Thread:

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Trackbacks are Off
Pingbacks are Off
Refbacks are Off


Similar Threads
Thread Thread Starter Forum Replies Last Post
OpenCPN Beta test 4.1.1108 Release bdbcat OpenCPN 694 14-01-2016 08:10
Beta test 4.1.1108 on ARM NahanniV OpenCPN 9 07-12-2015 09:09
Value of USCG documentation? Wahoo Sails Rules of the Road, Regulations & Red Tape 18 07-09-2008 14:13
federal documentation/state requirements?? cadye Rules of the Road, Regulations & Red Tape 3 24-08-2005 13:23
USCG Documentation delay? alicemacinnes Rules of the Road, Regulations & Red Tape 2 14-12-2004 07:12



Copyright 2002- Social Knowledge, LLC All Rights Reserved.

All times are GMT -7. The time now is 02:10.


Google+
Powered by vBulletin® Version 3.8.8 Beta 1
Copyright ©2000 - 2017, vBulletin Solutions, Inc.
Social Knowledge Networks
Powered by vBulletin® Version 3.8.8 Beta 1
Copyright ©2000 - 2017, vBulletin Solutions, Inc.

ShowCase vBulletin Plugins by Drive Thru Online, Inc.