Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

prepare Docbook XSL-Stylesheets #334

Open
wants to merge 10 commits into
base: stable
Choose a base branch
from
Open

Conversation

CWehli
Copy link
Contributor

@CWehli CWehli commented Feb 6, 2024

Inspired by the ideas of TANIGUCHI Yasuaki, these adjustments were made to the existing XSL stylesheets:

  • reorganize the html-targets
  • do pdf-spezific customizing for
    • lists
    • titelpage
    • paperformat depending LANG
  • optimize admonitons
    • icons
    • spacing
    • font-size

For these commits I used parts from PRs #307, #308, #309, #310 and #311 as templates.

- Rename the customised DocBook XSL stylesheet layer to make it clear
that they are used for the GnuCash project.
- Add separate layer for customizing HTML

Based on an idea by TANIGUCHI Yasuaki aka usamimikamen-sk.
@fellen
Copy link
Member

fellen commented Oct 24, 2024

  • rename the customized stylesheets to gnc-custom-*

Why? The whole level are our customizations – borowed decades ago from GNOME Documentation Project
(gdp 1[?]) That evolved to gdp 2 (in between abandoned) and yelp-xsl (used by yelp).
Only the subdirectory 1.79.2 is from docbook.

@CWehli
Copy link
Contributor Author

CWehli commented Oct 27, 2024

Why? The whole level are our customizations

I tried to get a sorting in the customization level. This is only cosmetic and can be omitted.

so the section number is not part of the reference text in HTML.
add XSLT stylesheet layer for
- listelements
- titelpage
- choose the paperformat
- icons
- spacing
- font-size
insert formatting in fo/pdf docbool xls stylesheet
... the behavior of <screen> elements for FO output
@xuxinhang
Copy link
Contributor

Maybe using the path like html-markup/glossary.xsl instead of the file name prefix like html-glossary.xsl could be clearer, because put something like fo-glossary.xsl (maybe someday) together seems a mess.

Or even put all html-*.xsl into one single file like markup-html-custom.xsl? Each of html-*.xsl seems too short and fragmented.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants