removed @see notation

Author: Trilarion

code/backlog.txt

@@ -4,6 +4,9 @@ http://antongerdelan.net/blog/ (other projects besides TestDrive)
 http://cdetect.sourceforge.net/
 http://circularstudios.com/
 http://cyxdown.free.fr/bs/
+https://projects.tuxfamily.org/ (all of them)
+https://www.artsoft.org/rocksndiamonds/
+https://web.archive.org/web/20171228172756/http://www.oletus.fi/static/whichwayisup/
 http://cyxdown.free.fr/f2b/
 http://dead-code.org/home/
 http://e-adventure.e-ucm.es/login/index.php (games of eAdventure)

code/generate_static_website.py

@@ -21,14 +21,13 @@
 # TODO contribute.html add content
 
 # TODO more icons - (categories, stars, forks)
-# TODO rename fields (Home to Homepage, Inspirations to Inspiration)
 # TODO replace or remove @notices in entries (maybe different entries format) ??
 # TODO SEO optimizations, google search ...
 # TODO sitemap
 # TODO Google search console
 # TODO <a> rel attribute https://www.w3schools.com/TAGS/att_a_rel.asp
-# TODO naming: improve or send feedback?
-# TODO menu (before On Github, Blog)
+# TODO naming: improve or send feedback? or edit? or contribute?
+# TODO menu (before On Github, Blog) or just in the footer
 
 # TODO everywhere: style URLs (Github, Wikipedia, Internet archive, SourceForge, ...)
 # TODO everywhere: singular, plural (game, entries, items)
@@ -42,7 +41,7 @@
 # TODO statistics: with nice graphics (pie charts in SVG) with matplotlib, seaborn, plotly?
 # TODO statistics: get it from common statistics generator
 
-# TODO footer: last updated with lower precision + link to license
+# TODO footer: clean up, link to Github project
 
 # TODO frameworks: icons
 
@@ -131,8 +130,8 @@
     'Library': 'library'
 }
 
-plurals = {k: k+'s' for k in ('Assets license', 'Contact', 'Code language', 'Code license', 'Developer', 'Download', 'Inspiration', 'Game', 'Keyword', 'Home', 'Organization', 'Platform', 'Tag')}
-for k in ('Media', 'Play', 'State'):
+plurals = {k: k+'s' for k in ('Assets license', 'Contact', 'Code language', 'Code license', 'Developer', 'Download', 'Inspiration', 'Game', 'Keyword', 'Home', 'Homepage', 'Organization', 'Platform', 'Tag')}
+for k in ('Media', 'Play', 'Play online', 'State'):
     plurals[k] = k
 for k in ('Code repository', 'Code dependency'):
     plurals[k] = k[:-1] + 'ies'
@@ -373,6 +372,7 @@ def make_url(href, content, title=None, css_class=None):
         url['class'] = css_class
     return url
 
+
 def make_icon(css_class):
     return {
         'type': 'icon',
@@ -389,11 +389,13 @@ def make_text(content, css_class=None):
         text['class'] = css_class
     return text
 
+
 def make_nothing():
     return {
         'type': 'nothing'
     }
 
+
 def make_enumeration(entries, divider=', '):
     enumeration = {
         'type': 'enumeration',
@@ -402,6 +404,7 @@ def make_enumeration(entries, divider=', '):
     }
     return enumeration
 
+
 def make_tags(entries):
     return {
         'type': 'tags',
@@ -526,11 +529,18 @@ def convert_entries(entries, inspirations, developers):
                 if field == 'Inspiration':
                     e = [make_url(inspirations_references[x], make_text(x, 'has-text-weight-semibold')) for x in e]
                 elif field == 'Developer':
-                    e = [make_url(developer_references[x], make_text(x, 'has-text-weight-semibold')) for x in e]
+                    if len(e) > 10: # many devs, print smaller
+                        e = [make_url(developer_references[x], make_text(x, 'has-text-weight-semibold is-size-7')) for x in e]
+                    else:
+                        e = [make_url(developer_references[x], make_text(x, 'has-text-weight-semibold')) for x in e]
                 elif field in c.url_fields:
                     e = [make_url(x, shortcut_url(x, name)) for x in e]
                 else:
                     e = [make_text(x) for x in e]
+                if field == 'Home': # Home -> Homepage
+                    field = 'Homepage'
+                elif field == 'Play': # Play -> Play online
+                    field = 'Play online'
                 namex = make_text('{}: '.format(get_plural_or_singular(field, len(e))), 'has-text-weight-semibold')
                 entry[field.lower()] = [namex, make_enumeration(e, divider)]
 
@@ -556,7 +566,7 @@ def convert_entries(entries, inspirations, developers):
                 if isinstance(e[0], osg.osg_parse.ValueWithComment):
                     e = [x.value for x in e]
                 if field == 'Code language':
-                    e = [make_url(code_language_references[x], make_text(x, 'is-size-7')) for x in e]
+                    e = [make_url(code_language_references[x.value], make_text(x, 'is-size-7')) for x in e]
                 elif field == 'Code license' or field == 'Assets license':
                     e = [make_url(c.license_urls[x], x, css_class='is-size-7') if x in c.license_urls else make_text(x, 'is-size-7') for x in e]
                 elif field in c.url_fields:
@@ -636,7 +646,7 @@ def generate(entries, inspirations, developers):
     # base dictionary
     base = {
         'title': 'OSGL',
-        'creation-date': datetime.datetime.utcnow()
+        'creation-date': datetime.datetime.now(datetime.timezone.utc).strftime('%Y-%m-%d %H:%M')
     }
 
     # copy css

code/html/base.jinja

@@ -21,6 +21,7 @@
           <a class="navbar-item{% if 'genres' in base['active_nav'] %} is-active{% endif %}" href="{{ base['url_to'](['games', 'genres.html']) }}">{{ macros.render_icon('price-tag') }}<span>By category</span></a>
           <a class="navbar-item{% if 'code language' in base['active_nav'] %} is-active{% endif %}" href="{{ base['url_to'](['games', 'languages.html']) }}">{{ macros.render_icon('language') }}<span>By code language</span></a>
           <a class="navbar-item{% if 'platforms' in base['active_nav'] %} is-active{% endif %}" href="{{ base['url_to'](['games', 'platforms.html']) }}">{{ macros.render_icon('laptop') }}<span>By OS support</span></a>
+          <a class="navbar-item{% if 'top-50' in base['active_nav'] %} is-active{% endif %}" href="{{ base['url_to'](['games', 'top50.html']) }}">{{ macros.render_icon('star') }}<span>GitHub Stars Top 50</span></a>
         </div>
       </div>
       <a class="navbar-item{% if 'frameworks' in base['active_nav'] %} is-active{% endif %}" href="{{ base['url_to'](['frameworks', 'index.html']) }}">{{ macros.render_icon('wrench') }}<span>Frameworks/Tools</span></a>
@@ -43,7 +44,7 @@
     <div class="block">
       Disclaimer: The content on this site is the result of voluntary work and may be outdated or incorrect.
       The content is licensed <a href="https://github.com/Trilarion/opensourcegames/blob/master/LICENSE">CC-0</a>. Icons and ... <br>
-      Last updated on {{ base['creation-date'] }}
+      Last updated: {{ base['creation-date'] }}
     </div>
   </div>
 </footer>

code/html/listing_entries.jinja

@@ -35,7 +35,7 @@
   {%- if 'developer' in item %}{{ macros.render_element(item['developer']) }}{% endif -%}
   </div>
   <div class="block">
-    {%- for field in ('home', 'media', 'download', 'play') -%}
+    {%- for field in ('homepage', 'media', 'download', 'play online') -%}
     {%- if field in item -%}{{ macros.render_element(item[field]) }}<br>{%- endif -%}
     {%- endfor -%}
   </div>

code/maintenance_entries.py

@@ -863,38 +863,50 @@ def special_ops(self):
             print('entries not yet loaded')
             return
 
-        # collect statistics on git repositories
-        created = {}
-        stars = []
-        forks = []
+        # remove download urls that are also in home
         for entry in self.entries:
-            repos = entry['Code repository']
-            comments = [x.comment for x in repos if x.value.startswith('https://github.com/') and x.comment]
-            for comment in comments:
-                comment = comment.split(',')
-                comment = [c.strip() for c in comment]
-                comment = [c for c in comment if c.startswith('@')]
-                if comment:
-                    try:
-                        comment = [c.split(' ') for c in comment]
-                        comment = [c[1] for c in comment if len(c) > 1]
-                    except Exception:
-                        print(comment)
-                        raise
-                    created[comment[0]] = created.get(comment[0], 0) + 1
-                    stars.append(comment[1])
-                    forks.append(comment[2])
-
-        for key, value in sorted(created.items(), key=lambda x: x[0]):
-            print("{} : {}".format(key, value))
-
-        import numpy as np
-        np.set_printoptions(suppress=True)
-        stars = np.array(stars, dtype=np.float)
-        forks = np.array(forks, dtype=np.float)
-        q = np.arange(0, 1, 0.1)
-        print(np.quantile(stars, q))
-        print(np.quantile(forks, q))
+            homes = entry['Home']
+            downloads = entry.get('Download', [])
+            downloads = [download for download in downloads if download not in homes]
+            if downloads:
+                entry['Download'] = downloads
+            if not downloads and 'Download' in entry:
+                del entry['Download']
+
+
+        # # collect statistics on git repositories
+        # created = {}
+        # stars = []
+        # forks = []
+        # for entry in self.entries:
+        #     repos = entry['Code repository']
+        #     comments = [x.comment for x in repos if x.value.startswith('https://github.com/') and x.comment]
+        #     for comment in comments:
+        #         comment = comment.split(',')
+        #         comment = [c.strip() for c in comment]
+        #         comment = [c for c in comment if c.startswith('@')]
+        #         if comment:
+        #             try:
+        #                 comment = [c.split(' ') for c in comment]
+        #                 comment = [c[1] for c in comment if len(c) > 1]
+        #             except Exception:
+        #                 print(comment)
+        #                 raise
+        #             created[comment[0]] = created.get(comment[0], 0) + 1
+        #             stars.append(comment[1])
+        #             forks.append(comment[2])
+        #
+        # for key, value in sorted(created.items(), key=lambda x: x[0]):
+        #     print("{} : {}".format(key, value))
+        #
+        # import numpy as np
+        # np.set_printoptions(suppress=True)
+        # stars = np.array(stars, dtype=np.float)
+        # forks = np.array(forks, dtype=np.float)
+        # q = np.arange(0, 1, 0.333)
+        # print(q)
+        # print(np.quantile(stars, q))
+        # print(np.quantile(forks, q))
 
         # # cvs without any git
         # for entry in self.entries:

code/utils/constants.py

@@ -42,7 +42,7 @@ def get_config(key):
 generic_comment_string = '[comment]: # (partly autogenerated content, edit with care, read the manual before)'
 
 # these fields have to be present in each entry (in this order)
-essential_fields = ('File', 'Title', 'Home', 'State', 'Keyword', 'Code repository', 'Code language', 'Code license')
+essential_fields = ('File', 'Title', 'Home', 'State', 'Keyword', 'Code language', 'Code license')
 
 # only these fields can be used currently (in this order)
 valid_properties = ('Home', 'Media', 'Inspiration', 'State', 'Play', 'Download', 'Platform', 'Keyword', 'Code repository', 'Code language',

code/utils/osg.py

@@ -235,7 +235,7 @@ def read_entries():
     entries = []
 
     # iterate over all entries
-    exception_happened = False
+    exception_happened = None
     for file, _, content in entry_iterator():
 
         if not content.endswith('\n'):
@@ -248,14 +248,14 @@ def read_entries():
             entry = check_and_process_entry(entry)
         except Exception as e:
             print('{} - {}'.format(file, e))
-            exception_happened = True
-            # raise RuntimeError(e)
+            exception_happened = e # just store last one
             continue
 
         # add to list
         entries.append(entry)
     if exception_happened:
-        raise RuntimeError('errors while reading entries')
+        print('error(s) while reading entries')
+        raise exception_happened
 
     return entries
 
@@ -354,7 +354,7 @@ def check_and_process_entry(entry):
                 message += 'URL "{}" in field "{}" does not start with a valid prefix'.format(value, field)
 
     # github/gitlab repositories should end on .git and should start with https
-    for repo in entry['Code repository']:
+    for repo in entry.get('Code repository', []):
         if any(repo.startswith(x) for x in ('@', '?')):
             continue
         repo = repo.value.split(' ')[0].strip()

developers.md

@@ -42817,6 +42817,7 @@
 ## Philip Dorrell [1]
 
 - Games: PrimeShooter
+- Home: http://thinkinghard.com/index.html
 
 ## Philip Dubé [1]
 
@@ -45686,6 +45687,7 @@
 ## Richard T. Jones [1]
 
 - Games: Bouncy the Hungry Rabbit
+- Home: http://www.mechanicalcat.net/richard, https://pyweek.org/u/richard/
 
 ## Richard Turner [1]
 

entries/2moons_browsergame_engine.md

@@ -5,7 +5,7 @@
 - Download: https://github.com/jkroepke/2Moons/releases
 - Platform: Web
 - Keyword: framework, simulation, strategy, space
-- Code repository: https://github.com/jkroepke/2Moons.git (archived, @archived, @created 2015, @stars 133, @forks 102), https://github.com/steemnova/steemnova.git @add (@created 2018, @stars 50, @forks 49)
+- Code repository: https://github.com/jkroepke/2Moons.git (@archived, @created 2015, @stars 133, @forks 102), https://github.com/steemnova/steemnova.git @add (@created 2018, @stars 50, @forks 49)
 - Code language: PHP, JavaScript
 - Code license: MIT
 - Developer: Adam Jordanek, bergi9, Casey Parker, donpepe0, Flugschwein, Gregario Mansa, Hilarious001, IntinteDAO, Jan-Otto Kröpke, louis88, Martin, mys, Ozan Kurt, Pope19, Ravikin, Roberto, sarmaticus, tatarysh, z3ll1337

entries/3d_pong.md

@@ -2,9 +2,9 @@
 
 - Home: http://www.newbreedsoftware.com/3dpong/
 - State: beta, inactive since 2004
+- Download: http://www.newbreedsoftware.com/3dpong/download/
 - Platform: Linux, macOS
 - Keyword: arcade, 3D, online
-- Code repository: @see-home
 - Code language: C
 - Code license: GPL-2.0
 - Developer: New Breed Software

entries/3dc.md

@@ -2,8 +2,8 @@
 
 - Home: https://packages.debian.org/sid/3dchess, http://www.ibiblio.org/pub/Linux/games/strategy/3Dc-0.8.1.tar.gz
 - State: mature, inactive since 2000
+- Download: https://packages.debian.org/source/sid/3dchess
 - Keyword: board, puzzle, 3D, chess, content open
-- Code repository: @see-home
 - Code language: C
 - Code license: GPL-2.0
 - Code dependency: libx, libxpm, xaw3dg

entries/4d_maze_game.md

@@ -2,9 +2,9 @@
 
 - Home: http://www.urticator.net/maze/
 - State: mature, inactive since 2008
+- Download: http://www.urticator.net/maze/download.html
 - Platform: Windows, Linux, macOS
 - Keyword: educational, puzzle, 4D, content none, maze
-- Code repository: @see-home
 - Code language: Java
 - Code license: Public domain
 - Developer: John McIntosh

entries/54321.md

@@ -3,7 +3,6 @@
 - Home: http://old.nklein.com/products/54321/
 - State: mature, inactive since 2001
 - Keyword: puzzle, content open
-- Code repository: @see-home
 - Code language: C++
 - Code license: Custom (a very simple copyleft see http://old.nklein.com/etc/copyright.php)
 - Code dependency: libpng, SDL, zlib

entries/a7xpg.md

@@ -4,7 +4,6 @@
 - State: beta, inactive since 2005
 - Download: https://sourceforge.net/projects/a7xpg/files/a7xpg/
 - Keyword: arcade, flight, space
-- Code repository: @see-home
 - Code language: D
 - Code license: 2-clause BSD
 - Code dependency: libvorbis, SDL

entries/acm.md

@@ -2,8 +2,8 @@
 
 - Home: https://packages.debian.org/sid/acm, https://web.archive.org/web/20130114223737/http://www.websimulations.com/
 - State: mature, inactive since 2000
+- Download: https://packages.debian.org/source/sid/acm
 - Keyword: action, simulation, content open, flight
-- Code repository: @see-home
 - Code language: C
 - Code license: GPL-2.0
 - Assets license: GPL-2.0

entries/adagate.md

@@ -6,7 +6,6 @@
 - Download: https://github.com/fastrgv/AdaGate/releases
 - Platform: Windows, Linux, macOS
 - Keyword: puzzle, 3D
-- Code repository: @see-download
 - Code language: Ada
 - Code license: GPL-3.0
 - Code dependency: OpenGL, SDL2

entries/adanaxis.md

@@ -2,8 +2,8 @@
 
 - Home: https://web.archive.org/web/20180818173613/http://www.mushware.com/, https://packages.qa.debian.org/a/adanaxisgpl.html
 - State: mature, inactive since 2007
+- Download: https://packages.debian.org/sid/adanaxisgpl
 - Keyword: action, 4D, content open, first-person, shooter, single-player, space
-- Code repository: @see-home
 - Code language: C++
 - Code license: GPL-2.0 (non-free file in the commercial version)
 - Code dependency: GLUT

entries/afternoon_stalker.md

@@ -6,7 +6,6 @@
 - Download: http://perso.b2b2c.ca/~sarrazip/dev/afternoonstalker.html#download
 - Platform: Linux
 - Keyword: action, remake, clone
-- Code repository: @see-download
 - Code language: C++
 - Code license: GPL-2.0
 - Code dependency: SDL

entries/airstrike.md

@@ -4,7 +4,6 @@
 - State: beta, inactive since 2014
 - Platform: Windows, Linux
 - Keyword: arcade, 2D, content open
-- Code repository: @see-home
 - Code language: C
 - Code license: GPL-2.0
 - Assets license: GPL-2.0

entries/aklabeth.md

@@ -5,7 +5,6 @@
 - State: mature, inactive since 2004
 - Download: https://sourceforge.net/projects/aklabeth/files/aklabeth/
 - Keyword: remake
-- Code repository: @see-download
 - Code language: C
 - Code license: GPL-2.0
 - Developer: kantharos, Paul Robson