{"id":18835974,"url":"https://github.com/tomschr/dbcookbook","last_synced_at":"2026-01-27T03:30:16.793Z","repository":{"id":44855782,"uuid":"91983154","full_name":"tomschr/dbcookbook","owner":"tomschr","description":"Cookbook for DocBook and DocBook XSL stylesheets","archived":false,"fork":false,"pushed_at":"2020-08-27T21:31:17.000Z","size":36785,"stargazers_count":16,"open_issues_count":24,"forks_count":5,"subscribers_count":4,"default_branch":"develop","last_synced_at":"2025-02-12T11:09:29.463Z","etag":null,"topics":["cookbook","docbook","xml","xslt"],"latest_commit_sha":null,"homepage":"http://doccookbook.sf.net/","language":"XSLT","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tomschr.png","metadata":{"files":{"readme":"README.rst","changelog":"Changelog","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-05-21T19:48:57.000Z","updated_at":"2024-05-17T16:46:08.000Z","dependencies_parsed_at":"2022-09-01T20:13:05.192Z","dependency_job_id":null,"html_url":"https://github.com/tomschr/dbcookbook","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomschr%2Fdbcookbook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomschr%2Fdbcookbook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomschr%2Fdbcookbook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomschr%2Fdbcookbook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tomschr","download_url":"https://codeload.github.com/tomschr/dbcookbook/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239770681,"owners_count":19694115,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cookbook","docbook","xml","xslt"],"created_at":"2024-11-08T02:17:45.208Z","updated_at":"2026-01-27T03:30:16.618Z","avatar_url":"https://github.com/tomschr.png","language":"XSLT","funding_links":[],"categories":[],"sub_categories":[],"readme":"===================================\nWelcome to \"The DoCookBook\"\n===================================\n\n.. image:: https://travis-ci.org/tomschr/dbcookbook.svg?branch=develop\n    :target: https://travis-ci.org/tomschr/dbcookbook\n\n:Info: See https://github.com/tomschr/dbcookbook\n:Author: Thomas Schraitle \u003ctom_schr AT web DOT de\u003e\n:Description: Cookbook for DocBook and DocBook XSL stylesheets\n:HTML: http://doccookbook.sourceforge.net\n\n\nLicense\n-------\nThe book is licensed as Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Germany License\n(CC by-nc-sa 3.0 DE) See http://creativecommons.org/licenses/by-nc-sa/3.0/de/\n\n\nMission\n-------\nThe DoCookBook project aims to create an open source book about DocBook and the DocBook XSL \nstylesheets written in a cookbook-style manner and released under a Creative Commons license.\n\n\nConcept\n-------\nThis book is written in a \"cookbook\" style. The book contains \"topics\"\nwhich are divided into a problem, the corresponding solution, some \ndiscussions, and optional related information.\nIt is very easy just to go to the table of contents and see if there\nis something useful that fits to your problem.\nSolutions are usually written in a procedural style which contain\nseveral steps.\n\n\nTarget Group\n------------\nIt is assumed you have a decent knowledge about XML and DocBook. It doesn't\nhurt if you know CSS and XSLT. As such, it is aimed more at DocBook \ndevelopers than writers.\n\n\nStructure of the Book and Organization\n--------------------------------------\n\nThe main file is \"en/xml/DocBook-Cookbook.xml\". It contains xi:include\nelements which refer to chapters, appendices and other second level\nelements.\n\n::\n  \n  # Structure of Book with Main Chapters \n  en/xml/DocBook-Cookbook.xml\n  |\n  +-- 5.1/        # (1)\n  |\n  +-- common/     # (2)\n  |\n  +-- db/         # (3)\n  |\n  +-- epub/       # (4)\n  | \n  +-- fo/         # (5)\n  |\n  +-- html/       # (6)\n  |\n  +-- structure/ # (7)\n\n::\n  \n  (1) Contains the DocBook Schema and possible customizations\n  (2) Contains topics to common customizations\n  (3) Contains topics to DocBook's markup\n  (4) Planned: will contain customizations to EPUB output format\n  (5) Contains topics to FO customizations\n  (6) Contains topics to HTML, XHTML, and other customizations based on HTML\n  (7) Contains topics how to manipulate DocBook's structure\n\n\nSome topics contain directories which store XSLT, XML, or other example files.\nIn some cases these are incorporated into the XML source, sometimes they are\njust lying around for testing purposes.\n\nEach topic is a self-contained matter of a specific problem and its solution\nwith discussion. Use the skeleton file \"en/xml/topic.empty.xml\"  as a starting point.\nIt contains the basic structure and you just need to add the flesh of your topic.\n\n\nContribute\n----------\nDo you miss anything? Have you discovered an error? Have an idea about how\nto improve the book? Great! If you want to contribute to the book, you can\ndo it in different ways:\n\n* Write me a mail to \u003ctom_schr (AT) web.de\u003e and send me your comments\n* Extend the tickets (Ideas for New Topics) at http://github/tomschr/dbcookbook/issues\n* Clone this repository and send me patches\n\nThis repository uses `git flow` from https://github.com/petervanderdoes/gitflow-avh \nsee `Vincent Driessen Git branching model \u003chttp://nvie.com/posts/a-successful-git-branching-model/\u003e`_\n\n\n\nHow to build the book\n---------------------\n\nCurrently, building the book works but it's not as nice as I would\nlike to see it.\n\n* Building chunked HTML: use ./bin/dbsaxon\n* Building single HTML: use bin/dbsaxon9 \n\nAt the moment, it is a mixture of XSLT 1.0 and XSLT 2.0 stylesheets.\nTo avoid maintaing two different CSS files (one for the XSLT 1.0 output,\nthe other for 2.0), the HTML files coming from XSLT 1.0 are \"cleaned up\".\nThis cleanup step makes the structure compatible to the XSLT 2.0 output.\n\n\nHow you can help\n----------------\n\n* Find typos, grammar problems, inconsistencies, or plain errors\n* Send me patches\n* Write your own topic\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomschr%2Fdbcookbook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftomschr%2Fdbcookbook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomschr%2Fdbcookbook/lists"}