[Docutils-checkins] SF.net SVN: docutils:[9498] trunk/docutils

[<mi...@us...>]

Revision: 9498
          http://sourceforge.net/p/docutils/code/9498
Author:   milde
Date:     2023-12-06 20:48:52 +0000 (Wed, 06 Dec 2023)
Log Message:
-----------
New CSS stylesheet for italic field names in field-lists.

The current default are bold field names.
However, in many contexts bold names are too heavy.

The additional stylesheet is a backwards-compatible way to
get better looking documentation. See docutils.conf for usage.

Modified Paths:
--------------
    trunk/docutils/docutils/writers/html5_polyglot/responsive.css
    trunk/docutils/docutils.conf

Added Paths:
-----------
    trunk/docutils/docutils/writers/html5_polyglot/italic-field-names.css

Added: trunk/docutils/docutils/writers/html5_polyglot/italic-field-names.css
===================================================================
--- trunk/docutils/docutils/writers/html5_polyglot/italic-field-names.css	                        (rev 0)
+++ trunk/docutils/docutils/writers/html5_polyglot/italic-field-names.css	2023-12-06 20:48:52 UTC (rev 9498)
@@ -0,0 +1,26 @@
+/* italic-field-name.css: */
+/* Alternative style for Docutils field-lists */
+
+/* :Copyright: © 2023 Günter Milde. */
+/* :License: Released under the terms of the `2-Clause BSD license`_,      */
+/*    in short:                                                            */
+/*                                                                         */
+/*    Copying and distribution of this file, with or without modification, */
+/*    are permitted in any medium without royalty provided the copyright   */
+/*    notice and this notice are preserved.                                */
+/*                                                                         */
+/*    This file is offered as-is, without any warranty.                    */
+/*                                                                         */
+/* .. _2-Clause BSD license: http://www.spdx.org/licenses/BSD-2-Clause     */
+
+/* In many contexts, a **bold** field name is too heavy styling. */
+/* Use *italic* instead:: */
+
+dl.field-list > dt {
+  font-weight: normal;
+  font-style: italic;
+}
+dl.field-list > dt > .colon {
+  font-style: normal;
+  padding-left: 0.05ex;
+}


Property changes on: trunk/docutils/docutils/writers/html5_polyglot/italic-field-names.css
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: svn:keywords
## -0,0 +1 ##
+Author Date Id Revision
\ No newline at end of property
Modified: trunk/docutils/docutils/writers/html5_polyglot/responsive.css
===================================================================
--- trunk/docutils/docutils/writers/html5_polyglot/responsive.css	2023-12-06 20:48:38 UTC (rev 9497)
+++ trunk/docutils/docutils/writers/html5_polyglot/responsive.css	2023-12-06 20:48:52 UTC (rev 9498)
@@ -131,6 +131,10 @@
 
 /* Lists */
 
+dl.field-list.narrow, dl.docinfo, dl.option-list {
+  --field-indent: 2.4em;
+}
+
 ul, ol {
   padding-left: 1.1em; /* indent by bullet width (Firefox, DejaVu fonts) */
 }
@@ -389,9 +393,6 @@
   body {
     --field-indent: 4em;
   }
-  dl.field-list.narrow, dl.docinfo, dl.option-list {
-    --field-indent: 2.4em;
-  }
   pre, pre * {
   font-size: 0.9em;
   /* overflow: auto; */

Modified: trunk/docutils/docutils.conf
===================================================================
--- trunk/docutils/docutils.conf	2023-12-06 20:48:38 UTC (rev 9497)
+++ trunk/docutils/docutils.conf	2023-12-06 20:48:52 UTC (rev 9498)
@@ -16,7 +16,7 @@
 math-output: MathML
 # MathML will become the default for HTML5 in Docutils 0.22
 stylesheet-dirs: docutils/writers/html5_polyglot/
-stylesheet-path: minimal.css, responsive.css
+stylesheet-path: minimal.css, responsive.css, italic-field-names.css
 section-self-link: yes
 table-style: colwidths-grid
 

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.