update titles on all code examples pages

mattmakai · mattmakai · commit 0a8f2092f1b9 · 2019-07-20T13:33:05.000-04:00
diff --git a/content/pages/04-web-development/39-code-metrics.markdown b/content/pages/04-web-development/39-code-metrics.markdown
@@ -49,6 +49,9 @@ system are occurring.
 * [Black](https://github.com/ambv/black) is a Python code formatter with
   strong, uncompromising assumptions about how your code must be formatted.
 
+* [dlint](https://github.com/duo-labs/dlint) is a linter for secure coding
+  practices.
+
 * [pylintdb](https://github.com/nedbat/pylintdb) puts pylint results into
   a [SQLite](/sqlite.html) database for programmatic access and searching.
   Ned Batchelder coded it and wrote about how he uses the program in this 
diff --git a/content/pages/examples/django/django-conf-settings-examples.markdown b/content/pages/examples/django/django-conf-settings-examples.markdown
@@ -1,4 +1,4 @@
-title: django.conf settings Examples
+title: django.conf settings Code Examples
 category: page
 slug: django-conf-settings-examples
 sortorder: 50010
@@ -7,7 +7,6 @@ sidebartitle: django.conf settings
 meta: Python code examples for Django settings files.
 
 
-# django.conf settings Examples
 The [Django](/django.html) 
 [settings](https://docs.djangoproject.com/en/dev/topics/settings/)
 file contains all of the configuration for a web application.
diff --git a/content/pages/examples/django/django-conf-urls-url.markdown b/content/pages/examples/django/django-conf-urls-url.markdown
@@ -1,4 +1,4 @@
-title: django.conf.urls.url Examples
+title: django.conf.urls.url Code Examples
 category: page
 slug: django-conf-urls-url-examples
 sortorder: 50001
@@ -7,7 +7,6 @@ sidebartitle: django.conf.urls.url
 meta: Python code examples for the url function within the django.conf.urls module of the Django project. 
 
 
-# django.conf.urls.url Examples
 The [url](https://github.com/django/django/blob/master/django/conf/urls/__init__.py)
 function is contained with the 
 [django.conf.urls](https://github.com/django/django/tree/master/django/conf/urls) 
diff --git a/content/pages/examples/django/django-contrib-admin.markdown b/content/pages/examples/django/django-contrib-admin.markdown
@@ -1,4 +1,4 @@
-title: django.contrib.admin Examples
+title: django.contrib.admin Code Examples
 category: page
 slug: django-contrib-admin-examples
 sortorder: 50001
@@ -7,7 +7,6 @@ sidebartitle: django.contrib.admin
 meta: Python code examples for the admin module within django.contrib of the Django project. 
 
 
-# django.contrib.admin Examples
 The [Django admin](https://docs.djangoproject.com/en/2.2/ref/contrib/admin/)
 is an automatically-generated user interface for [Django models](/django-orm.html).
 The admin interface can be heavily customized and the code examples below can
diff --git a/content/pages/examples/django/django-core-exceptions-improperlyconfigured.markdown b/content/pages/examples/django/django-core-exceptions-improperlyconfigured.markdown
@@ -1,4 +1,4 @@
-title: django.core.exceptions ImproperlyConfigured Examples
+title: django.core.exceptions ImproperlyConfigured Code Examples
 category: page
 slug: django-core-exceptions-improperlyconfigured
 sortorder: 50030
@@ -7,7 +7,6 @@ sidebartitle: django.core.exceptions ImproperlyConfigured
 meta: Python code examples for the ImproperlyConfigured exception class provided by the Django codebase. 
 
 
-# django.core.exceptions ImproperlyConfigured Examples
 [ImproperlyConfigured](https://github.com/django/django/blob/master/django/core/exceptions.py)
 is a class within the [Django](/django.html) project that is thrown
 when there is a mistake in an application's settings. The exception
diff --git a/content/pages/examples/django/django-core-mail-messages-emailmessage.markdown b/content/pages/examples/django/django-core-mail-messages-emailmessage.markdown
@@ -1,4 +1,4 @@
-title: django.core.mail.messages.EmailMessage Examples
+title: django.core.mail.messages EmailMessage Code Examples
 category: page
 slug: django-core-mail-messages-emailmessage-examples
 sortorder: 50007
@@ -7,7 +7,6 @@ sidebartitle: django.core.mail.messages EmailMessage
 meta: Python code examples for the EmailMessage function within the django.core.mail module of the Django project. 
 
 
-# django.core.mail.messages.EmailMessage Examples
 The 
 [EmailMessage](https://github.com/django/django/blob/master/django/core/mail/message.py)
 class is contained with the 
diff --git a/content/pages/examples/django/django-core-mail-send-mail.markdown b/content/pages/examples/django/django-core-mail-send-mail.markdown
@@ -1,4 +1,4 @@
-title: django.core.mail.send_mail Examples
+title: django.core.mail.send_mail Code Examples
 category: page
 slug: django-core-mail-send-mail-examples
 sortorder: 50006
@@ -7,15 +7,17 @@ sidebartitle: django.core.mail.send_mail
 meta: Python code examples for the send_mail function within the django.core.mail  module of the Django project. 
 
 
-# django.core.mail.send_mail Examples
 [send_mail](https://github.com/django/django/blob/master/django/core/mail/__init__.py)
 is a function in [Django](/django.html) that can send an email
 using the [EmailMessage](/django-core-mail-messages-emailmessage-examples.html)
 class.
 
 
 ## Example 1 from apiserver
-
+[apiserver](https://github.com/renjith-tring/apiserver) is a 
+[RESTful web API](/application-programming-interfaces.html) project
+built with [Django](/django.html) for user management tasks such as 
+registration (with email verification), login, logout and password changes.
 
 [**apiserver/apps/accounts/signals.py**](https://github.com/renjith-tring/apiserver/blob/master/apps/accounts/signals.py)
 
diff --git a/content/pages/examples/django/django-core-management-base-basecommand.markdown b/content/pages/examples/django/django-core-management-base-basecommand.markdown
@@ -1,4 +1,4 @@
-title: django.core.management.base BaseCommand Examples
+title: django.core.management.base BaseCommand Code Examples
 category: page
 slug: django-core-management-base-basecommand-examples
 sortorder: 50018
@@ -7,7 +7,6 @@ sidebartitle: django.core.management.base BaseCommand
 meta: Python code examples for Django management commands.
 
 
-# django.core.management.base BaseCommand Examples
 [BaseCommand](https://github.com/django/django/blob/master/django/core/management/base.py)
 is a [Django](/django.html) object for creating new Django admin commands
 that can be invoked with the `manage.py` script. The Django project team
@@ -42,24 +41,26 @@ from filer.models.imagemodels import Image
 ~~    def handle(self, *args, **options):
         """
         Generates image thumbnails
-        NOTE: To keep memory consumption stable avoid iteration over the Image queryset
+        NOTE: To keep memory consumption stable avoid iteration 
+        over the Image queryset
         """
         pks = Image.objects.all().values_list('id', flat=True)
         total = len(pks)
         for idx, pk in enumerate(pks):
             image = None
             try:
                 image = Image.objects.get(pk=pk)
-                self.stdout.write(u'Processing image {0} / {1} {2}'.format(idx + 1, total, image))
+                self.stdout.write(u'Processing image {0} / {1} {2}'.\
+                    format(idx + 1, total, image))
                 self.stdout.flush()
                 image.thumbnails
                 image.icons
             except IOError as e:
-                self.stderr.write('Failed to generate thumbnails: {0}'.format(str(e)))
+                self.stderr.write('Failed to generate thumbnails: {0}'\
+                    .format(str(e)))
                 self.stderr.flush()
             finally:
                 del image
 ```
 
 
-
diff --git a/content/pages/examples/django/django-db-models-model.markdown b/content/pages/examples/django/django-db-models-model.markdown
@@ -1,4 +1,4 @@
-title: django.db.models.Model Examples
+title: django.db.models Model Code Examples
 category: page
 slug: django-db-models-model-examples
 sortorder: 50002
@@ -7,7 +7,6 @@ sidebartitle: django.db.models Model
 meta: Python code examples for the Model class within the django.db.models module of the Django project. 
 
 
-# django.db.models.Model Examples
 The 
 [Model](https://github.com/django/django/blob/master/django/db/models/base.py)
 class is the superclass for all data stored in [Django](/django.html) 
diff --git a/content/pages/examples/django/django-db-models-signals.markdown b/content/pages/examples/django/django-db-models-signals.markdown
@@ -1,4 +1,4 @@
-title: django.db.models.signal Examples
+title: django.db.models signal Code Examples
 category: page
 slug: django-db-models-signal-examples
 sortorder: 50005
@@ -7,7 +7,6 @@ sidebartitle: django.db.models.signal
 meta: Python code examples for database signals within a Django project. 
 
 
-# django.db.models.signal Examples
 The 
 [Signal](https://github.com/django/django/blob/master/django/db/models/signals.py)
 module allows certain senders to notify a set of receivers that some action 
diff --git a/content/pages/examples/django/django-dispatch-dispatcher-signal.markdown b/content/pages/examples/django/django-dispatch-dispatcher-signal.markdown
@@ -1,4 +1,4 @@
-title: django.dispatch Signal Examples
+title: django.dispatch Signal Code Examples
 category: page
 slug: django-dispatch-dispatcher-signal-examples
 sortorder: 50004
@@ -7,7 +7,6 @@ sidebartitle: django.dispatch Signal
 meta: Python code examples for the Signal class within the django.dispatch module of the Django project. 
 
 
-# django.dispatch Signal Examples
 The 
 [Signal](https://github.com/django/django/blob/master/django/dispatch/dispatcher.py)
 class allows certain senders to notify a set of receivers that some action 
diff --git a/content/pages/examples/django/django-forms.markdown b/content/pages/examples/django/django-forms.markdown
@@ -1,4 +1,4 @@
-title: django.forms Examples
+title: django.forms Code Examples
 category: page
 slug: django-forms-examples
 sortorder: 50015
@@ -7,7 +7,6 @@ sidebartitle: django.forms
 meta: Python code examples for the forms module in the Django open source project. 
 
 
-# django.forms Examples
 [forms](https://github.com/django/django/tree/master/django/forms) is a 
 module within the [Django](/django.html) project for safely handling user
 input in a [web application](/web-development.html).
diff --git a/content/pages/examples/django/django-urls-path.markdown b/content/pages/examples/django/django-urls-path.markdown
@@ -1,4 +1,4 @@
-title: django.urls.path Examples
+title: django.urls.path Code Examples
 category: page
 slug: django-urls-path-examples
 sortorder: 50000
@@ -7,7 +7,6 @@ sidebartitle: django.urls.path
 meta: Python code examples for the path function within the django.urls module of the Django project. 
 
 
-# django.urls.path Examples
 The [path](https://github.com/django/django/blob/master/django/urls/conf.py) 
 function is contained with the 
 [django.urls](https://github.com/django/django/tree/master/django/urls) 
diff --git a/content/pages/examples/django/django-utils-html-format-html.markdown b/content/pages/examples/django/django-utils-html-format-html.markdown
@@ -0,0 +1,160 @@
+title: django.utils.html format_html Example Code
+category: page
+slug: django-utils-html-format-html-examples
+sortorder: 50030
+toc: False
+sidebartitle: django.utils.html format_html
+meta: Python code examples for using the format_html function contained within Django's django.utils.html module.
+
+
+[format_html](https://github.com/django/django/blob/master/django/utils/html.py)
+is a function within the [Django](/django.html) project that is like
+`str.format` but for [HTML](/hypertext-markup-language-html.html) content.
+The function allows a program to safely create small HTML fragments to
+render, most likely in an output webpaage.
+
+Understanding these concepts are useful when coding with projects 
+that use Django's `format_html` function:
+
+* [Django](/django.html) and [Django templates](/django-templates.html) 
+* [Web development](/web-development.html), 
+  [web frameworks](/web-frameworks.html) and
+  [HTML](/hypertext-markup-language-html.html)
+* [Angular](/angular.html) and [JavaScript](/javascript.html)
+
+You should also view the [extensive all topics page](/table-of-contents.html)
+for additional resources.
+
+
+## Example 1 from django-angular
+[django-angular](https://github.com/jrief/django-angular) 
+([project examples website](https://django-angular.awesto.com/classic_form/))
+is a library with helper code to make it easier to use 
+[Angular](/angular.html) as the front-end to [Django](/django.html) projects.
+The code for django-angular is 
+[open source under the MIT license](https://github.com/jrief/django-angular/blob/master/LICENSE.txt).
+
+[**django-angular / djng / templatetags / djng_tags.py**](https://github.com/jrief/django-angular/blob/master/djng/templatetags/djng_tags.py)
+
+```python
+# -*- coding: utf-8 -*-
+
+from __future__ import unicode_literals
+
+import json
+
+from django.template import Library
+from django.template.base import Node, NodeList, TextNode, VariableNode
+~~from django.utils.html import format_html
+from django.utils.safestring import mark_safe
+from django.utils.translation import get_language_from_request
+
+from djng.core.urlresolvers import (get_all_remote_methods, 
+                                    get_current_remote_methods)
+
+
+register = Library()
+
+
+@register.simple_tag(name='djng_all_rmi')
+def djng_all_rmi():
+    """
+    Returns a dictionary of all methods for all Views available for 
+    this project, marked with the ``@allow_remote_invocation`` 
+    decorator. The return string can be used directly to initialize
+    the AngularJS provider, such as 
+    ``djangoRMIProvider.configure({­% djng_rmi_configs %­});``
+    """
+    return mark_safe(json.dumps(get_all_remote_methods()))
+
+
+@register.simple_tag(name='djng_current_rmi', takes_context=True)
+def djng_current_rmi(context):
+    """
+    Returns a dictionary of all methods for the current View of 
+    this request, marked with the @allow_remote_invocation decorator. 
+    The return string can be used directly to initialize the 
+    AngularJS provider, such as 
+    ``djangoRMIProvider.configure({­% djng_current_rmi %­});``
+    """
+    return mark_safe(json.dumps(get_current_remote_methods(context.get('view'))))
+
+
+@register.simple_tag(name='load_djng_urls', takes_context=True)
+def djng_urls(context, *namespaces):
+    raise DeprecationWarning(
+        "load_djng_urls templatetag is deprecated and has " + \
+        "been removed from this version of django-angular."
+        "Please refer to documentation for updated way to " + \
+        "manage django urls in angular.")
+
+
+class AngularJsNode(Node):
+    def __init__(self, django_nodelist, angular_nodelist, variable):
+        self.django_nodelist = django_nodelist
+        self.angular_nodelist = angular_nodelist
+        self.variable = variable
+
+    def render(self, context):
+        if self.variable.resolve(context):
+            return self.angular_nodelist.render(context)
+        return self.django_nodelist.render(context)
+
+
+@register.tag
+def angularjs(parser, token):
+    """
+    Conditionally switch between AngularJS and Django variable 
+    expansion for ``{{`` and ``}}`` keeping Django's expansion 
+    for ``{%`` and ``%}``
+    Usage::
+        {% angularjs 1 %} or simply {% angularjs %}
+            {% process variables through the AngularJS template engine %}
+        {% endangularjs %}
+        {% angularjs 0 %}
+            {% process variables through the Django template engine %}
+        {% endangularjs %}
+        Instead of 0 and 1, it is possible to use a context variable.
+    """
+    bits = token.contents.split()
+    if len(bits) < 2:
+        bits.append('1')
+    values = [parser.compile_filter(bit) for bit in bits[1:]]
+    django_nodelist = parser.parse(('endangularjs',))
+    angular_nodelist = NodeList()
+    for node in django_nodelist:
+        # convert all occurrences of VariableNode into a TextNode using the
+        # AngularJS double curly bracket notation
+        if isinstance(node, VariableNode):
+            # convert Django's array notation into JS array notation
+            tokens = node.filter_expression.token.split('.')
+            token = tokens[0]
+            for part in tokens[1:]:
+                if part.isdigit():
+                    token += '[%s]' % part
+                else:
+                    token += '.%s' % part
+            node = TextNode('{{ %s }}' % token)
+        angular_nodelist.append(node)
+    parser.delete_first_token()
+    return AngularJsNode(django_nodelist, angular_nodelist, values[0])
+
+
+@register.simple_tag(name='djng_locale_script', takes_context=True)
+def djng_locale_script(context, default_language='en'):
+    """
+    Returns a script tag for including the proper locale 
+    script in any HTML page. This tag determines the current 
+    language with its locale.
+    Usage:
+        <script src="{% static 'node_modules/angular-i18n/' %}
+        {% djng_locale_script %}"></script>
+    or, if used with a default language:
+        <script src="{% static 'node_modules/angular-i18n/' %}
+        {% djng_locale_script 'de' %}"></script>
+    """
+    language = get_language_from_request(context['request'])
+    if not language:
+        language = default_language
+~~    return format_html('angular-locale_{}.js', language.lower())
+```
diff --git a/content/pages/examples/django/django-utils-timezone.markdown b/content/pages/examples/django/django-utils-timezone.markdown
@@ -1,4 +1,4 @@
-title: django.utils.timezone Examples
+title: django.utils.timezone Code Examples
 category: page
 slug: django-utils-timezone-examples
 sortorder: 50020
@@ -7,7 +7,6 @@ sidebartitle: django.utils.timezone
 meta: Python code examples for timezone-related classes and functions provided by the Django codebase. 
 
 
-# django.utils.timezone Examples
 [timezone.py](https://github.com/django/django/blob/master/django/utils/timezone.py)
 is a source file within the [Django](/django.html) project that contains
 date and time-related helper classes and functions that are useful when 
diff --git a/content/pages/examples/flask/flask-sqlalchemy-model.markdown b/content/pages/examples/flask/flask-sqlalchemy-model.markdown
diff --git a/content/pages/examples/sqlalchemy/sqlalchemy-models.markdown b/content/pages/examples/sqlalchemy/sqlalchemy-models.markdown
diff --git a/theme/templates/page.html b/theme/templates/page.html
diff --git a/theme/templates/table-of-contents.html b/theme/templates/table-of-contents.html
