Improper indentation for docs/ref/contrib/admin/index.txt
In docs/ref/contrib/admin/index.txt, the attributes for ModelAdmin aren't indented. The effect in the resulting HTML is that <dt>
elements are created with no <dd>
elements. Instead, there is an empty <dt>
, the enclosing <dl>
is terminated and the definition appears in the following <p>
. For InlineModelAdmin, the markup is correct, but the styling indents the dt, which I guess looks ugly to some.
Both problems are addressed by modifying djangoproject CSS so that <dt>
does not appear indented, and also to fix the markup so that <dt>
s are populated. I'll do so once we establish a way to update djangoproject's css (discussion at http://groups.google.com/group/django-developers/browse_thread/thread/2d14c16358069b37).
Change History
(5)
milestone: |
→ 1.3
|
Owner: |
changed from Greg Turner to Gabriel Hurley
|
Status: |
new → assigned
|
Summary: |
Indents for descriptions of documentation attributes → Improper indentation for docs/ref/contrib/admin/index.txt
|
Triage Stage: |
Unreviewed → Accepted
|
Resolution: |
→ fixed
|
Status: |
assigned → closed
|
I've noted it on other tickets before, but this is a reST markup problem, not a CSS problem. Basically, it's a lack of proper indentation in the file such that the
<dd>
elements aren't created. There are a lot of older chunks of the docs that have this problem.When the markup is correct the indentation of the elements is also correct. I prefer fixing the markup (the real problem) to applying CSS hacks to correct for bad markup.
I'm changing this ticket to be about fixing the markup in that file, and will commit the fix to close it momentarily.