[gimp-web/testing] Start meta page on publishing releases



commit 2a898cec1c4789278cfb3eb12dbca3290d80699e
Author: Pat David <patdavid gmail com>
Date:   Mon Nov 12 11:11:22 2018 -0600

    Start meta page on publishing releases

 content/about/meta/index.md           |   1 +
 content/about/meta/publish-release.md | 175 ++++++++++++++++++++++++++++++++++
 2 files changed, 176 insertions(+)
---
diff --git a/content/about/meta/index.md b/content/about/meta/index.md
index 4121631b..d948b826 100644
--- a/content/about/meta/index.md
+++ b/content/about/meta/index.md
@@ -10,6 +10,7 @@ I (*Pat David*) am creating this page to keep notes and information for building
 
 Other (Meta) pages of interest:
 
+* [Publish a new release]({filename}publish-release.md)
 * [Editing the Front Page](./frontpage.html)
 * [Creating a Translation](./translating.html)
 * [Git Workflow](./git-workflow.html)
diff --git a/content/about/meta/publish-release.md b/content/about/meta/publish-release.md
new file mode 100644
index 00000000..22b01689
--- /dev/null
+++ b/content/about/meta/publish-release.md
@@ -0,0 +1,175 @@
+Title: Publishing a Release
+Date: 2018-11-12T09:50:48-06:00 
+Author: Pat David
+Summary: Steps for publishing a release on the website
+
+These are the steps for publishing a new release on the website.
+
+## GIMP_VERSIONS
+
+All of the releases are listed in this JSON file in the root of the gimp-web directory.
+The website builds will parse this file to include the relevant information in various places (the downloads 
page in particular).
+
+The website build system _does not check_ for existence of the binaries on download.gimp.org.
+File will need to be uploaded here before continuing.
+Find a GIMPer with appropriate permissions to push files up to download.gimp.org before continuing.
+
+
+## Source
+
+When a new tarball is ready, make sure the file is available on download.gimp.org and the SHA512 and SHA256 
sums have been updated as well.
+
+Now update GIMP_VERSIONS:
+
+```
+{
+  "STABLE":  {
+    "2.XX.XX": {
+      "date": "YYYY-MM-DD",
+      "source": {
+        "gimp-2.XX.XX.tar.bz2": {
+          "sha512": 
"b458dd710b786152f95a8e48a0727b71cac549fccb31ac9e1e6ac3c617652079773ce7076401f8ade750ed38bdc78dfdec3317423f4c4e9c931f78002bd7454e",
+          "sha256": "d849c1cf35244938ae82e521b92b720ab48b8e9ed092d5de92c2464ef5244b9b"
+        }
+      },
+...
+```
+
+Replace `X` where appropriate.
+Hopefully adding an entry is obvious, but as an example, adding a new version for a fake `2.10.10` release 
would look like this:
+
+
+```
+{
+  "STABLE":  {
+    "2.10.10": {
+      "date": "2018-11-12",
+      "source": {
+        "gimp-2.10.10.tar.bz2": {
+          "sha512": 
"b458dd710b786152f95a8e48a0727b71cac549fccb31ac9e1e6ac3c617652079773ce7076401f8ade750ed38bdc78dfdec3317423f4c4e9c931f78002bd7454e",
+          "sha256": "d849c1cf35244938ae82e521b92b720ab48b8e9ed092d5de92c2464ef5244b9b"
+        }
+      }
+    },
+    "2.10.8": {
+      "date": "2018-11-08",
+      "source": {
+        "gimp-2.10.8.tar.bz2": {
+          "sha512": 
"b458dd710b786152f95a8e48a0727b71cac549fccb31ac9e1e6ac3c617652079773ce7076401f8ade750ed38bdc78dfdec3317423f4c4e9c931f78002bd7454e",
+          "sha256": "d849c1cf35244938ae82e521b92b720ab48b8e9ed092d5de92c2464ef5244b9b"
+        }
+      }
+    }
+...
+```
+
+
+## Windows and macOS Binaries
+
+The same steps should be used for binaries, but with the addition of including a torrent for the file as 
well.
+As before, make sure that the binaries are already uploaded to download.gimp.org and the SHA512 and SHA256 
hashes have been created.
+
+
+### Create .torrent file
+
+To create a new torrent file, download the binary locally.
+Make sure that your torrent creation tool allows webseeds.
+We've been using `mktorrent`, specifically:
+
+```
+$ mktorrent -v
+mktorrent 1.0 (c) 2007, 2009 Emil Renner Berthing
+```
+
+You can grab one of the previous .torrent files to see what is used for trackers and webseeds.
+(You can use a tool like `transmission-show` to view the .torrent file info.)
+
+Here is the .torrent file for a windows release:
+
+```
+$ transmission-show gimp-2.10.8-setup-1.exe.torrent
+Name: gimp-2.10.8-setup-1.exe
+File: gimp-2.10.8-setup-1.exe.torrent
+
+GENERAL
+
+  Name: gimp-2.10.8-setup-1.exe
+  Hash: cbf0a8124f9f99e4d2b29f8c4da18fde2e41dc83
+  Created by: mktorrent 1.0
+  Created on: Sat Nov 10 17:58:00 2018
+  Comment: GIMP 2.10.8 Installer for Microsoft Windows - 32 and 64 Bit
+  Piece Count: 778
+  Piece Size: 256.0 KiB
+  Total Size: 203.8 MB
+  Privacy: Public torrent
+
+TRACKERS
+
+  Tier #1
+  udp://tracker.coppersurfer.tk:6969
+
+  Tier #2
+  udp://tracker.leechers-paradise.org:6969
+
+  Tier #3
+  udp://tracker.openbittorrent.com:80
+
+  Tier #4
+  udp://open.demonii.com:1337
+
+WEBSEEDS
+
+  http://gimper.net/downloads/pub/gimp/v2.10/osx/
+  http://gimp.afri.cc/pub/gimp/v2.10/osx/
+  http://de-mirror.gimper.net/pub/gimp/v2.10/osx/
+  http://mirrors-br.go-parts.com/gimp/v2.10/osx/
+  http://gimp.parentingamerica.com/v2.10/osx/
+  http://gimp.raffsoftware.com/v2.10/osx/
+  http://gimp.skazkaforyou.com/v2.10/osx/
+  http://ftp.iut-bm.univ-fcomte.fr/gimp/v2.10/osx/
+  http://mirror.ibcp.fr/pub/gimp/v2.10/osx/
+  http://servingzone.com/mirrors/gimp/v2.10/osx/
+  http://artfiles.org/gimp.org/v2.10/osx/
+  http://gimp.cybermirror.org/v2.10/osx/
+  http://ftp.fernuni-hagen.de/ftp-dir/pub/mirrors/www.gimp.org/v2.10/osx/
+  http://ftp.gwdg.de/pub/misc/grafik/gimp/v2.10/osx/
+  http://mirrors.zerg.biz/gimp/v2.10/osx/
+  http://ftp.cc.uoc.gr/mirrors/gimp/v2.10/osx/
+  http://ftp.heanet.ie/mirrors/ftp.gimp.org/pub/gimp/v2.10/osx/
+  http://www.ring.gr.jp/pub/graphics/gimp/v2.10/osx/
+  http://ftp.snt.utwente.nl/pub/software/gimp/gimp/v2.10/osx/
+  http://ftp.nluug.nl/graphics/gimp/v2.10/osx/
+  http://piotrkosoft.net/pub/mirrors/ftp.gimp.org/v2.10/osx/
+  http://mirrors.dominios.pt/gimpv2.10/osx/
+  http://mirrors.fe.up.pt/mirrors/ftp.gimp.org/v2.10/osx/
+  http://mirrors.serverhost.ro/gimp/v2.10/osx/
+  http://sunsite.rediris.es/mirror/gimp/v2.10/osx/
+  http://ftp.sunet.se/pub/gnu/gimp/v2.10/osx/
+  http://www.mirrorservice.org/sites/ftp.gimp.org/pub/gimp/v2.10/osx/
+  http://gimp.cp-dev.com/v2.10/osx/
+  http://mirror.hessmo.com/gimp/v2.10/osx/
+  http://gimp.mirrors.hoobly.com/gimp/v2.10/osx/
+  http://mirror.umd.edu/gimp/gimp/v2.10/osx/
+  http://mirrors.zerg.biz/gimp/v2.10/osx/
+  http://mirrors.xmission.com/gimp/v2.10/osx/
+  http://download.gimp.org/pub/gimp/v2.10/osx/
+
+FILES
+
+  gimp-2.10.8-setup-1.exe (203.8 MB)
+```
+
+To create a new torrent, invoke `mktorrent` like this:
+
+```
+$ mktorrent -a "tracker1" -a "tracker2" -a "trackerN" \
+ -w "webseed1" -w "webseed2" -w "webseedN" \
+ -c "COMMENT (ie: GIMP-2.10.8 Windows 64/32bit Installer)" \
+ {file}
+```
+
+Where `trackerN` and `webseedN` are the appropriate URLs.
+
+Make sure the new .torrent file gets uploaded to download.gimp.org as well.
+
+Save changes to GIMP_VERSIONS and push!


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