Thanks so much Frank! I had read about nojekyll but did not understand that it would effect us - good debugging! I have pushed up an initial conversion of walkthrough 2, and will get back to fixing images this weekend.
Exciting! -- Jody Garnett On Wednesday, 20 June 2012 at 5:14 PM, Frank Gasdorf wrote: > Hello everybody! > > Yesterday night I generated the html pages with sphinx after some > content improvements and structure updates. After that I deployed the > content to udig.github.com/user (http://udig.github.com/user) (which was a > push to the > https://github.com/uDig/udig.github.com/tree/master/user). > > I hoped that we could use github for doc hostings but unfortunately, > with limited success :( > > ... > > The pages were not displayed correctly because of missing images and > styling stuff. I thought there should be a way to get it working and > found a page about github pages : > https://help.github.com/categories/20/articles > > There seems to be a pre processing step after a push occurred on that > repository master branch. That read I added .nojekyll (see > https://help.github.com/articles/files-that-start-with-an-underscore-are-missing) > file to the root folder and everything looks fine right now. The > reason was that the pre-process doesn't handle folders starting with > an underscore (e.g. _images, _styles, etc). > > > PLEASE note : the current deployment is a draft we can talk about. > Jody is trying some improvements for the user docs conversion from > confluence. Afterwards we will add some entry points for the user docs > as well. > > > Please have a look at http://udig.github.com/user/ > > and the geoserver-install page : > http://udig.github.com/user/getting_started/geoserver/index.html > > were I added > .. note:: and .. hint:: directives > > whereas in > http://udig.github.com/user/getting_started/walkthrough1/ImportDirectlytoTheCatalog.html > > you can find .. sidebars:: > > > What do you think about sidebars. Would you prefer having admonitions > like note, warning, hint or even danger with different styles to > emphasize. > > IMHO like the admonitions because of the different styling capability > and after reading some blogs its much better to handle admonitions for > pdf generation (and properly some other document types). > > > Happy reading, > Frank > _______________________________________________ > User-friendly Desktop Internet GIS (uDig) > http://udig.refractions.net > http://lists.refractions.net/mailman/listinfo/udig-devel > >
_______________________________________________ User-friendly Desktop Internet GIS (uDig) http://udig.refractions.net http://lists.refractions.net/mailman/listinfo/udig-devel
