document translations

aircox/templates/aircox/widgets/dates_menu.html

@@ -32,6 +32,7 @@ An empty date results to a title or a separator
                                name="date" value="{{ date|date:"Y-m-d" }}">
                     </div>
                     <div class="control">
+                        {% comment %}Translators: form button to select a date{% endcomment %}
                         <button class="button is-primary">{% trans "Go" %}</button>
                     </div>
                 </div>

aircox/templates/aircox/widgets/episode_item.html

@@ -1,13 +1,15 @@
 {% extends "aircox/widgets/page_item.html" %}
-{% load i18n easy_thumbnails_tags aircox %}
-
 {% comment %}
+List item for an episode.
+
 Context variables:
 - object: episode
 - diffusion: episode's diffusion
 - hide_schedule: if True, do not display start time
 {% endcomment %}
 
+{% load i18n easy_thumbnails_tags aircox %}
+
 {% block title %}
 {% if not object.is_published and object.program.is_published %}
 <a href="{{ object.program.get_absolute_url }}">{{ object.title }}</a>

aircox/templates/aircox/widgets/log_item.html

@@ -1,5 +1,7 @@
 {% load i18n aircox %}
 {% comment %}
+List item for a log, either for a logged track or diffusion (as diffusion).
+
 Context objects:
 - object: object to render
 - hide_schedule: if true, hide the schedule

aircox/templates/aircox/widgets/page_item.html

@@ -1,5 +1,7 @@
 {% load i18n easy_thumbnails_tags aircox %}
 {% comment %}
+List item for a page
+
 Context variables:
 - object: the object to render
 - render_card: render as card

aircox/templates/aircox/widgets/player.html

@@ -1,11 +1,14 @@
 {% load i18n %}
+{% comment %}
+The audio player
+{% endcomment %}
 
 {% if audio_streams %}
 <br>
 
 <div class="box is-fullwidth is-fixed-bottom is-paddingless player"
     role="{% trans "player" %}"
-    aria-description="{% trans "audio player used to listen to the radio" %}">
+    aria-description="{% trans "Audio player used to listen to the radio and podcasts" %}">
     <noscript>
         <audio src="{{ audio_streams.0 }}" controls>
             {% for stream in audio_streams %}

aircox/templates/aircox/widgets/podcast_item.html

@@ -1,3 +1,7 @@
+{% comment %}
+List item for a podcast.
+
+{% endcomment %}
 <div class="podcast">
     {% if object.embed %}
     {{ object.embed|safe }}

aircox/templates/aircox/widgets/track_item.html

@@ -1,4 +1,6 @@
 {% comment %}
+List item for a track
+
 Context:
 - object: track to render
 {% endcomment %}