DocBook XSLT 1.0 Stylesheets
This repository contains the DocBook XSLT 1.0 Stylesheets, now
migrated away from SourceForge.
There are still some rough edges here as the build system and various
other things are being ported.
Nevertheless, this is now the intended repository of record.
The latest stable release is available at
https://github.com/docbook/xslt10-stylesheets/releases/download/release/1.79.2/docbook-xsl-1.79.2.zip
For build instructions please refer to the DocBook XSL Release Build Process.
Working in this repo
Here is the procedure for making changes to this repo.
Initial setup
-
Create your own fork. Go to https://github.com/docbook/xslt10-stylesheets
and click on the Fork button to create your own fork. -
Clone your fork to your local filesystem.
-
In your clone of the repo, set up the remote:
git remote add upstream https://github.com/docbook/xslt10-stylesheets
git remote -v
Repo procedure
-
In your local fork, update your fork from the main repo (upstream):
git fetch upstream -
Make sure you are on your master branch:
git checkout master -
Merge upstream into your local fork:
git rebase upstream/master -
Push these changes to your github fork to put that fork in synch with the main repo:
git push origin master -
Create a branch:
git checkout -b bugfix_branch -
Make your changes on this branch, and compare your changes using
git diff. -
Commit the changes:
git add filename
git commit -m "message"
-
Push your commits:
git push -u origin bugfix_branch -
On github, go to your fork or the main repo and create a new pull request, adding a comment and hitting submit.
-
The github repo will run the check routine which takes about 10 minutes. When complete, you can Merge to docbook.
-
The repo will rebuild the stock snapshot, which after about ten minutes you can view at: https://cdn.docbook.org/release/xsl/snapshot
-
To immediately resynch your fork and delete the branch:
git checkout master
git fetch upstream
git rebase upstream/master
git push
git branch -d bugfix_branch
Creating snapshot zip files
-
Create a tag like this:
git tag -m "Snapshot release" snapshot/2019-10-01 -
Push the tag:
git push -u upstream snapshot/2019-10-01 -
This will trigger the build of the zip files, which will
eventually appear in https://github.com/docbook/xslt10-stylesheets/releases