Blame Manuals/Tcar-ug/Repository/History/2011.docbook

88dd17
<sect1>
88dd17
88dd17
    <title>2011's</title>
88dd17
88dd17
    <para>
88dd17
        Around 2011, the <command>centos-art.sh</command> script was
88dd17
        redesigned to start translating XML-based files (e.g., SVG and
88dd17
        Docbook files) through <command>xml2po</command> program and
88dd17
        shell scripts (e.g., Bash scripts) through GNU gettext tools.
88dd17
        This configuration provided a stronger localization interface
88dd17
        for graphic designers, translators and programmers. The SED
88dd17
        replacement files are no longer used to handle localization.
88dd17
    </para>
88dd17
88dd17
    <para>
88dd17
        The <function>render</function>, <function>help</function> and
88dd17
        <function>locale</function> functionalities were consolidated
88dd17
        as the most frequent tasks performed inside the repository.
88dd17
        Additionally, the prepare and tuneup functionalities are also
88dd17
        maintained as useful tasks.
88dd17
    </para>
88dd17
88dd17
    <para> 
88dd17
        In the documentation area, support for producing localized
88dd17
        transformations of DocBook XML DTD instances was added through
88dd17
        the <function>render</function> and locale functionalities.
88dd17
        The <function>render</function> functionality uses the
88dd17
        xsltproc command-line XSLT parser in
88dd17
        conjunction with the styles provided by the
88dd17
        <package>docbook-style-xsl</package> package, both of them
88dd17
        included inside The CentOS Distribution.  The locale
88dd17
        functionality creates the localized portable object
88dd17
        (PO) the <function>render</function>
88dd17
        functionality needs to produce localized transformations of
88dd17
        DocBook XML DTD instances.  
88dd17
    </para> 
88dd17
88dd17
    <para>
88dd17
        To build DocBook documentation, it was considered the idea of
88dd17
        using concepts behind repository directory structure as base,
88dd17
        not the opposite (as I've been doing with Texinfo backend, so
88dd17
        far).
88dd17
    </para>
88dd17
88dd17
    <para>
88dd17
        Producing documentation through DocBook XML as default
88dd17
        documentation backend consolidates <function>render</function>
88dd17
        and <function>locale</function> even more.  In this
88dd17
        configuration, once the DocBook files are written, you use
88dd17
        <function>locale</function> functionality to localize the
88dd17
        DocBook files in your prefered language and later, using
88dd17
        <function>render</function> functionality, you produce the
88dd17
        XTHML and PDF outputs as specified in a XSLT or DSL
88dd17
        customization layer.
88dd17
    </para>
88dd17
88dd17
</sect1>