docbook-apps

  • 1.  Accented characters in HTML documentation

    Posted 09-20-2023 19:47
      |   view attached
    We are trying to make Github automatically generate the HTML documentation
    for MobilityDB-workshop
    https://github.com/MobilityDB/MobilityDB-workshop
    using the following workflow
    https://github.com/MobilityDB/MobilityDB-workshop/blob/master/.github/workflows/generate_docs.yml

    In the resulting HTML on Github Pages
    https://mobilitydb.github.io/MobilityDB-workshop/
    the accentuated characters have been replaced by ?

    When generating in my local machine the documentation using the same command
    xsltproc --stringparam html.stylesheet "docbook.css" --xinclude -o
    index.html /usr/share/xml/docbook/stylesheet/docbook-xsl/html/chunk.xsl
    mobilitydb-workshop.xml
    the characters are correct as shown in the following screenshot

    [image: image.png]

    Any idea how to solve this?

    Thanks in advance

    ------------------------------------------------------------
    Prof. Esteban Zimanyi
    Department of Computer & Decision Engineering (CoDE) CP 165/15
    Universite Libre de Bruxelles
    Avenue F. D. Roosevelt 50
    B-1050 Brussels, Belgium
    fax: + 32.2.650.47.13
    tel: + 32.2.650.31.85
    e-mail: esteban.zimanyi@ulb.be
    Internet: http://cs.ulb.ac.be/members/esteban/
    ------------------------------------------------------------



  • 2.  Re: [docbook-apps] Accented characters in HTML documentation

    Posted 09-20-2023 20:17
    On 20.09.2023 21:47, Esteban Zimanyi wrote:
    > In the resulting HTML on Github Pages
    > https://mobilitydb.github.io/MobilityDB-workshop/
    > the accentuated characters have been replaced by ?
    >
    > Any idea how to solve this?

    Most likely this is encoding issue. For legacy reasons DocBook
    stylesheets use ISO-8859-1 encoding whereas most current web serves
    expect that you upload content in UTF-8 encoding. Encoding can be easily
    changed, see http://www.sagehill.net/docbookxsl/OutputEncoding.html

    --
    ------------------------------------------------------------------
    Jirka Kosek e-mail: jirka@kosek.cz http://xmlguru.cz
    ------------------------------------------------------------------
    Professional XML and Web consulting and training services
    DocBook/DITA customization, custom XSLT/XSL-FO document processing
    ------------------------------------------------------------------
    Bringing you XML Prague conference http://xmlprague.cz
    ------------------------------------------------------------------