From owner-freebsd-doc@freebsd.org Sun May 22 03:52:58 2016 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 5560FB41021 for ; Sun, 22 May 2016 03:52:58 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "wonkity.com", Issuer "wonkity.com" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 16AE11D5A; Sun, 22 May 2016 03:52:57 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.15.2/8.15.2) with ESMTPS id u4M3qpMJ051432 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Sat, 21 May 2016 21:52:51 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.15.2/8.15.2/Submit) with ESMTP id u4M3qpvl051429; Sat, 21 May 2016 21:52:51 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Sat, 21 May 2016 21:52:51 -0600 (MDT) From: Warren Block To: Jason Gorman cc: freebsd-doc@FreeBSD.org, wblock@FreeBSD.org Subject: Re: Idea about the handbook In-Reply-To: Message-ID: References: User-Agent: Alpine 2.20 (BSF 67 2015-01-07) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Sat, 21 May 2016 21:52:51 -0600 (MDT) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 22 May 2016 03:52:58 -0000 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!