[PC-BSD Testing] PC-BSD handbook HTML version took longer to open than FreeBSD handbook

Curt Dox tigersharke at gmail.com
Fri Jan 4 07:41:08 PST 2013


oops. meant to replay-all.

On Fri, Jan 4, 2013 at 9:38 AM, Curt Dox <tigersharke at gmail.com> wrote:

>
> On Fri, Jan 4, 2013 at 9:02 AM, Dru Lavigne <dru.lavigne at att.net> wrote:
>
>>
>>
>>     On 01/03/2013 23:28, claive alvin
>>       Acedilla wrote:
>>
>>
>>     Can the PC-BSD handbook HTML version be designed like
>>       the FreeBSD handbook html version where the first page is just the
>>       table of contents for fast browsing of topics. The FreeBSD
>>       handbook also has an option to display the whole book in one page
>>       but it is an option because a one page to display the whole book
>>       will take longer to load.
>>
>>
>>     We may be able to create a "landing" page or something to bring up
>>     the first page quicker. Dru, is this something we can easily do on
>>     the wiki?
>>
>>
>> The wiki is already formatted this way. However, the wiki is for creating
>> the next version, not the current version of the Handbook. The HTML version
>> is actually a file on the FTP server.
>>
>> I've cc'd in tigersharke who is working on the html template for his
>> thoughts.
>>
>> Cheers,
>>
>> Dru
>>
>>
>> I would suggest two things individuals could do to match those requests:
> To speed up initial display, disable automatic loading of images. The other
> change that could be done is to disable javascript, which should cause a
> display of all section links before the remainder of the handbook content.
>
> Even if I added a way to enable/disable the sidebar menu effect (which I
> want to do), it would not speed up the loading of the entire document.  The
> difference between the FreeBSD handbook and ours, is that we have a
> multitude of images within it, while theirs has few.  The main issue is
> that it is one huge html file which allows it to be easily downloaded for
> local use, but means that a web browser would see (tho not display) all
> images at the outset. If we broke it down into individual html files, it
> would likely speed things up but at the cost of easy download and further
> complication IMHO.  I have not explored sectioning our large html file into
> separate 'chained-together' div containers so I don't know what that would
> do.
>
> Another concept I have thought about is to add links for other versions of
> the handbook and other languages. These I would place within the frame,
> most likely the header (top horizontal of the frame). These links would
> reference separate html files, ie v9.0, Indonesian, etc.
>
> As for the initial html version of the 9.1 Handbook, it is finished
> barring edits to content such as have been mentioned in prior emails.
> Further improvements to all html handbook versions, such as to add the
> paged/flat toggle, or version and language links, have yet to be made.
> Those updates will be made available when complete.
>
> As for the wiki providing access to a 'published' static version, it can
> be done. It is very definitely possible to add a modifier to the structure
> of the wiki that would separate it from the dynamic/edited version, and
> pages can be toggled 'protected' which would remove edit capability.  I am
> not an expert in this, but with some research, I believe it could be
> accomplished.
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.pcbsd.org/pipermail/testing/attachments/20130104/ebfecf06/attachment.html>


More information about the Testing mailing list