[gnuastro-commits] master f3cbb7d: Webpage: new coming soon page and SVG animation in checklist

[Mohammad Akhlaghi]

branch: master
commit f3cbb7de88c612b08ca0ddf91b9c19afa108c58c
Author: Mohammad Akhlaghi <mohammad@akhlaghi.org>
Commit: Mohammad Akhlaghi <mohammad@akhlaghi.org>

    Webpage: new coming soon page and SVG animation in checklist
    
    Until now, for each release we would just suffice to the NEWS file. But to
    help new users see the power of new features, for Gnuastro 0.15, we'll try
    putting an SVG terminal-grab animation to hopefully get new users more
    interested.
    
    With this commit, the series of steps to do make an animation have been
    added in the release checklist and a new 'doc/coming-soon.html' webpage has
    been started (not yet complete) to act as a template for each new release.
---
 doc/coming-soon.html      | 99 +++++++++++++++++++++++++++++++++++++++++++++++
 doc/release-checklist.txt | 46 ++++++++++++++++++++++
 2 files changed, 145 insertions(+)

diff --git a/doc/coming-soon.html b/doc/coming-soon.html
new file mode 100644
index 0000000..844019c
--- /dev/null
+++ b/doc/coming-soon.html
@@ -0,0 +1,99 @@
+<!--#include virtual="/server/html5-header.html" -->
+
+<!-- Parent-Version: 1.84 -->
+<title>Gnuastro features comming soon</title>
+
+<style type="text/css"><!--
+.reduced-width { width: 50em; }
+.summary {
+  font-size: 1em;
+  box-sizing: border-box;
+  border: 1px solid #bbb;
+  margin-top: 1.3em;
+}
+.summary, .pict { width: 15.8em; max-width: 100%; }
+@media (min-width:45em) { .left-column { margin-right: 17.5em; }}
+--></style>
+<!--#include virtual="gnuastro.translist" -->
+<!--#include virtual="/server/banner.html" -->
+<div class="reduced-width">
+<h2>Gnuastro features that are coming soon (in version 0.15)</h2>
+<div class="thin"></div>
+
+<p>
+  <a href="gnuastro.html">GNU Astronomy Utilities</a> (Gnuastro) is an 
official GNU package consisting of various programs and library functions for 
the manipulation and analysis of astronomical data.
+</p>
+
+<p>
+  The current stable Gnuastro release is version 0.14.
+  In this page, you can some demonstrations of ongoing work for the next 
release.
+  You can always download the tarball containing <a 
href="http://git.savannah.gnu.org/cgit/gnuastro.git/log";>the most recent 
work</a> (which includes the features shown here) from this URL: <a 
href="http://akhlaghi.org/gnuastro-latest.tar.lz";>http://akhlaghi.org/gnuastro-latest.tar.lz</a>.
+  We do encourage using this most recent tarball and testing the features to 
report any possible bugs that have not yet been found.
+</p>
+
+
+
+
+
+
+<h3 id="license">Licensing</h3>
+
+<p>GNU Astronomy Utilities (Gnuastro) is free software; you can
+redistribute it and/or modify it under the terms of
+the <a href="/licenses/gpl.html" rel="license">GNU
+General Public License</a> as published by the Free Software
+Foundation; either version&nbsp;3 of the License, or (at your option)
+any later version.</p>
+
+</div>
+</div><!-- for id="content", starts in the include above -->
+<!--#include virtual="/server/footer.html" -->
+<div id="footer">
+<div class="unprintable">
+
+<p>Please send general FSF &amp; GNU inquiries to
+&lt;<a href="mailto:gnu@gnu.org";>gnu@gnu.org</a>&gt;.
+There are also <a href="/contact/">other ways to contact</a> the FSF.
+Broken links and other corrections or suggestions can be sent to &lt;<a
+href="mailto:bug-gnuastro=at=gnu.org";>bug-gnuastro::at::gnu.org</a>&gt;.</p>
+
+<p>Please see the <a
+href="/server/standards/README.translations.html">Translations
+README</a> for information on coordinating and contributing translations
+of this article.</p>
+</div>
+
+<!-- Regarding copyright, in general, standalone pages (as opposed to
+     files generated as part of manuals) on the GNU web server should
+     be under CC BY-ND 4.0.  Please do NOT change or remove this
+     without talking with the webmasters or licensing team first.
+     Please make sure the copyright date is consistent with the
+     document.  For web pages, it is ok to list just the latest year the
+     document was modified, or published.
+
+     If you wish to list earlier years, that is ok too.
+     Either "2001, 2002, 2003" or "2001-2003" are ok for specifying
+     years, as long as each year in the range is in fact a copyrightable
+     year, i.e., a year in which the document was published (including
+     being publicly visible on the web or in a revision control system).
+
+     There is more detail about copyright years in the GNU Maintainers
+     Information document, www.gnu.org/prep/maintain. -->
+
+<p>Copyright &copy; 2015-2016 Free Software Foundation, Inc.</p>
+
+<p>This page is licensed under a <a rel="license"
+href="http://creativecommons.org/licenses/by-nd/4.0/";>Creative
+Commons Attribution-NoDerivs 4.0 International License</a>.</p>
+
+<!--#include virtual="/server/bottom-notes.html" -->
+
+<p class="unprintable">Updated:
+<!-- timestamp start -->
+$Date: 2019/01/22 19:14:35 $
+<!-- timestamp end -->
+</p>
+</div>
+</div>
+</body>
+</html>
diff --git a/doc/release-checklist.txt b/doc/release-checklist.txt
index 1875f2e..8ed5f5e 100644
--- a/doc/release-checklist.txt
+++ b/doc/release-checklist.txt
@@ -4,6 +4,52 @@ Gnuastro release checklist
 Copyright (C) 2015-2021, Free Software Foundation, Inc.
 See the end of the file for license conditions.
 
+
+
+Creating animated SVG for demo
+==============================
+
+To help in visualizing the new features of every release, we show the
+features in a recorded terminal.
+
+ - Prerequisites;
+     - termtosvg (BSD: https://github.com/nbedos/termtosvg)
+     - NOT WORKING (as of February 9th, 2021, 'svg-term' has problems with
+       converting 'asciinema', complaining about the format)
+       - asciinema (GPL v3: https://asciinema.org/docs/installation).
+       - svg-term (MIT license: https://github.com/marionebl/svg-term-cli).
+
+ - Change your terminal prompt to be general by putting the line below
+   inside your user's '.bashrc' (just change 'XX' to the version of
+   Gnuastro that you want to display). Asciinema creates a new shell, so
+   you can't temporarily set it before calling asciinema.
+
+      export PS1="[\[\033[01;35m\]Gnuastro XX\[\033[32m\]\[\033[00m\]]$ "
+
+ - Make a clean empty directory (to avoid mixing existing files), and copy
+   any necessary dataset into it.
+
+      $ mkdir feature-demo
+      $ cd feature-demo
+      $ cp XXXXXXXX ./
+
+ - Start "recording". To help in writing, its good to reset the
+   screen.
+
+      $ rm ./*
+      $ reset
+      $ termtosvg ../feature.svg --screen-geometry 100x20
+
+ - When the recording is finished, put an entry in the "Comming soon" page
+   with a small description, remove the extra line and your
+
+
+
+
+
+Tarball release on gnu.org
+==========================
+
 This file is primarily intended for the Gnuastro maintainer and lists the
 set of operations to do for making each release. This should be done after
 all the commits needed for this release have been completed.