Date: Sat, 21 May 2016 21:52:51 -0600 (MDT) From: Warren Block <wblock@wonkity.com> To: Jason Gorman <mrjasongorman@gmail.com> Cc: freebsd-doc@FreeBSD.org, wblock@FreeBSD.org Subject: Re: Idea about the handbook Message-ID: <alpine.BSF.2.20.1605212146210.44409@wonkity.com> In-Reply-To: <CAJU4u5j=5fH7RYh4UgfC=L2WfLtFRDvq5DAjiK4Tm_pBAkdW8A@mail.gmail.com> References: <CAJU4u5j=5fH7RYh4UgfC=L2WfLtFRDvq5DAjiK4Tm_pBAkdW8A@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, 22 May 2016, Jason Gorman wrote: > Hey, i've recently become interested in FreeBSD and of course stumbled > across the handbook. Have to say it's brilliant! > > One thing however I found slightly annoying is that i've been reading the > handbook in my spare time, and chances are whilst reading it i've been on > either my tablet or my phone. Unfortunately the handbook doesn't seem to be > very mobile or tablet friendly. > > My profession is currently a front end developer and I would love to tweak > the CSS file for the handbook, and send it over to you guys to see what you > think. I think I speak for numerous people when saying we would be very interested in that. The FDP Primer shows how to check out and build the docs: https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ There is a lot there to digest. I (and others) can help you get a local build of the website working to experiment on. As an aside, note that we have beta-quality epubs which might be more suited to mobile use. They are on the FTP server now: ftp://ftp.freebsd.org/pub/FreeBSD/doc/en_US.ISO8859-1/books/handbook/book.epub The "beta" part is that image links are broken. I investigated that, and it's something to do with the build environment--the links are fine when built normally on a developer system. However, I ran out of time to work on it. It only affects images, which are mostly in the installation chapters, so most of the book is usable. > Having the handbook responsive would help a great deal, especially if for > example i'm configuring a system and wanted to lookup the handbook on my > phone for reference. > > Let me know if this is something you guys would be interested in. Absolutely!
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.BSF.2.20.1605212146210.44409>