diff options
Diffstat (limited to 'ReadMe.rst')
-rw-r--r-- | ReadMe.rst | 26 |
1 files changed, 17 insertions, 9 deletions
@@ -88,20 +88,28 @@ The ``Makefile`` first attempts this by applying When it fails, a partially-patched ``scripts/template.html`` should result in a ``scripts/template.rej`` file, containing the unapplied hunks from the patch. + You'll need to manually adapt the patch's modifications to produce a -sensible ``scripts/template.html`` (see below) based on the new +sensible ``template.html`` (see below) based on the new ``template.qt`` from Planet Qt. -Once you have a usable ``scripts/template.html``, run:: +Once you have a usable ``template.html``, move it from ``scripts`` to +this top-level directory and run:: + + $ make patch - $ diff -bu planetqt/template.qt scripts/template.html >scripts/template.diff +You might then want to move your working ``template.html`` to safety, +while you check that building works; your test build shall, otherwise, +stomp your ``template.html`` in the process of generating the one it +uses. +If it all works nicely, commit your updated ``scripts/template.diff`` +along with the updated ``planetqt/``. -You might then want to move your working ``scripts/template.html`` to -safety, while you check that building works; your test build shall, -otherwise, stomp your ``scripts/template.html`` in the process of -generating the one it uses. If it all works nicely, commit your -updated ``scripts/template.diff`` along with the updated -``planetqt/``. +You can also use this process, manually updating ``template.html`` and +updating the patch, to work round problems with the parts of Planet Qt +we use. +For example, problems in the style-sheets can be fixed by patching a +style element into the template, after the style-sheets. How the template works ~~~~~~~~~~~~~~~~~~~~~~ |