[gimp-web/testing: 1/3] Change /meta/ to update info and move content around



commit efea880fb5ed8a1ce197789382756a966220c5cc
Author: Pat David <patdavid gmail com>
Date:   Tue Jul 26 17:30:37 2016 -0500

    Change /meta/ to update info and move content around
    
    I moved up the Pelican build and install information for building
    the site.  I also included a new section detailing a little more
    what was done with GIMP_VERSIONS to make it work.

 content/about/meta/index.md |  173 +++++++++++++++++++++++++++----------------
 1 files changed, 110 insertions(+), 63 deletions(-)
---
diff --git a/content/about/meta/index.md b/content/about/meta/index.md
index 85ba3c4..c252b62 100644
--- a/content/about/meta/index.md
+++ b/content/about/meta/index.md
@@ -8,7 +8,7 @@ lang: en
 
 I (*Pat David*) am creating this page to keep notes and information for building/maintaining the new site.
 
-(Meta) pages of interest:
+Other (Meta) pages of interest:
 
 * [Editing the Front Page](./frontpage.html)
 * [Creating a Translation](./translating.html)
@@ -20,6 +20,115 @@ I (*Pat David*) am creating this page to keep notes and information for building
 * [Old URL List](./file-list.html)
 
 
+
+## Python & Pelican
+
+For anyone who wants to build and view the site, they will need only Python, and a couple of extra 
components (Pelican, Markdown, typogrify).
+This is the same procedure anyone can use to test new content they would like to propose or push.
+
+### Getting a build environment
+
+1. Install [Python].  
+2.7.x is best, earlier versions are not supported.  
+Only provisional support for 3.3+.
+2. Install [Pelican].  
+Simplest method is simply: `pip install pelican`
+3. Install some extra components:
+    * For [Markdown] support:  
+    `pip install Markdown`
+    * For fancy typography elements with [typogrify]:  
+    `pip install typogrify`
+    * For some html scraping for the mirrors list [Beautifulsoup4]:  
+    `pip install bs4`
+    * For ip geolocating (for the gimp-mirrors plugin), pygeoip:
+    `pip install pygeoip`
+
+
+For detailed information refer to the [Pelican documentation](http://docs.getpelican.com/en/stable/).
+
+
+
+### Building the site
+
+Building the site is relatively straightforward:
+
+From the project directory, simply invoke pelican:
+
+`pelican`
+
+If you are writing content or developing other parts of the site, there is an option to watch the directory 
of files for changes and to automatically re-compile the site as needed:
+
+`pelican -r`
+
+In some cases, it can be beneficial to avoid using the cache that Pelican creates internally (to help speed 
up the build).
+To avoid using the cache, *and* to watch for changes and rebuild as necessary:
+
+`pelican -r --ignore-cache`
+
+
+### Viewing the site
+
+Python has a simple web server available to preview the site.
+
+For Python 2:  
+`cd output`  
+`python -m SimpleHTTPServer`
+
+For Python 3:  
+`cd output`  
+`python m http.server`
+
+The site can then be accessed locally at:  
+`localhost:8000`
+
+Further notes on using Pelican can be found on the page [Using Pelican](./using-pelican).
+
+
+
+### GIMP_VERSIONS
+
+In the root of the project is a [JSON](http://www.json.org/) file called `GIMP_VERSIONS`.
+This file is meant to contain relevant information for all of the GIMP releases in a parse-able format.
+
+It's also used to automatically fill out relevant information on the [/downloads/](/downloads/) page
+such as the current stable version and associated hashes + links.
+
+The current stable version is automatically pulled from the most recent entry under `STABLE`.
+The current win/osx versions are automatically determined from the most recent entry under `STABLE` that 
includes either 'windows' or 'macos' respectively.  If an entry is not found in a section, it will continue 
searching down the list until it's found.
+
+```javascript
+'STABLE': {
+    'VERSION #': {
+        'source | windows | macos': {
+            'filename': 'hash'
+            }
+        }
+    }
+```
+
+For example, at the time of writing this, 2.8.18 was the most recent stable version, and the `GIMP_VERSIONS` 
file looked (partially) like this:
+
+```javascript
+"STABLE":  {
+
+    "2.8.18": {
+        "source": { 
+            "gimp-2.8.18.tar.bz2": "5adaa11a68bc8a42bb2c778fee4d389c"
+            },
+        "windows": {
+            "gimp-2.8.18-setup.exe": "510bb11abc72443f431226523fa21b6f"
+            },
+        "macos": {
+            "gimp-2.8.18-x86_64.dmg": "76858c813e9974b187edfd71ce6d83c6506d6a3c"
+            }
+        },
+```
+
+
+---
+
+
+
 The work I am doing here is based on a couple of suggestions over the past year (or more, I'm sure) to 
refresh the design of WGO.
 In particular, I had created a brief mockup to show and have been using that as a sort of visual guide for 
approaching the main page.
 You can view that [mockup .PNG here](/images/mockup3.png) (~1.8MB), or a smaller preview:
@@ -96,68 +205,6 @@ For instance, many will take files written as [Markdown] or [reStructuredText],
 
 
 
-### Python & Pelican
-
-For anyone who wants to build and view the site, they will need only Python, and a couple of extra 
components (Pelican, Markdown, typogrify).
-This is the same procedure anyone can use to test new content they would like to propose or push.
-
-#### Getting a build environment
-
-1. Install [Python].  
-2.7.x is best, earlier versions are not supported.  
-Only provisional support for 3.3+.
-2. Install [Pelican].  
-Simplest method is simply: `pip install pelican`
-3. Install some extra components:
-    * For [Markdown] support:  
-    `pip install Markdown`
-    * For fancy typography elements with [typogrify]:  
-    `pip install typogrify`
-    * For some html scraping for the mirrors list [Beautifulsoup4]:  
-    `pip install bs4`
-    * For ip geolocating (for the gimp-mirrors plugin), pygeoip:
-    `pip install pygeoip`
-
-
-For detailed information refer to the [Pelican documentation](http://docs.getpelican.com/en/stable/).
-
-
-
-#### Building the site
-
-Building the site is relatively straightforward:
-
-From the project directory, simply invoke pelican:
-
-`pelican`
-
-If you are writing content or developing other parts of the site, there is an option to watch the directory 
of files for changes and to automatically re-compile the site as needed:
-
-`pelican -r`
-
-In some cases, it can be beneficial to avoid using the cache that Pelican creates internally (to help speed 
up the build).
-To avoid using the cache, *and* to watch for changes and rebuild as necessary:
-
-`pelican -r --ignore-cache`
-
-
-#### Viewing the site
-
-Python has a simple web server available to preview the site.
-
-For Python 2:  
-`cd output`  
-`python -m SimpleHTTPServer`
-
-For Python 3:  
-`cd output`  
-`python m http.server`
-
-The site can then be accessed locally at:  
-`localhost:8000`
-
-Further notes on using Pelican can be found on the page [Using Pelican](./using-pelican).
-
 ## Who
 
 <figure>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]