|
1 | 1 | """ |
2 | 2 | A module for finding, managing, and using fonts across platforms. |
3 | 3 |
|
4 | | -This module provides a single:class:`FontManager` instance that can |
5 | | -be shared across backends and platforms. The:func:`findfont` |
| 4 | +This module provides a single `FontManager` instance that can |
| 5 | +be shared across backends and platforms. The `findfont` |
6 | 6 | function returns the best TrueType (TTF) font file in the local or |
7 | | -system font path that matches the specified:class:`FontProperties` |
8 | | -instance. The:class:`FontManager` also handles Adobe Font Metrics |
| 7 | +system font path that matches the specified `FontProperties` |
| 8 | +instance. The `FontManager` also handles Adobe Font Metrics |
9 | 9 | (AFM) font files for use by the PostScript backend. |
10 | 10 |
|
11 | 11 | The design is based on the `W3C Cascading Style Sheet, Level 1 (CSS1) |
@@ -569,29 +569,29 @@ class FontProperties: |
569 | 569 | <http://www.w3.org/TR/1998/REC-CSS2-19980512/>`_ font |
570 | 570 | specification. The six properties are: |
571 | 571 |
|
572 | | -- family: A list of font names in decreasing order of priority. |
573 | | -The items may include a generic font family name, either |
574 | | -'serif', 'sans-serif', 'cursive', 'fantasy', or 'monospace'. |
575 | | -In that case, the actual font to be used will be looked up |
576 | | -from the associated rcParam. |
| 572 | + - family: A list of font names in decreasing order of priority. |
| 573 | + The items may include a generic font family name, either |
| 574 | + 'serif', 'sans-serif', 'cursive', 'fantasy', or 'monospace'. |
| 575 | + In that case, the actual font to be used will be looked up |
| 576 | + from the associated rcParam. |
577 | 577 |
|
578 | | -- style: Either 'normal', 'italic' or 'oblique'. |
| 578 | + - style: Either 'normal', 'italic' or 'oblique'. |
579 | 579 |
|
580 | | -- variant: Either 'normal' or 'small-caps'. |
| 580 | + - variant: Either 'normal' or 'small-caps'. |
581 | 581 |
|
582 | | -- stretch: A numeric value in the range 0-1000 or one of |
583 | | -'ultra-condensed', 'extra-condensed', 'condensed', |
584 | | -'semi-condensed', 'normal', 'semi-expanded', 'expanded', |
585 | | -'extra-expanded' or 'ultra-expanded' |
| 582 | + - stretch: A numeric value in the range 0-1000 or one of |
| 583 | + 'ultra-condensed', 'extra-condensed', 'condensed', |
| 584 | + 'semi-condensed', 'normal', 'semi-expanded', 'expanded', |
| 585 | + 'extra-expanded' or 'ultra-expanded'. |
586 | 586 |
|
587 | | -- weight: A numeric value in the range 0-1000 or one of |
588 | | -'ultralight', 'light', 'normal', 'regular', 'book', 'medium', |
589 | | -'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', |
590 | | -'extra bold', 'black' |
| 587 | + - weight: A numeric value in the range 0-1000 or one of |
| 588 | + 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', |
| 589 | + 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', |
| 590 | + 'extra bold', 'black'. |
591 | 591 |
|
592 | | -- size: Either an relative value of 'xx-small', 'x-small', |
593 | | -'small', 'medium', 'large', 'x-large', 'xx-large' or an |
594 | | -absolute font size, e.g., 12 |
| 592 | + - size: Either an relative value of 'xx-small', 'x-small', |
| 593 | + 'small', 'medium', 'large', 'x-large', 'xx-large' or an |
| 594 | + absolute font size, e.g., 12. |
595 | 595 |
|
596 | 596 | The default font property for TrueType fonts (as specified in the |
597 | 597 | default rcParams) is :: |
|