SF.net SVN: docutils:[9896 ] trunk/docutils/docs/dev/w ebsite.txt
grubert--- via Docutils-checkins <[email protected]>
| Newsgroups | gmane.text.docutils.cvs |
|---|---|
| Message-ID | <[email protected]> |
Revision: 9896
http://sourceforge.net/p/docutils/code/9896
Author: grubert
Date: 2024-08-14 08:11:48 +0000 (Wed, 14 Aug 2024)
Log Message:
-----------
remove stale parts
add .rst
Modified Paths:
--------------
trunk/docutils/docs/dev/website.txt
Modified: trunk/docutils/docs/dev/website.txt
===================================================================
--- trunk/docutils/docs/dev/website.txt 2024-08-14 08:09:00 UTC (rev 9895)
+++ trunk/docutils/docs/dev/website.txt 2024-08-14 08:11:48 UTC (rev 9896)
@@ -13,25 +13,15 @@
The Docutils web site, <https://docutils.sourceforge.io/>, is
maintained by the ``docutils-update.local`` script, run by project
maintainers on their local machines. The script
-will process any .txt file which is newer than the corresponding .html
+will process any .rst/.txt file which is newer than the corresponding .html
file in the local copy of the project's web directory and upload the changes
to the web site at SourceForge.
-.. .. old instructions, for cron job:
-
- The Docutils web site, <https://docutils.sourceforge.io/>, is
- maintained automatically by the ``docutils-update`` script, run as an
- hourly cron job on shell.berlios.de (by user "wiemann"). The script
- will process any .txt file which is newer than the corresponding .html
- file in the project's web directory on shell.berlios.de
- (``/home/groups/docutils/htdocs/aux/htdocs/``) and upload the changes
- to the web site at SourceForge.
-
Please **do not** add any generated .html files to the Docutils
repository. They will be generated automatically after a one-time
setup (`described below`__).
-__ `Adding .txt Files`_
+__ `Adding .rst/.txt Files`_
The docutils-update.local__ script is located at
``sandbox/infrastructure/docutils-update.local``.
@@ -38,13 +28,7 @@
__ https://docutils.sourceforge.io/sandbox/infrastructure/docutils-update.local
-If you want to share files via the web, you can upload them using the
-uploaddocutils.sh__ script
-(``sandbox/infrastructure/uploaddocutils.sh``).
-__ https://docutils.sourceforge.io/sandbox/infrastructure/uploaddocutils.sh
-
-
Setting Up
==========
@@ -57,16 +41,16 @@
The procedure for that was on the docutils-devel list a while ago.
-Adding .txt Files
-=================
+Adding .rst/.txt Files
+======================
User/Contributor
----------------
-When adding a new .txt file that should be converted to HTML:
+When adding a new .rst/.txt file that should be converted to HTML:
#. Edit sandbox/infrastructure/htmlfiles.lst, and add the .html file
- corresponding to the new .txt file (please keep the sorted order).
+ corresponding to the new .rst/.txt file (please keep the sorted order).
#. Commit the edited version to the SVN repository.
@@ -77,10 +61,10 @@
once to create the directories in the filesystem before preparing for
HTML processing.
-#. Any .html document with a corresponding .txt file is regenerated
- if the .txt has changed, but no new .html files will be generated.
+#. Any .html document with a corresponding .rst/.txt file is regenerated
+ if the .rst/.txt has changed, but no new .html files will be generated.
- Therefore *touch* the .html-file and then the .txt.
+ Therefore *touch* the .html-file and then the .rst/.txt.
#. ``docutils-update.local -u`` Regenerate .html unconditionally.
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.