swdb: Release Gpg4win 3.1.1
[gnupg-doc.git] / README
diff --git a/README b/README
index 48213aa..d1bf219 100644 (file)
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-README for the website branch.                           -*- org -*-
+README for the gnupg-doc repository                         -*- org -*-
 
 This is a separated branch for the gnupg.org website.
 
@@ -8,15 +8,20 @@ HTML files.
 
 ** Directory structure
 
-   - web/ :: Source files for the web.  This also include imagages
-             etc.
+   - web/      :: Source files for the web.  This also include images
+                  etc.
    - web/share :: Logos, CSS, macros and elisp for building.
-   - tools/ :: Tools used to build the web site.
-   - stage/ :: staging directory for the site.
+   - misc      :: Other websites etc.
+                  - blog.gnupg.org
+                  - git.gnupg.org
+                  - howtos.gnupg.org :: Manuals etc.
+   - build-aux :: Build helper rscripts
+   - tools/    :: Tools used to build the web site.
+   - stage/    :: staging directory for the site.
 
 ** Aliases
 
-www.gnupg.org uses boa to serve the pages, here are the aliases we
+www.gnupg.org uses Boa to serve the pages, here are the aliases we
 use:
 
 #+BEGIN_EXAMPLE
@@ -25,19 +30,92 @@ use:
 Alias /documentation/manuals /var/www/shared/manuals
 Alias /gph /var/www/shared/gph
 
-# The FAQ is located in the manuals directory but linked to the faq directory
-Alias /faq/GnuPG-FAQ.html  /var/www/shared/manuals/GnuPG-FAQ.html
-
-
-# Redirect a couple of well-known URLs
-Redirect /gpa.html      http://www.gnupg.org/related_software/gpa/
-Redirect /gpgme.html    http://www.gnupg.org/related_software/gpgme/
-Redirect /docs.html     http://www.gnupg.org/documentation/
-Redirect /download.html http://www.gnupg.org/download/
-Redirect /faq.html      http://www.gnupg.org/documentation/faqs.html
+# The blog is maintained outside of the standard tree, so that it can be build using
+# a separate script.
+Alias /blog /var/www/www/www.gnupg.org/misc/blog
 
+# Redirect a couple of well-known old URLs
 # We use redirect to make language switching work.
-Redirect /why-not-idea.html  http://www.gnupg.org/faq/why-not-idea.html
+Redirect /gpa.html       http://www.gnupg.org/related_software/gpa/
+Redirect /gpgme.html     http://www.gnupg.org/related_software/gpgme/
+Redirect /docs.html      http://www.gnupg.org/documentation/
+Redirect /download.html  http://www.gnupg.org/download/
+Redirect /faq.html       http://www.gnupg.org/documentation/faqs.html
+Redirect /faqs.html      http://www.gnupg.org/documentation/faqs.html
+Redirect /gpgme-faq.html http://www.gnupg.org/faq/gpgme-faq.html
+Redirect /gnupg-faq.html http://www.gnupg.org/documentation/faqs.html
+Redirect /GnuPG-FAQ.html http://www.gnupg.org/documentation/faqs.html
+Redirect /supported_systems.html     http://www.gnupg.org/download/supported_systems.html
+Redirect /release_notes.html         http://www.gnupg.org/download/release_notes.html
+Redirect /integrity_check.html       http://www.gnupg.org/download/integrity_check.html
+Redirect /cvs_access.html            http://www.gnupg.org/download/cvs_access.html
+Redirect /iconv.html                 http://www.gnupg.org/download/iconv.html
+Redirect /manpage.html               http://www.gnupg.org/documentation/manpage.html
+Redirect /sites.html                 http://www.gnupg.org/documentation/sites.html
+Redirect /guides.html                http://www.gnupg.org/documentation/guides.html
+Redirect /manuals.html               http://www.gnupg.org/documentation/manuals.html
+Redirect /mailing-lists.html         http://www.gnupg.org/documentation/mailing-lists.html
+Redirect /howtos.html                http://www.gnupg.org/documentation/howtos.html
+Redirect /bts.html                   http://www.gnupg.org/documentation/bts.html
+Redirect /weak-digest-algos.html     http://www.gnupg.org/faq/weak-digest-algos.html
+Redirect /subkey-cross-certify.html  http://www.gnupg.org/faq/subkey-cross-certify.html
+Redirect /why-not-idea.html          http://www.gnupg.org/faq/why-not-idea.html
 
 Redirect /howtos/ch/  http://www.gnupg.org/howtos/zh/
+
+# Temporary:
+Redirect /fund   http://goteo.org/project/gnupg-new-website-and-infrastructure
+
 #+END_EXAMPLE
+
+The howtos are symlinked into the www.gnupg.org tree; see below.
+
+
+** Symlinks
+
+#+begin_example
+howtos -> ../../howtos.gnupg.org/htdocs
+related_software -> software
+features.html -> software/index.html
+#+end_example
+
+The website-build script assures that these symlinks exist
+
+** Cronjobs
+
+  A cronjob needs to run mkkudos.sh to update the list of donors.
+  This can be done every few minutes because mkkudos won't do anything
+  if the list of donors has not been updated.
+
+** Writing a blog entry
+
+  The misc/blog.gnupg.org directory is used for the blogging system.
+  On the web server it is symlinked to /blog/.  To build and upload all
+  blogs you cd to misc/blog.gnupg.org and run the command ./upload.
+  This renders the org files into html, builds an index, and uploads
+  the html files to the web server.  Emacs and a decent org-mode are
+  required (tested with org-mode 8.2.7).
+
+  To add a new blog entry, decide on the publication date and create
+  a file
+
+    YYYYMMDD-short-headline.org
+
+  for example "20141030-what-happened-this-month.org".  For drafting
+  the blog you may want to store it in drafts/ first.  Unless you
+  translate an existing entry do not use a file name which ends in
+  ".??.org".  The file itself is a standard org file using these
+  conventions:
+
+  ===== 8< =========
+  # Comment
+  #+AUTHOR: Werner
+  #+DATE: 30th October 2014
+
+  ** What happened in October 2014
+
+  Blurb
+  ===== >8 =========
+
+  AUTHOR and DATE are used to construct the "Posted at" info.  The
+  headline needs to start at level 2.