doc/svghmi/fonts.rst
changeset 3936 129202e555e0
parent 3925 1d383b4c0a23
equal deleted inserted replaced
3932:62d04933d569 3936:129202e555e0
     1 Include fonts in HMI
     1 Include fonts in HMI
     2 ====================
     2 ====================
     3 
     3 
     4 Inkscape uses system fonts
     4 Text inside HMI designed with Inkscape may not display properly in web browser.
     5 --------------------------
     5 The reason is that Inkscape and targeted web browser may disagree on fonts support.
     6 
     6 
     7 Supported font types
     7 To keep HMI text design consistent, missing fonts can be added to project in order
     8 --------------------
     8 to have them served together with HMI so that web browser can support them.
       
     9 
       
    10 Fonts used by Inkscape
       
    11 ----------------------
       
    12 
       
    13 * System fonts
       
    14 
       
    15     Vector fonts available at system level are systematically available
       
    16     in Inkscape
       
    17 
       
    18 * User fonts
       
    19 
       
    20     When selected in Inkscape preferences, Inkscape also considers fonts
       
    21     from these sources:
       
    22 
       
    23     - "fonts" directory in Inkscape user's directory
       
    24 
       
    25     - arbitrary absolute font directories set by user 
       
    26 
       
    27     There is no way to point to a directory relative to the SVG file
       
    28     being edited.
       
    29     At the time of writing this documentation, Inkscape doesn't support
       
    30     embedding font in SVG file.
       
    31 
       
    32     User then have to regularly update Inkscape preferences to ensure
       
    33     that fonts used in currently edited design are available when editing
       
    34     it.
       
    35 
       
    36 
       
    37 Supported font types in SVGHMI
       
    38 ------------------------------
       
    39 
       
    40     * Web Open Font Format 1 and 2
       
    41 
       
    42         ``.woff```, ``.woff2``
       
    43 
       
    44     * TrueType fonts
       
    45 
       
    46         ``.ttf``
       
    47 
       
    48     * OpenType fonts
       
    49 
       
    50         ``.otf``
       
    51 
       
    52     .. note:: 
       
    53 
       
    54         In order to be embedded in HMI, fonts are encoded base64 
     9 
    55 
    10 Add/remove fonts
    56 Add/remove fonts
    11 ----------------
    57 ----------------