Hi Ramiro,
> Belated +1 to this -- Great finding and fix Luke.
>
> But it seems this is affecting styling of locally generated builds of
> the HTML version of the docs.
>
> Fon an example see (from tutorial part #1) http://i.imgur.com/CQrjo.png
>
> Compare that with:
>
> https://docs.djangoproject.com/en/dev/intro/tutorial01/
>
> There are a lot of other bulleted (and numbered?) lists in our docs that sport
> the same green vertical bar at the left as the two-elements one at the top
> of that page.
>
> Looking at the ReST documentation[1] it seems the indentation we use for
> such lists are non-conventional and would explain this.
>
> Can anybody confirm this?. If so, we have a bunch of documentation
> .txt files to tweak.
As Carl pointed out, these are caused by the blockquote element inserted
whenever the list is indented by 1 or more characters (as per ReST
specification). It also applied to other things.
I thought I had fixed all the instances of this when I committed my
patch. However, I'm not sure exactly how, but I think I must have been
caught out by cached Sphinx build files, as I only got a minority of
them when I grepped for them - there were several hundreds more! I might
not have attempted this if I had correctly counted at the beginning...
but anyway, I've fixed them all now (hopefully!).
It seems we were relying on this hack in *lots* of places, not just in
the docs that originated from Jacob's import of docs.
> (also, if/when we fix this we should verify that we don't break the stylin
> of the affected parts in the docs.djangoproject.com)
There is currently a problem with docs.djangoproject.com in that it
doesn't display blockquotes visibly at all. There are 4 places in our
docs that have genuine blockquotes, but you can't see where the
quotation finishes due to lack of styling. I've sent Jacob a pull
request for this already, to bring it inline with offline docs. (This is
also the reason why we didn't see the hundreds of instances of
blockquote in the docs on docs.djangoproject.com).
Luke
--
O'REILLY'S LAW OF THE KITCHEN
Cleanliness is next to impossible.
Luke Plant || http://lukeplant.me.uk/
--
You received this message because you are subscribed to the Google Groups
"Django developers" group.
To post to this group, send email to django-developers@googlegroups.com.
To unsubscribe from this group, send email to
django-developers+unsubscr...@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/django-developers?hl=en.
