Re: [cclib-devel] New docs theme

[Karol L. <kar...@gm...>]

I resolved the ghpages issue, so the new theme is also online at
cclib.github.io
Still, let me know what you think.

- Karol

On Sat, Apr 19, 2014 at 12:14 PM, Karol Langner <kar...@gm...>wrote:

> Hi guys,
>
> When we talked about the future of cclib's documentation some time ago,
> Read The Docs came up. I don't think it's the best place to place cclib's
> documentation, simply because we have so little documentation in the code,
> and so much static text. The things we do want to generate automatically
> (attribute tables) we need to do programmatically anyway.
>
> However, I do like the theme they have over at Read the Docs. It's much
> more easy to use than the default Sphinx theme. So for v1.2 that's coming
> up I've given it a try -- added another repo for cclib with the theme. The
> only thing I chnaged for now if the CSS max-width to 100%, so that our wide
> tables are not squezzed on large screens. We can tweak a couple other such
> details, but I don't think any major changes are needed.
>
> The github pages are not accepting the changes for some reason (I have
> contacted their support), but here are the docs with the new look at a
> temporary location:
> http://mmqc.org/~kml/tmp/cclib.github.io/
>
> Just let me know whether you like it. If not, I can revert to the default
> theme.
>
> Karol
>