Rework URL information in lexers.

This commit adds a new url field to a lexer, which can be used to link
to the language website, instead of relying on having the link in either
languages.rst or the docstring of the lexer. Additionally, it changes the
languages.rst file to auto-generate the list of lexers from the actual
source code, using the provided URL.

1 files changed, 12 insertions, 1 deletions

diff --git a/doc/conf.py b/doc/conf.py
index cda21dc5..7af43e37 100644
--- a/doc/conf.py
+++ b/doc/conf.py
@@ -132,7 +132,10 @@ html_sidebars = {'index': ['indexsidebar.html', 'searchbox.html']}
 
 # Additional templates that should be rendered to pages, maps page names to
 # template names.
-html_additional_pages = {'styles': 'styles.html'}
+html_additional_pages = {
+    'styles': 'styles.html',
+    'languages': 'languages.html'
+    }
 
 if os.environ.get('WEBSITE_BUILD'):
     html_additional_pages['demo'] = 'demo.html'
@@ -232,6 +235,14 @@ def pg_context(app, pagename, templatename, ctx, event_arg):
     if pagename == 'demo':
         ctx['lexers'] = sorted(pygments.lexers.get_all_lexers(), key=lambda x: x[0].lower())
 
+    if pagename == 'languages':
+        lexer_name_url = []
+
+        for entry in sorted(pygments.lexers.LEXERS.values(), key=lambda x: x[1].lower()):
+            lexer_cls = pygments.lexers.find_lexer_class(entry[1])
+            lexer_name_url.append({'name': entry[1], 'url': lexer_cls.url})
+        ctx['languages'] = lexer_name_url
+
     if pagename in ('styles', 'demo'):
         with open('examples/example.py') as f:
             html = f.read()