RFC: docs website layout demo

[Jeff Fearn]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 10/10/2014 08:30 PM, Jeffrey Fearn wrote:
> Hi, Rudi asked me to do a demo of how Fedora could make a rebuilt docs website look, so I've made a demo site & tweaked it a bit. Before I spend too much effort on it I thought I'd open it up for input.
> 
> I wanted to get a bit more done before the weekend, but time slipped away. I wanted to get it out for some feedback over the weekend so I can do some more on Monday, so I'd thought I'd just put it out there and hope
> people can understand it is only half baked.
> 
> Some of the stuff I did for this I liked so I've started migrating the template changes back in to publican, leaving this site with just some colour changes on what a default web_style 2 site will look like. I'll
> update my fedora people site next week so show what a default site will look like.
> 
> I've made a script to pull out most of the docs packages from git, and run through a bunch of branches per book, and try to build them with the latest publican. I'll make the script available next week for people who
> want to build their own copy. It should be useful to QA the process as it spits out a log file out for each repo and branch so you can get a good list of what's broken and what's not. I'll also put those up on my
> fedora people site next week ... If I have any quota left :D

I've pushed this on to the demo site [1], comments at the top hold the instructions.

It needs tweaks to docsite-publican, hope to get those committed soon.

It also needs Fedora_Splash which contains the blurb on the Fedora products page and the groupings, not sure what to do about that.

It will still work without those things, it just won't look exactly the same.

> Demo site is https://jfearn.fedorapeople.org/fdocs/en-US/index.html
> 
> I think this is a pretty good layout https://jfearn.fedorapeople.org/fdocs/en-US/index.html#Fedora
> 
> Colours are hard :-/
> 
> Note if you click a group, below the versions, then it filters out all the other groups.
> 
> Note that in the "System administration" group for Fedora 20 there is an external link "The Ways And Means Of Pants" which is a fake URL, if you have a couple of examples of real external links you'd like in that
> group, or any other group, I'd be happy to swap out the fake one.
> 
> I haven't changed the brand XSL for the html payload, I'd like to remove the old left and right logos at the top of the pages. They aren't really needed given the menu content.
> 
> e.g. https://jfearn.fedorapeople.org/fdocs/en-US/Fedora/20/html/Installation_Guide/index.html
> 
> bah I just noticed a bug on that page,  the first two items in the navigation menu are swapped ... :(
> 
> I'm sure there are lots more :}
> 
> I've built html, html-single, epub & pdf.
> 
> The site is only in en-US, it's 417M and I'm not sure the hosting people would be happy if I hosted more languages :)
> 
> Anyway, it's Friday evening and the wine is calling, please reply if you have any ideas or feedback, beware that I'm currently hacking on the publican devel branch, so I might steal any really cool ideas for
> publican.next ;)
> 
> Cheers, Jeff.
> 
> P.S. All the RSS feeds on there should work, but you probably do not want to sign up for that site!
> 

Cheers, Jeff.

1: https://jfearn.fedorapeople.org/fdocs/rebuild_site.sh

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1

iQEcBAEBAgAGBQJUO3KBAAoJELs3R4zxGZvK2x8H/jsXi5Jf3Ii5vjNTFtBMT9X8
mOg5BEueahXqiVQcsCpVHKxoEG5EcqSOyb6YQqd3pf/1GnxEr+yeBWT6NMng3i1+
GzgWytTZI6JVAwvGAT5GPRNfTzNjx1IEP+7Cbh8xgqc5NVLdgKq1VJLUMA5cWJUc
qUSf9zCTPSd97VkQyNG+q/lZyLK+UiJBJvhw9or0qCMqDCqV+63SE+FtZJy0yFO4
Tma1rIY5XjDwzP7Os+nDB8m6O78ytA+/NZgf/AoSrCVUSgfWrK6SYKRPtn91HmyZ
3Bsil98C1Dnd0ZEUFtHhvNJskKA5SR8C6YXGel+t9+TgWA+77yW8Q92qn0cCT4c=
=4hBA
-----END PGP SIGNATURE-----