Git Product home page Git Product logo

suse-xsl's Introduction

SUSE XSL Stylesheets

This project contains customization layers for the DocBook XSL stylesheets.

1. Requirements for use

2. Using the stylesheets with daps

In case you want to use the latest stylesheet from the main branch (and not the one that are installed on your system), proceed as follows:

  1. Clone this repo if you haven’t done yet.

  2. Memorize the path to your repo. In this procedure, we use the placeholder SUSEXSL_REPO.

  3. Copy the following lines into your ~/.bashrc file. Don’t forget to replace <SUSEXSL_REPO> with the path to your cloned repo from the previous step.

    dapsxsl ()
    {
        local styleroot="<SUSEXSL_REPO>/suse2022-ns/";
        daps --styleroot=$styleroot $*
    }
  4. Open a new shell.

  5. Use the dapsxsl command instead of daps to use the stylesheets from this repo.

3. Building

3.1. Requirements

These stylesheets can be used as-is for DocBook 4 content. To use them with DocBook 5 content, build them with make. For a successful build, you will need:

  • standard GNU utilities (cat, sed, tar, …​)

  • trang

  • xsltproc

  • xmlcatalog

  • aspell

For the sass-css target:

  • sassc (openSUSE’s RPM-packaged version is good enough). For details, see sass README

3.2. Creating a build

  • After changes to the SASS code: regenerate the suse2021 and suse2022 CSS: make sass-css

  • Create namespaced suse and suse2013 stylesheets: make

4. Requirements for testing

  • dapscompare from Documentation:Tools

5. Running tests

Note
The dapscompare test utility never left the beta state and does not have a maintainer currently.

The current tests are not run automatically and need some manual intervention for use. They are based upon creating reference images of test documents, making a code change and then creating updated images of the test documents. Then, you can compare the updated images to the reference images.

On the command line, do the following:

  1. In the first invocation, run ./run_dapscompare.sh reference (from the tests/ directory). This will create reference images, that is the baseline from which you can judge if what you did was correct or not).

  2. Perform the stylesheet changes.

  3. Now run ./run_dapscompare.sh (without any arguments) again. This will create the comparison images. If there are changes between reference and comparison images, those will be shown to you in a GUI.

The reference images are currently not stored centrally: They differ somewhat, depending on, for example, font rendering settings between different computers.

6. Creating a new release

To create a new release, do the following steps:

  1. Make sure everything you want to include is in the main branch.

  2. Run the versionbump command with your next version:

    ./versionbump <NEXT_VERSION>
  3. Answer the questions from the script. Confirm with typing y or type n to skip this question.

    1. Set your version number.

    2. Add a change log entry. You should always create one for each new version.

    3. Accept to let the script create a commit and a tag.

  4. Switch to suse-xsl release and make a release.

suse-xsl's People

Contributors

cwickert avatar dimstar77 avatar fsundermeyer avatar ggayathri3 avatar inflationsbereinigt avatar janajaeger avatar jsetz11 avatar taroth21 avatar tomschr avatar vogtinator avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

suse-xsl's Issues

Make output dir for EPUB relative to $base.dir [sf#134]

From @tomschr on March 3, 2015 14:2

Reported by tom_schr on 2013-02-26 16:20 UTC
At the moment, $base.dir is not really correctly implemented IMHO.

It is set to the "OEBPS/" string by default. This is very annoying as you set $base.dir to an absolute path and create all the files in it. You have to change the directory before applying the stylesheets (as the Ruby dbtoepub script does).

TODO: Make all the parameters which rely on output directory or filenames relative to $base.dir ($img.src.path, $admon.graphics.path, $callout.graphics.path, etc.)

Copied from original issue: openSUSE/daps#134

Final Message Does Not Match With Generated JSP Files [sf#87]

From @tomschr on March 3, 2015 12:35

Reported by tom_schr on 2012-07-18 06:43 UTC
Building the JSP output gives me the following output (example for SUSE Manager):

Writing /local/doc/opensuse-doc/documents/susemanager/en/build/susemanager-reference/jsp/susemanager-reference/reference/en-US/cha.manager.glossary.jsp for glossary(cha.manager.glossary)
Writing /local/doc/opensuse-doc/documents/susemanager/en/build/susemanager-reference/jsp/susemanager-reference/reference/en-US/index.jsp for book(book.susemanager.ref)

However, the final message locates the book in a different place:

Find the JSP book at:
/local/doc/opensuse-doc/documents/susemanager/en/build/susemanager-reference/jsp/susemanager-reference/index.jsp

Copied from original issue: openSUSE/daps#87

Make productname/productnumber Inheritable

Currently, productname and productnumber has to be included in book and article. This is ok, but if you have a set of books or articles, it would be convenient to add this information only once into setinfo.

The following rules should be applied:

  • When creating a book, look for a bookinfo with productname and productnumber. If found use it.
  • When creating an article look for a articleinfo with productname and productnumber. If found use it.
  • If productname and productnumber cannot be found, use the parent element:
    • for an article, look inside book/bookinfo
    • for a book, look inside set/setinfo
  • If still no productname and productnumber can be found, display an error/warning message.

SUSE branding: Hyphenation of URLs (Zero Width Space) [sf#33]

From @tomschr on March 3, 2015 11:47

Reported by tom_schr on 2012-02-03 14:50 UTC
The parameter ulink.hyphenate is used to allow URLs to be hyphenated automatically. Usually it is set Zero Width Space (ZWS, U+200B). This ZWS is included in certain positions (like before '/' or '-') to mark a hyphenation possibility. The complete URL is set to hyphenate=false to avoid breaking it in the middle of a word.

However, it does not work for FOP as advertised. It is creates overly long spaces like this:

 | The quick brown fox jumps over the lazy dog. See /usr/share/doc/ |
 | packages/lazy-dog/README.                              for more  |
 | information.

For the time being, ulink.hyphenate is set to '' for FOP. Other formatters get their ZWS.
Marking this ticket as 'pending'. It "works", but it looks not nice. Maybe future versions of FOP can improve this situation.

See also https://bugzilla.novell.com/show_bug.cgi?id=706452

Copied from original issue: openSUSE/daps#33

Wrong company name in PDF documentations

Hi,

if you create a PDF documentation with

daps -vv -d DC-SLE-RT-shielding pdf

the documentation contains a wrong company name:

SUSE Linux Products GmbH

I think this is a stylesheet problem.

Implement SVG cleaner to get semi-correct output in PDFs with FOP [sf#213]

From @tomschr on March 3, 2015 17:56

Reported by sknorr on 2013-12-18 15:28 UTC
We need some way to reliably get SVGs into DAPS-created PDFs.

Converting SVGs to PDFs first and then embedding those PDFs into the final output PDFs is clearly not an option (because PDF embedding is even more buggy than SVG embedding). We should find a way to convert SVGs to a maximally compatible subset of tags.

  • Remove special Inkscape tags
  • Replace FlowRoot with Text
  • Maybe even replace gradients (or at least use a simpler method to re-create them, as Inkscape uses some sort of intra-document links for this sort of thing which quite likely not every application understands)

Copied from original issue: openSUSE/daps#212

Style for <package/>

Needs to be done... output is <span class="package">...</span>.

Not sure if PDF is affected.

Use <revhistory> for Documentation Updates

Since DocBook 5, we can use the <revhistory> element to markup our documentation changes. This has some benefits:

  • You can see it straight at the beginning of the file inside <info>
  • You could include the history of changes in each file (chapter wise)
  • The stylesheet takes care of collecting all the information.
  • We can include the "Documentation Updates" topic at the beginning or (usually) at the end
  • We can completely turn it on or off, depending on our wishes.

The lifecycle would be:

  1. Edit your XML file, do whatever you need to do.
  2. When finished, add a revision element and describe your changes.
  3. Make sure you use the correct content in revnumber.

Let's say, we have this XML snippet for <revhistory> in a file:

  <info>
    <revhistory>
      <revision>
        <revnumber>1.1</revnumber>
        <date>2015-07-17</date>
        <revdescription>
          <para>Rewrote section A, B, and D.</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>1.0</revnumber>
        <date>2014-07-17</date>
        <revdescription>
          <para>Added new section ABC</para>
        </revdescription>
      </revision>
    </revhistory>
  </info>

Some rules which needs to be checked if they are applicable:

  • It is recommended to add the latest change(s) as the first child of revhistory. However, this is a pure readability issue and not a technical one.
  • The stylesheets know a parameter use.revnumber which can (and should) be set to a specific revision number (matches the <revnumber> element).
  • During profiling(?) or any other process, all the files within the document are searched for revhistory elements.
  • The stylesheets collects only those revision elements which is equal to $use.revnumber and the content in <revnumber>.
  • The revision elements appear in document order.
  • There are two approaches to include the topic of documentation updates:
    • Use profiling, create an intermediate XML file which contains the correct structure and xinclude it at the correct position.
    • Use an internal process inside the stylesheets to create the structure on the fly.

For example, if we would set $use.revnumber=1.1 only the first entry ("Rewrote section A, B, and D") will be used. The second is discarded and will not appear in the output.

Layout Bug (FO): <term> in Variable List [sf#145]

From @tomschr on March 3, 2015 15:7

Reported by fsundermeyer on 2013-04-04 09:30 UTC

<varlistentry>
 <term>FOO</term>
 <term>BAR</term>
 <listitem>...</listitem>
</varlistentry>

Shows up like this in the PDF:

FOO , BAR

FOO[:space],[:space:][:space:]BAR

Should be

FOO, BAR

FOO,[:space:]BAR

Copied from original issue: openSUSE/daps#145

XRefs: xrefstyle not recognized [sf#206]

From @tomschr on March 3, 2015 17:51

Reported by tom_schr on 2013-12-06 14:36 UTC
The HA guide contains in ha_nfs_quick_config_i.xml a kind of "mini toc" where xrefs are listed in an ordered list.

However, the xrefstyle attribute seems not to be recognized at all. The stylesheets resolve it always as

Section "Defining Authentication Settings, Chapter 3, Installation and Basic Setup, High Availability Guide

With the xrefstyle attribute, the expected output would be:

Section "Defining Authentication Settings"

Fixing it would probably also involve talking to upstream.

Copied from original issue: openSUSE/daps#205

ePUB3 Validation errors [sf#242]

From @tomschr on March 3, 2015 18:4

Reported by fsundermeyer on 2014-10-21 16:31 UTC

Upstream errors:

Token ';' not allowed here, expecting a property value
value of attribute "width" is invalid; must be an integer

  <colgroup>
   <col style="width: ; " class="1"/>
   <col style="width: ; " class="2"/>
   <col style="width: ; " class="3"/>
  </colgroup>

SUSE2013 Errors:

could not parse OEBPS/part.virt.intro.xhtml: duplicate id: part.virt.intro'

 <div class="part" title="Part I. Introduction" epub:type="part" id="part.virt.intro">
 <div class="titlepage"><div><div><h1 class="title" id="part.virt.intro">

This file should declare in opf the property: svg

  ???? 
  <img class="symbol" alt="Note" title="Note" src="static/images/icon-note.svg"/>
   <item id="idm140486407262576" href="static/images/icon-note.svg" media-type="image/svg+xml"/>

OEBPS/toc.ncx fragment identifier is not defined in 'OEBPS/cha.kvm.inst.xhtml'

  <navPoint id="idm140084606559568" playOrder="44">
   <navLabel><text>Memory Ballooning with Windows Guests</text></navLabel>
   <content src="cha.kvm.inst.xhtml#libvirt.advanced.balloon"/>
  </navPoint>

hyperlink to resource outside spine 'OEBPS/xen_master_fong_a.png'
hyperlink to non-standard resource 'OEBPS/kvm_qemu.png' of type 'image/png'

  <div class="figure-contents">
   <div class="mediaobject">
    <a href="xen_master_fong_a.png">
     <img src="xen_master_fong_a.png" width="" alt="Xen Virtualization Architecture"/>
    </a>
   </div>
  </div>

'gloss.vt.lxc.chroot': fragment identifier is not defined in 'OEBPS/gloss.vt.glossary.xhtml'

  <a class="xref" href="gloss.vt.glossary.xhtml#gloss.vt.lxc.chroot" title="chroot">chroot</a>

Copied from original issue: openSUSE/daps#241

Examples with a title have odd top margins

How to reproduce:

  1. Build a book that has examples following this XML structure in it: <example><title/><screen/></example> as HTML
  2. Look at the top margin of such a screen, see that there seems to be an empty line in the screen

This is caused by the title above which is using negative margin trickery. While the negative margin trickery must end anyway, because it leads to bad UX, like text that is not selectable etc., this bug is just fixing about this small symptom.

Investigate OpenCV for Test Suite

Current Problem

At the moment, we don't have any test suite for FO/PDF. This is unfortunate as we do not know when we create a regression, for example, when the FO renderer doesn't find the correct CJK fonts (which leads to # marks throughout the document).

Idea

In theory, we could use OpenCV to create a test driven PDF development cycle. OpenCV is used by the openQA team, written in this article.

The procedure would be:

  1. Create a PDF with the FO stylesheets under test.
  2. Convert the PDF into PNGs or any other image format that is supported by OpenCV.
  3. Specify regions which should be "available" or "correct".
  4. Test this assertion.
  5. Report back the result.

Create Glossary Backlink Definition

Idea discussed with @jcayouette

Let's assume we have a glossary with lots of glossary items (glossentry in DocBook's lingo). Usually, when you create HTML from your DocBook sources, it resolves an glossterm or firstterm in your paragraph and points to the corresponding glossary item. That's easy as it's a 1:1 relationship. So far, so good.

However, sometimes, it is needed to make the reverse: link from the glossary to the first(!) glossterm or firstterm where it's mentioned. This needs a little bit more effort as it's a 1:n relationship.

This can be done with xsl:key efficiently. A first working proof of concept can be found here:
https://gist.github.com/tomschr/e4debf714d2149ede1e8

TODO: Integrate it into the DocBook stylesheets:

  • Add a parameter (let's say glossary.backlink) to param.xsl so we can switch on/off this feature (some don't like it or don't need it).
  • Add the customization into glossary.xsl and the template rule glossentry.

Check Chinese Fonts [sf#156]

From @tomschr on March 3, 2015 15:14

Reported by tom_schr on 2013-05-29 12:50 UTC
The Chinese openSUSE fonts should go to Factory too.

Additionally, check if we could use the openSUSE fonts for SLE too (replace ttf-founder-simplified with wgy-*)

Copied from original issue: openSUSE/daps#156

Show filename and IDs in draft PDF builds [sf#74]

From @tomschr on March 3, 2015 12:32

Reported by fsundermeyer on 2012-05-09 13:42 UTC
Currently this feature only exists for HTML builds when using --remarks or --meta.
We should make this avilable for PDF builds as well - according to tom_schr the
SUSE stylesheets already support it.

Copied from original issue: openSUSE/daps#74

Install susedoc.rnc / move schemas

  • Make sure susedoc.rnc is installed with suse-xsl
  • Install novdoc and susedoc to a common directory /usr/share/xml//suse/ and make sure the catalog entries are adjusted

Make Parameter runinhead.default.title.end.punct L10N Compatible

Currently, the parameter is definied as runinhead.default.title.end.punct='.' by default. This is unfortunate, as other languages needs other characters.

For example, Chinese and Japanese require a double-byte colon character here: () (U+FF1A).

It is probably a good idea to do the same for the parameter runinhead.title.end.punct.

Things to do:

  • Add a key/value pair for all languages in common/l10n/; for example, the en.xml file should contain the following line: <l:gentext key="runinhead.default.title.end.punct" text="."/>
  • Search for the template 'formalpara' in the XSLT stylesheet fo/block.xsl and replace <xsl:value-of select="$runinhead.default.title.end.punct"/> with the code below.
  • Add a new template 'formalpara/title' in the XSLT stylesheet xhtml/block.xsl and copy the code from the original template in /usr/share/xml/docbook/stylesheet/nwalsh/current//xhtml/block.xsl. Adapt the copied code as shown for fo/block.xsl.

Code:

<xsl:call-template name="gentext">
   <xsl:with-param name="key" select="'runinhead.default.title.end.punct'"/>
</xsl:call-template>

PDF: Admonitions are too prominent

Titles of admonitions look too prominent compared to e.g. sect3, especially on b/w printouts.
Removing bold might be enough. Then again, we need to make sure that contrast is good enough on color printouts too.
(Brought up by toms.)

PDF fails to build with saxon and the "ns" (DB5) stylesheets

Error at xsl:stylesheet on line 20 of file:/usr/share/xml/docbook/stylesheet/suse2013-ns/fo/fo.xsl:
Namespace prefix d has not been declared
Transformation failed: Failed to compile stylesheet. 1 error detected.
remake: *** [/data/git/doc-cloud/build/.tmp/susecloud-all-fop_color_en.fo] Error 2

Use colon (":") by default at the end of formalpara titles

Normally, formalparas use dots (".") at the end of the title.
We also have some documentation that (inconsistently) uses colons at the end of formalpara titles (e. g. apps_evolution.xml).

<formalpara>
  <title>Something:</title>
  <para>Something something.</para>
</formalpara>

However, I almost think it would make sense to use colons as the default. And it should be easy too, toms remembered that there was some kind of parameter.

Collecting Information about DocBook 5 [sf#155]

From @tomschr on March 3, 2015 15:14

Reported by tom_schr on 2013-05-28 13:05 UTC
This ticket just collects some information about a migration of our sources and toolchain to DocBook 5.

Overview

DocBook 5.x is the successor of DocBook 4. Any future changes will be integrated into version 5, the former is in maintenance mode.

Changes

There are some changes between DocBook 4 and DocBook 5. Although they are not really difficult, it's important to know. Here are the major changes:

  • DocBook 5 namespace
    All DocBook elements are now bound to a namespace, http://docbook.org/ns/docbook
  • IDs
    Replace the attribute id with xml:id
  • ulink renamed
    Use <link> instead
  • Consolidated *info elements
  • Assembly files (a kind of topic oriented approach), see openSUSE/daps#163

Find more changes at http://docbook.org/tdg51/en/html/ch01.html#introduction-whats-new and http://docbook.org/docs/howto/#changes.

Benefits

  • Flexibility: We can better change the DocBook 5 schema (it's easier to adapt RELAX NG than DTD)
  • New stylesheets will be (probably) support DocBook 5
  • Migration is relatively easy, there is a stylesheet that converts version 4 into version 5, see http://doccookbook.sf.net/html/en/dbc.structure.db4-to-db5.html
  • We can get rid of Novdoc ;)
  • It's the future ;)

Current Situation

DAPS

Currently, DAPS supports validation of DocBook 5 files with jing already.

DTD, Schema

We need to create a special version of Novdoc for DocBook 5; see also openSUSE/daps#179. The primary schema language is RELAX NG (probably the compact version). DTD is derived from the RNC version.

Stylesheets

The current customization doesn't recognize the DocBook 5 namespace.

Migration

Use the stylesheet https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/tools/db4-upgrade.xsl to upgrade your DocBook 4 document.

Copied from original issue: openSUSE/daps#155

Create permalinks for varlistentry

When we set an ID to a variablelist/varlistentry, no permalink is created. It would be useful to propagate the ID into a permalink in HTML.

Parameter for Level of Detail in TOC (and Expansion) [sf#57]

From @tomschr on March 3, 2015 12:23

Reported by taroth21 on 2012-03-23 08:58 UTC
Currently, the number of structure levels visible in both the TOC and the left-hand side TOC for navigation (in PDFs, etc.) is fixed. But to allow for customization, a parameter for the level of detail should be added. That would allow to define the visible section levels individually (e.g. up to sect2, up to sect3 or up to sect5).

Copied from original issue: openSUSE/daps#57

Profiling adds whitespace to screens [sf#193]

From @tomschr on March 3, 2015 17:48

Reported by sknorr on 2013-11-12 16:45 UTC
It seems, DAPS now adds copious amounts of whitespace to certain screens.

E.g. in the SUSE cloud admin guide (File: xml/admin_dashboard.xml +1117), we have this humble screen:

<screen><replaceable>DESTINATION_CIDR</replaceable>,<replaceable>NEXTHOP</replaceable></screen>

Which is turned into this after profiling (File: build/.profiled/p_sles/admin_dashboard.xml +2760)*:

<screen>
                     <replaceable>DESTINATION_CIDR</replaceable>,<replaceable>NEXTHOP</replaceable>
</screen>
  • Note the difference in line numbers!

Copied from original issue: openSUSE/daps#192

daps: Support DocBook 5 in Admin Stylesheets [sf#28]

From @tomschr on March 3, 2015 11:41

Reported by tom_schr on 2012-01-26 19:49 UTC
We have some stylesheets which extracts different information (like image paths, document structure, etc.). These "administrative" stylesheets currently supports DocBook 4 only.

These stylesheets has to be improved to also match for DocBook 5 elements.

Copied from original issue: openSUSE/daps#28

Investigate Syntax Highlighting [sf#217]

From @tomschr on March 3, 2015 17:56

Reported by tom_schr on 2014-01-30 09:52 UTC
Currently, we don't use any syntax highlighting (SH) in our documents. We should think about this, if this is worth to investigate more.

We need two things:

  1. The language attribute inside the elements screen or programlisting.
    The value of language can be anything, it's not limited by DocBook.
  2. A tool which evaluates the language and creates a nice SH.

At the moment, SH in DocBook is done by a Saxon extension from the XSLTHL project. You need to add the JAR file into the classpath and basically it works.

However, XSLTHL has some drawbacks:

  • XSLTHL has limited highlighters
    Only a handful of languages are currently supported in XSLTHL.
  • XSLTHL needs a syntax description in XML
    Partly documented and difficult to find out what's needed and how. Difficult to debug.
  • XSLTHL can't have different styles for different highlighters

Another alternative could be to implement a replacement for xsltproc as a Python script using lxml. That way, we could integrate pygments as SH.

Copied from original issue: openSUSE/daps#216

PDF Layout: Cornercase with a dot within <command/><replaceable> [sf#226]

From @tomschr on March 3, 2015 17:58

Reported by taroth21 on 2014-05-13 14:53 UTC
Our proofreaders spotted a (rare) cornercase in the PDF layout where a discontinued underline in the following command can lead to a misinterpretation of the dot in "package.rpm" as a full stop for the sentence (see attachment, p. 15, proofing comment by Jack):

Normally, the installation of an RPM archive is quite simple:
rpm -ipackage.rpm.

For the source code, see http://svn.opensuse.org/svn/opensuse-doc/trunk/documents/sle/en/xml/rpm.xml, line 111.

In the HTML layout, the whole command is underlined completely (which is correct).

Copied from original issue: openSUSE/daps#225

Stylesheets: Displaying Metadata Information

The new stylesheets should be able to display the following metadata:

  • file name
  • file maintainer
  • doc status
  • ID
  • "last changed" date for the file
  • URL to the document (SVN or GitHub), see --repository

Maybe it would also be useful to display all metadata that is available within the document (for example, as a table: key - value)

EPUB: Show productname and version number [sf#207]

From @tomschr on March 3, 2015 17:51

Reported by taroth21 on 2013-12-09 09:42 UTC
In the EPUB stylesheets, the information about product name and product version should be provided next to the book title.

Currently, it is missing, that's why I received the following mail:

"Actually, I would ask that the product name be in the title. If you download the ePub editions of the documentation for all of our products, it feels like half of them are called "Administrator's Guide" or some variant of that. Thus, you end up opening 3-4 of them looking for the one that is for the product you're looking for."

Copied from original issue: openSUSE/daps#206

PDF Output: XEP produces "stretched" text [sf#200]

From @tomschr on March 3, 2015 17:50

Reported by taroth21 on 2013-11-28 16:49 UTC
I just had the case of a listitem that included a URL at the end and only some words in front of the URL that would not fill a line completely. As URLs must not be wrapped in XEP, the URL is moved to the second line but the text in the first line is abnormally stretched which looks weird. (For an example, build the "Documentation Update" appendix of the current DAPS User Guide and look for "EpubCheck"). When using FOP instead, the text in front of the URL appears normal, but the URL is wrapped to the next line.

Copied from original issue: openSUSE/daps#199

Support QandaDiv

Using qandaset and structuring with qandadiv, the title of qandadiv appears to be printed in black and bold (instead of using a more greenish style) for PDF.

Add Bug Tracker Links to DocBook 4 HTML Output Again

Bug tracker information is tracked in DocManager. However, this is only possible for DocBook5. For DocBook4, this is not possible as we need to add these elements into Novdoc schema (which we would like to avoid).

One way to do it is to add the following PI before the root element:

<?suse-bugtracker url="https://bugzilla.suse.com/enter_bug.cgi"
                  product="SUSE Linux Enterprise Server 12 in Public Clouds"
                  component="Other"
?>

The pseudo-attributes (url, product, etc.) mean the same as the DM elements (dm:url, dm:product, etc.)

The stylesheet first searches for DM elements in the DM namespace urn:x-suse:ns:docmanager. If it cannot find a bugtracker URL, it falls back to searching for the above PI.

Investigate SASS/LESS

Current Issue

Maintaining CSS can be tedious and error-prune.

Idea

Maintaining our CSS with SASS (Syntactically Awesome Stylesheets) could make life a bit easier. SASS is a preprocessor and compiles a SASS script into CSS. SASS supports variables, mixins (kind of functions), and more.

Further Information

Refactor xref code to use xref-to-suffix mode [sf#178]

From @tomschr on March 3, 2015 15:19

Reported by tom_schr on 2013-09-17 12:41 UTC
Our stylesheets (for both HTML and FO) use a customized version of the xref template. They resolve links to "foreign" books in a set if you are only interested in a specific book.

The code in this template is verbose and overly complicated. After 1.78.2 version of the original stylesheets is released, the code should be refactored and use the xref-to-suffix mode.

Copied from original issue: openSUSE/daps#177

Update Webhelp Target [sf#93]

From @tomschr on March 3, 2015 12:41

Reported by tom_schr on 2012-08-11 15:50 UTC
Currently, the Webhelp output from the upstream DocBook stylesheet project is refactored by a Google Summer of Code student.

After this is done, we need to look at it again and change or adapt our customizations to the latest code base.

Copied from original issue: openSUSE/daps#93

Odd space in footer where productname used to be + productname not displayed on book title page

The footer used to have the productname in it. However, then came DB5, and with it, {article,book,set}info were replaced by just info.

The product template started to fail and it seems that was not corrected, just adjusted for in some parts of the stylesheets. Another aspect of this is that the productname is not displayed anymore on the title page of books.

The footer should also better handle the case when there really is no productname.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.