/dev/api: Improve semantics of param markup and tweaks styles.

The style changes should make it easier to match param names to
descriptions, especially with multi-line descriptions.
This commit is contained in:
Neil Williams
2012-11-25 19:06:25 -08:00
parent e99a34c36b
commit 01a67579a8
2 changed files with 19 additions and 5 deletions

View File

@@ -5986,10 +5986,24 @@ tr.gold-accent + tr > td {
border-collapse: separate;
border-radius: 3px;
padding: 5px 10px;
border-spacing: 0;
width: 100%;
}
.api-help .parameters .name {
.api-help .parameters th,
.api-help .parameters td {
vertical-align: top;
border-bottom: 1px dotted #ccc;
padding: 5px 0;
margin: 0;
}
.api-help .parameters tr:last-child th,
.api-help .parameters tr:last-child td {
border: none;
}
.api-help .parameters th {
font-family: 'Courier New', monospace;
width: 50%;
}

View File

@@ -186,16 +186,16 @@
%if params:
%for param in sorted(params):
<tr>
<td class="name">${param}</td>
<td class="desc">${params[param]}</td>
<th scope="row">${param}</td>
<td>${params[param]}</td>
</tr>
%endfor
%endif
%if base_params:
%for param in sorted(base_params):
<tr class="base-param">
<td class="name">${param}</td>
<td class="desc">${base_params[param]}</td>
<th scope="row">${param}</td>
<td>${base_params[param]}</td>
</tr>
%endfor
%endif