[Checkins] SVN: docs.zope.org_website/README.txt - make sure people re-run the buildout and doc builder scripts
Jens Vagelpohl
jens at dataflake.org
Sat Jul 31 12:42:45 EDT 2010
Log message for revision 115273:
- make sure people re-run the buildout and doc builder scripts
when the buildout configuration changes.
Changed:
U docs.zope.org_website/README.txt
-=-
Modified: docs.zope.org_website/README.txt
===================================================================
--- docs.zope.org_website/README.txt 2010-07-31 16:39:38 UTC (rev 115272)
+++ docs.zope.org_website/README.txt 2010-07-31 16:42:45 UTC (rev 115273)
@@ -13,7 +13,9 @@
How do remove a package from a package list?
--------------------------------------------
Find the respective buildout stanza and remove the
-Subversion URL in the ``sources`` list.
+Subversion URL in the ``sources`` list. Afterwards run
+``bin/buildout`` to regenerate the documentation build
+scripts for the stanzas you changed and re-run them.
How do I add a package to a package list?
@@ -45,7 +47,11 @@
you can add the package URL to the site buildout as explained in
the first paragraph.
+When you're done changing the buildout configuration re-run
+``bin/buildout`` to regenerate the documentation build
+scripts for the stanzas you changed and re-run them.
+
How do I add another packages set page?
---------------------------------------
Start by copying an existing buildout stanza. Then change
@@ -57,9 +63,14 @@
and should be maintaind by hand. Simply add another section or
link as needed for your new package set page and rebuild.
+When you're done changing the buildout configuration re-run
+``bin/buildout`` to generate the documentation build scripts for
+the stanzas you added and run them.
+
How do I change the site styling or layout?
-------------------------------------------
The site root is built from the Sphinx configuration in
the ``templates`` folder. You can adjust the main page content
(the ``index.rst`` file) and the configuration as you like.
+
More information about the checkins
mailing list