Download Docs ?


(Brian) #1

I see the https://docs.syncthing.net/ website. Is there an aggregated pdf file or something similar I can download to have documentation off line?

I didn’t find an explanation of how to do this in the docs.


(Jakob Borg) #2

Not currently, no. There are PDF builds of the getting started guide and the FAQ, which get included in the release packages. Those are here: https://docs.syncthing.net/pdf/ (together with a bunch of supporting files). To create a PDF of the whole thing, or maybe per top level section, should be possible and just require tweaking of the doc build process.


(Brian) #3

I had some success with wget, yielding a 9.9 MB version of the html documents, usable even when I don’t have internet.

wget -r --no-check-certificates “https://docs.syncthing.net

I would have expected the -k option was necessary but it must default on, because all the interdependent links converted to be locally interpretable. Or… maybe the doc pages are already built that way.


(Jakob Borg) #4

Is there something wrong with our certificates? Disabling certificate checks should not be a general recommendation.


#5

Probably an older version of wget (I think even Ubuntu 14.04 had that), which still gives a cert error if the server uses SNI.


(Brian) #6

Honestly, I didn’t try to debug the situation - just went with the quick fix. Here’s a printout of the version and the error. I’m using wget on a Mac command line.

Version:

$ wget --version
GNU Wget 1.11.4

Copyright (C) 2008 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later
<http://www.gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Originally written by Hrvoje Niksic <hniksic@xemacs.org>.
Currently maintained by Micah Cowan <micah@cowan.name>.

Here’s the error I get. It appears the subdomain conflicts with the certificate, which is associated with the main domain.

$ wget -r "https://docs.syncthing.net"
--2017-02-18 07:57:08--  https://docs.syncthing.net/
Resolving docs.syncthing.net... 46.101.130.230, 2a03:b0c0:3:d0::18d6:8001
Connecting to docs.syncthing.net|46.101.130.230|:443... connected.
ERROR: cannot verify docs.syncthing.net's certificate, issued by `/C=US/O=Let's Encrypt/CN=Let's Encrypt Authority X3':
  Unable to locally verify the issuer's authority.
ERROR: certificate common name `syncthing.net' doesn't match requested host name `docs.syncthing.net'.
To connect to docs.syncthing.net insecurely, use `--no-check-certificate'.
Unable to establish SSL connection.

#7

Yep. SNI support was added in wget 1.14. Your version 1.11 is over 7 years old.


(Brian) #8

wweich (@Community MVP),

Uh… you don’t want to hear the age of my computer!

I know versions of software go out of date quickly and computers are upgraded often. As for me, until there is a compelling reason, I do not do upgrades, which take time and introduce risk.

I thought it was a little aggressive when I read about software (I think it was the Synctrazer package) was not even distributing compiles for 32 bit machines. Oh well…


(Antony Male) #9

What? The 32-bit installers for SyncTrayzor are right alongside the 64-bit ones.

Just make sure you’re keeping on top of your security updates :wink:


(Brian) #10

Antony (@canton7),

I read d4k0’s March 2015 post too quickly, where he mentions what he read on GitHub. Download Docs ? refers to x86 builds.


(system) #11

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.