Browse Source

Mention the FIXME directory at the root of Worg.

Bastien Guerry 8 years ago
parent
commit
a3b2d92a28
1 changed files with 21 additions and 8 deletions
  1. 21 8
      worg-setup.org

+ 21 - 8
worg-setup.org

@@ -12,23 +12,36 @@
 * How Worg publishes itself as a website?
 
   The server behind http://orgmode.org website takes care of publishing
-  Worg into =HTML=. 
+  Worg into =HTML=.
 
-  This is done in two steps: the first step is to pull Worg repository
-  on the server (this is cron'ed every 20 minutes, starting at 00:00),
-  the second one is to publish the last version of Worg on the website
-  (cron'ed every 20 minutes, starting at 00:10).  
+** How long does it take for a change to be published?
 
-  So for example, if you push a change in Worg at 00:37, this will be
-  pulled on the server at 00:40 and will appear on the website at 00:50.
+   Export happens in two steps: the first step is to pull Worg
+   repository on the server (this is cron'ed every 20 minutes, starting
+   at 00:00), the second one is to publish the last version of Worg on
+   the website (cron'ed every 20 minutes, starting at 00:10).
 
-  The output of both cron jobs are here: 
+   So for example, if you push a change in Worg at 00:37, this will be
+   pulled on the server at 00:40 and will appear on the website at
+   00:50.
+
+** There is a problem.  Can I check the export output?
+
+  The output of both cron jobs are readable here:
   
   - http://orgmode.org/worg/pulling.txt
   - http://orgmode.org/worg/publishing.txt
 
   Unmodified files are skipped during the process of exporting.
 
+** Looks like file XXX breaks the export.  What can I do?
+
+1. Put this file in the FIXME directory at the root of the Worg
+   repository.  Files in this FIXME directory won't be published.
+
+2. Fix the page or contact the author of the page telling him about the
+   problem.
+
 * Are there any writting conventions?
 
   Please don't use [[http://www.gnu.org/software/emacs/manual/html_node/emacs/Specifying-File-Variables.html#Specifying-File-Variables][file variables]] in your org files.