Docs

[Johannes Schönberger]

Hi,

I had some spare time today and made this new design 
concept: https://www.dropbox.com/s/hful1w3vso3achp/skimage%20website.zip

The code highlighting and the logo have not been integrated yet, so the 
navbar design is also not final. Does anyone have the original file of the 
logo?

Tell me, what you think about it.

Regards,

Johannes


Am Montag, 1. Oktober 2012 16:43:04 UTC+2 schrieb Tony S Yu:
>
> Hi Johannes,
>
> Forwarding to the list; I hope you don't mind.
>
> On Mon, Oct 1, 2012 at 3:55 AM, Schönberger Johannes <
> hannessch... at gmail.com <javascript:>> wrote:
>
>> Hi,
>>
>> great you released 0.7. Lately I changed the font size of the 
>> documentation. Although there are some deficiencies with the docs:
>>
>> 1. images in the gallery are too wide: 
>> http://scikits-image.org/docs/dev/auto_examples/plot_polygon.html
>
>
>
> Arrgh. Unfortunately, the docs rely on figures being a certain size (or 
> less) in order to fit on the page. That page size was specified relative to 
> the font size (which changed recently). So the image sizes didn't change 
> (as far as I can tell), but the page width shrank.
>
> Really, we should just set the stylesheet to cap the image size (as 
> Andreas suggested months ago in some PR).
>  
>
>> 2. homepage size not consistent with the rest
>>
>
> Indeed. I believe you have a PR to fix this ;) Sorry, it's been ignored 
> for so long.
>  
>
>> 3. the updated API reference lists a lot of duplicates. I think, it is 
>> sufficient to list "subpackage.function" and leave out the 
>> "subpackage.file.function". My guess is that Sphinx 1.1.X caused this new 
>> behavior.
>>
>
> Hmm, I'm not sure what could have changed this. Note that the duplicates 
> appear in `doc/source/api/api.txt`, which is generated by some combination 
> of apigen.py, docscrape.py, docscrape_sphinx.py, and numpydoc.py in 
> `doc/tools/` and `doc/ext/`. My guess is that the problem was caused by a 
> change to one of these files. I'm not sure where exactly.
>
>
> -Tony
>  
>
>>
>> Regards,
>>
>> Johannes Schönberger
>>
>>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/scikit-image/attachments/20121001/10f7ffd1/attachment.html>