{"id":20245571,"url":"https://github.com/noloader/dockbook-install","last_synced_at":"2026-06-15T20:31:49.863Z","repository":{"id":177003998,"uuid":"659837414","full_name":"noloader/Dockbook-Install","owner":"noloader","description":"Instructions to setup DocBook on Ubuntu and Fedora","archived":false,"fork":false,"pushed_at":"2023-08-22T12:20:27.000Z","size":2633,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-03T15:46:55.647Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/noloader.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-28T17:06:01.000Z","updated_at":"2024-10-06T19:55:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"79923f7a-2664-4b41-b2ff-0f00ddf8bb25","html_url":"https://github.com/noloader/Dockbook-Install","commit_stats":null,"previous_names":["noloader/dockbook-install"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/noloader/Dockbook-Install","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noloader%2FDockbook-Install","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noloader%2FDockbook-Install/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noloader%2FDockbook-Install/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noloader%2FDockbook-Install/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/noloader","download_url":"https://codeload.github.com/noloader/Dockbook-Install/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noloader%2FDockbook-Install/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34379915,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-14T09:22:09.807Z","updated_at":"2026-06-15T20:31:49.839Z","avatar_url":"https://github.com/noloader.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"DockBook Install\n================\n\nThis GitHub provides instructions to setup DocBook on Ubuntu 16.04, 18.04 and 20.04 with Apache FOP 2.9.\n\nThe instructions include the steps to install packages such as `docbook`, `docbook-xsl`, `docbook-xsl-doc-pdf` and `xsltproc`. The instructions also cover installation of the Java Runtime Environment (JRE) or Development Kit (JDK), if needed.\n\nThe instructions are in `docbook-install.pdf`. Once DocBook is setup just run `make-book.sh` to create the book.\n\nCustomizations\n==============\n\nDocBook allows you to change the style of your book by using a custom stylesheet. For example, you can change the font family, font size, paragraph indents, left margin, or right margin. Since this book's `custom.xsl` is created on the fly, you should make your changes to `custom.xsl.in`. `custom.xsl.in` will be used to create the `custom.xsl` to build the book.\n\nThe XSLT translator consumes `custom.xsl` like shown below. The translator creates the formatted object that Apache's FOP uses to create the PDF.\n\n```\nxsltproc --xinclude custom.xsl book.xml \u003e \"${BOOKNAME}.fo\"\n```\n\nThis DocBook has changes applied in `custom.xsl.in`. The font family and font size were changed to 11 point Arial to make the book easier on the eyes. Margins and outdents were also changed to use more of the available page.\n\nmake-book.sh\n============\n\n`make-book.sh` builds the book on both Ubuntu and Fedora. Ubuntu and Fedora use different paths to the DocBook stylesheets, so different `custom.xsl` are needed. `make-book.sh` will create a `custom.xsl` using the path to the DocBook stylesheets for the site.\n\n`make-book.sh` will detect the location of the stylesheets if it is not specified by the user. After the code runs, `DOCBOOK_XSL` will contain a location like `/usr/share/xml/docbook/stylesheet/docbook-xsl/fo/docbook.xsl`.\n\n```\nDOCBOOK_XSL=\"$(find /usr/share -name 'docbook.xsl' 2\u003e/dev/null | grep -E '/fo/docbook.xsl$' | head -n 1)\"\n```\n\n`make-book.sh` will then create the custom stylesheet, substituting the location for `!!DOCBOOK_XSL!!` in the custom style sheet.\n\n```\n# This magic allows us to build the DocBook on Ubuntu and Fedora.\n# Ubuntu and Fedora use different paths to docbook.xsl.\nsed \"s|!!DOCBOOK_XSL_FILE!!|${DOCBOOK_XSL}|g\" custom.xsl.in \u003e custom.xsl\n```\n\nAnd the corresponding part of `custom.xsl.in` is shown below.\n\n```\n\u003cxsl:stylesheet version=\"1.0\" xmlns:xsl=\"http://www.w3.org/1999/XSL/Transform\"\u003e\n    \u003cxsl:import href=\"!!DOCBOOK_XSL_FILE!!\"/\u003e\n    ...\n\u003c/xsl:stylesheet\u003e\n```\n\nThe remainder of `make-book.sh` lints the sources, creates the formatted object, builds the book and optimizes the book.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoloader%2Fdockbook-install","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnoloader%2Fdockbook-install","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoloader%2Fdockbook-install/lists"}