From 0998e8aa14ea232e4db0cec93a8d4cff548ef399 Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Wed, 28 Aug 2019 23:13:44 +0530
Subject: [PATCH 01/72] initial work

---
 readthedocs/api/v2/views/footer_views.py      |  8 +++++
 readthedocs/search/admin.py                   | 11 +++++-
 .../search/migrations/0002_pageview.py        | 36 +++++++++++++++++++
 .../migrations/0003_auto_20190828_1231.py     | 20 +++++++++++
 readthedocs/search/models.py                  | 19 ++++++++++
 readthedocs/search/tasks.py                   | 25 ++++++++++++-
 6 files changed, 117 insertions(+), 2 deletions(-)
 create mode 100644 readthedocs/search/migrations/0002_pageview.py
 create mode 100644 readthedocs/search/migrations/0003_auto_20190828_1231.py

diff --git a/readthedocs/api/v2/views/footer_views.py b/readthedocs/api/v2/views/footer_views.py
index 1036ea961b1..6b44d124ee2 100644
--- a/readthedocs/api/v2/views/footer_views.py
+++ b/readthedocs/api/v2/views/footer_views.py
@@ -16,6 +16,7 @@
     highest_version,
     parse_version_failsafe,
 )
+from readthedocs.search.tasks import increase_page_view_count
 
 
 def get_version_compare_data(project, base_version=None):
@@ -163,6 +164,13 @@ def footer_html(request):
         'version_supported': version.supported,
     }
 
+    # increase the page view count
+    increase_page_view_count.delay(
+        project=context['project'],
+        version=context['version'],
+        path=context['path'] if context['path'] else 'index.html'
+    )
+
     # Allow folks to hook onto the footer response for various information
     # collection, or to modify the resp_data.
     footer_response.send(
diff --git a/readthedocs/search/admin.py b/readthedocs/search/admin.py
index 77a11e798f9..dce251a6197 100644
--- a/readthedocs/search/admin.py
+++ b/readthedocs/search/admin.py
@@ -2,7 +2,7 @@
 
 from django.contrib import admin
 
-from .models import SearchQuery
+from .models import SearchQuery, PageView
 
 
 class SearchQueryAdmin(admin.ModelAdmin):
@@ -14,4 +14,13 @@ class SearchQueryAdmin(admin.ModelAdmin):
     list_select_related = ('project', 'version', 'version__project')
 
 
+class PageViewAdmin(admin.ModelAdmin):
+    raw_id_fields = ('project', 'version')
+    list_display = ('__str__', 'view_count')
+    search_fields = ('project__slug', 'version__slug', 'path')
+    readonly_fields = ('created', 'modified')
+    list_select_related = ('project', 'version', 'version__project')
+
+
 admin.site.register(SearchQuery, SearchQueryAdmin)
+admin.site.register(PageView, PageViewAdmin)
diff --git a/readthedocs/search/migrations/0002_pageview.py b/readthedocs/search/migrations/0002_pageview.py
new file mode 100644
index 00000000000..eb562aa0608
--- /dev/null
+++ b/readthedocs/search/migrations/0002_pageview.py
@@ -0,0 +1,36 @@
+# -*- coding: utf-8 -*-
+# Generated by Django 1.11.23 on 2019-08-28 12:14
+from __future__ import unicode_literals
+
+from django.db import migrations, models
+import django.db.models.deletion
+import django_extensions.db.fields
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('builds', '0010_add-description-field-to-automation-rule'),
+        ('projects', '0044_auto_20190703_1300'),
+        ('search', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='PageView',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('created', django_extensions.db.fields.CreationDateTimeField(auto_now_add=True, verbose_name='created')),
+                ('modified', django_extensions.db.fields.ModificationDateTimeField(auto_now=True, verbose_name='modified')),
+                ('path', models.CharField(max_length=4096)),
+                ('view_count', models.PositiveIntegerField(default=0)),
+                ('project', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='page_views', to='projects.Project')),
+                ('version', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='page_views', to='builds.Version', verbose_name='Version')),
+            ],
+            options={
+                'ordering': ('-modified', '-created'),
+                'get_latest_by': 'modified',
+                'abstract': False,
+            },
+        ),
+    ]
diff --git a/readthedocs/search/migrations/0003_auto_20190828_1231.py b/readthedocs/search/migrations/0003_auto_20190828_1231.py
new file mode 100644
index 00000000000..c69a944e218
--- /dev/null
+++ b/readthedocs/search/migrations/0003_auto_20190828_1231.py
@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+# Generated by Django 1.11.23 on 2019-08-28 12:31
+from __future__ import unicode_literals
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('search', '0002_pageview'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='pageview',
+            name='view_count',
+            field=models.PositiveIntegerField(default=1),
+        ),
+    ]
diff --git a/readthedocs/search/models.py b/readthedocs/search/models.py
index 45f13640294..fc45ac6b1c6 100644
--- a/readthedocs/search/models.py
+++ b/readthedocs/search/models.py
@@ -137,3 +137,22 @@ def generate_distribution_of_top_queries(cls, project_slug, n):
             final_data['int_data'].append(count_of_other)
 
         return final_data
+
+
+class PageView(TimeStampedModel):
+    project = models.ForeignKey(
+        Project,
+        related_name='page_views',
+        on_delete=models.CASCADE,
+    )
+    version = models.ForeignKey(
+        Version,
+        verbose_name=_('Version'),
+        related_name='page_views',
+        on_delete=models.CASCADE,
+    )
+    path = models.CharField(max_length=4096)
+    view_count = models.PositiveIntegerField(default=1)
+
+    def __str__(self):
+        return f'[{self.project.slug}:{self.version.slug}]: {self.path}'
diff --git a/readthedocs/search/tasks.py b/readthedocs/search/tasks.py
index 0057f90b497..cd333b97627 100644
--- a/readthedocs/search/tasks.py
+++ b/readthedocs/search/tasks.py
@@ -6,7 +6,7 @@
 
 from readthedocs.builds.models import Version
 from readthedocs.projects.models import Project
-from readthedocs.search.models import SearchQuery
+from readthedocs.search.models import SearchQuery, PageView
 from readthedocs.worker import app
 from .utils import _get_index, _get_document
 
@@ -176,3 +176,26 @@ def record_search_query(project_slug, version_slug, query, total_results):
         version=version,
         query=query,
     )
+
+
+@app.task(queue='web')
+def increase_page_view_count(project_slug, version_slug, path):
+    today_date = timezone.now().date()
+    page_view_obj = PageView.objects.filter(
+        project__slug=project_slug,
+        version__slug=version_slug,
+        path=path,
+        created__date=today_date,
+    ).first()
+
+    if page_view_obj:
+        page_view_obj.view_count += 1
+        page_view_obj.save()
+    else:
+        project_obj = Project.objects.get(slug=project_slug)
+        version_obj = Version.objects.get(slug=version_slug, project=project_obj)
+        PageView.objects.create(
+            project=project_obj,
+            version=version_obj,
+            path=path,
+        )

From 3e8a99a1e3ea83f1da3d7caffe2526a75c497f1f Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Thu, 29 Aug 2019 23:30:17 +0530
Subject: [PATCH 02/72] fix arguments

---
 readthedocs/search/tasks.py | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/readthedocs/search/tasks.py b/readthedocs/search/tasks.py
index cd333b97627..5d52b3cf547 100644
--- a/readthedocs/search/tasks.py
+++ b/readthedocs/search/tasks.py
@@ -179,11 +179,11 @@ def record_search_query(project_slug, version_slug, query, total_results):
 
 
 @app.task(queue='web')
-def increase_page_view_count(project_slug, version_slug, path):
+def increase_page_view_count(project, version, path):
     today_date = timezone.now().date()
     page_view_obj = PageView.objects.filter(
-        project__slug=project_slug,
-        version__slug=version_slug,
+        project=project,
+        version=version,
         path=path,
         created__date=today_date,
     ).first()
@@ -192,10 +192,8 @@ def increase_page_view_count(project_slug, version_slug, path):
         page_view_obj.view_count += 1
         page_view_obj.save()
     else:
-        project_obj = Project.objects.get(slug=project_slug)
-        version_obj = Version.objects.get(slug=version_slug, project=project_obj)
         PageView.objects.create(
-            project=project_obj,
-            version=version_obj,
+            project=project,
+            version=version,
             path=path,
         )

From f5c82cf34bd0a19b9710322942d9e215b29e4ffb Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Thu, 29 Aug 2019 23:48:54 +0530
Subject: [PATCH 03/72] update migration file

---
 ...eview.py => 0002_create_pageview_model.py} |  6 +++---
 .../migrations/0003_auto_20190828_1231.py     | 20 -------------------
 2 files changed, 3 insertions(+), 23 deletions(-)
 rename readthedocs/search/migrations/{0002_pageview.py => 0002_create_pageview_model.py} (96%)
 delete mode 100644 readthedocs/search/migrations/0003_auto_20190828_1231.py

diff --git a/readthedocs/search/migrations/0002_pageview.py b/readthedocs/search/migrations/0002_create_pageview_model.py
similarity index 96%
rename from readthedocs/search/migrations/0002_pageview.py
rename to readthedocs/search/migrations/0002_create_pageview_model.py
index eb562aa0608..8284a80660a 100644
--- a/readthedocs/search/migrations/0002_pageview.py
+++ b/readthedocs/search/migrations/0002_create_pageview_model.py
@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Generated by Django 1.11.23 on 2019-08-28 12:14
+# Generated by Django 1.11.23 on 2019-08-29 18:07
 from __future__ import unicode_literals
 
 from django.db import migrations, models
@@ -10,8 +10,8 @@
 class Migration(migrations.Migration):
 
     dependencies = [
-        ('builds', '0010_add-description-field-to-automation-rule'),
         ('projects', '0044_auto_20190703_1300'),
+        ('builds', '0010_add-description-field-to-automation-rule'),
         ('search', '0001_initial'),
     ]
 
@@ -23,7 +23,7 @@ class Migration(migrations.Migration):
                 ('created', django_extensions.db.fields.CreationDateTimeField(auto_now_add=True, verbose_name='created')),
                 ('modified', django_extensions.db.fields.ModificationDateTimeField(auto_now=True, verbose_name='modified')),
                 ('path', models.CharField(max_length=4096)),
-                ('view_count', models.PositiveIntegerField(default=0)),
+                ('view_count', models.PositiveIntegerField(default=1)),
                 ('project', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='page_views', to='projects.Project')),
                 ('version', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='page_views', to='builds.Version', verbose_name='Version')),
             ],
diff --git a/readthedocs/search/migrations/0003_auto_20190828_1231.py b/readthedocs/search/migrations/0003_auto_20190828_1231.py
deleted file mode 100644
index c69a944e218..00000000000
--- a/readthedocs/search/migrations/0003_auto_20190828_1231.py
+++ /dev/null
@@ -1,20 +0,0 @@
-# -*- coding: utf-8 -*-
-# Generated by Django 1.11.23 on 2019-08-28 12:31
-from __future__ import unicode_literals
-
-from django.db import migrations, models
-
-
-class Migration(migrations.Migration):
-
-    dependencies = [
-        ('search', '0002_pageview'),
-    ]
-
-    operations = [
-        migrations.AlterField(
-            model_name='pageview',
-            name='view_count',
-            field=models.PositiveIntegerField(default=1),
-        ),
-    ]

From 9b03012a18568ec44d736cbadcda4d88bf37b88d Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Tue, 3 Sep 2019 20:20:51 +0530
Subject: [PATCH 04/72] show top 10 viewed page to the users.

---
 readthedocs/projects/urls/private.py          |  4 ++
 readthedocs/projects/views/private.py         | 26 +++++++++-
 readthedocs/search/models.py                  | 40 +++++++++++++-
 .../templates/projects/project_edit_base.html |  1 +
 .../projects/project_page_views.html          | 52 +++++++++++++++++++
 5 files changed, 121 insertions(+), 2 deletions(-)
 create mode 100644 readthedocs/templates/projects/project_page_views.html

diff --git a/readthedocs/projects/urls/private.py b/readthedocs/projects/urls/private.py
index d9df7a3f970..cb2c714aa8e 100644
--- a/readthedocs/projects/urls/private.py
+++ b/readthedocs/projects/urls/private.py
@@ -109,6 +109,10 @@
         r'^(?P<project_slug>[-\w]+)/search-analytics/$',
         private.search_analytics_view, name='projects_search_analytics',
     ),
+    url(
+        r'^(?P<project_slug>[-\w]+)/page-views/$',
+        private.page_views, name='projects_page_views',
+    ),
 ]
 
 domain_urls = [
diff --git a/readthedocs/projects/views/private.py b/readthedocs/projects/views/private.py
index c20d3a088c8..a2cd3e25b94 100644
--- a/readthedocs/projects/views/private.py
+++ b/readthedocs/projects/views/private.py
@@ -64,7 +64,7 @@
 from readthedocs.projects.utils import Echo
 from readthedocs.projects.views.base import ProjectAdminMixin, ProjectSpamMixin
 from readthedocs.projects.views.mixins import ProjectImportMixin
-from readthedocs.search.models import SearchQuery
+from readthedocs.search.models import SearchQuery, PageView
 
 from ..tasks import retry_domain_verification
 
@@ -1020,3 +1020,27 @@ def _search_analytics_csv_data(request, project_slug):
     )
     response['Content-Disposition'] = f'attachment; filename="{file_name}"'
     return response
+
+
+def page_views(request, project_slug):
+    """View for page views."""
+
+    project = get_object_or_404(
+        Project.objects.for_admin_user(request.user),
+        slug=project_slug,
+    )
+
+    top_viewed_pages = PageView.get_top_viewed_pages(project)
+    top_viewed_pages_iter = zip(
+        top_viewed_pages['pages'],
+        top_viewed_pages['view_counts']
+    )
+
+    return render(
+        request,
+        'projects/project_page_views.html',
+        {
+            'project': project,
+            'top_viewed_pages_iter': top_viewed_pages_iter,
+        },
+    )
diff --git a/readthedocs/search/models.py b/readthedocs/search/models.py
index fc45ac6b1c6..8bc7e8d2af2 100644
--- a/readthedocs/search/models.py
+++ b/readthedocs/search/models.py
@@ -1,7 +1,7 @@
 """Search Queries."""
 
 from django.db import models
-from django.db.models import Count
+from django.db.models import Count, Sum
 from django.db.models.functions import TruncDate
 from django.utils import timezone
 from django.utils.translation import ugettext_lazy as _
@@ -156,3 +156,41 @@ class PageView(TimeStampedModel):
 
     def __str__(self):
         return f'[{self.project.slug}:{self.version.slug}]: {self.path}'
+
+    @classmethod
+    def get_top_viewed_pages(cls, project):
+        """
+        Returns top 10 pages according to view counts.
+
+        Structure of returned data is compatible to make graphs.
+        Sample returned data::
+        {
+            'pages': ['index.html', 'contribute.html', 'sponsors.html'],
+            'view_counts': [150, 200, 143]
+        }
+        This data shows that `index.html` is the most viewed page having 150 total views,
+        followed by `contribute.html` and `sponsors.html` having 200 and
+        143 total page views respectively.
+        """
+        qs = (
+            cls.objects
+            .filter(project=project)
+            .values_list('path')
+            .annotate(total_views=Sum('view_count'))
+            .values_list('path', 'total_views')
+            .order_by('-total_views')[:10]
+        )
+
+        pages = []
+        view_counts = []
+
+        for data in qs.iterator():
+            pages.append(data[0])
+            view_counts.append(data[1])
+
+        final_data = {
+            'pages': pages,
+            'view_counts': view_counts,
+        }
+
+        return final_data
diff --git a/readthedocs/templates/projects/project_edit_base.html b/readthedocs/templates/projects/project_edit_base.html
index e7fa71af179..8abf01537e9 100644
--- a/readthedocs/templates/projects/project_edit_base.html
+++ b/readthedocs/templates/projects/project_edit_base.html
@@ -25,6 +25,7 @@
         <li class="{% block project-environment-variables-active %}{% endblock %}"><a href="{% url "projects_environmentvariables" project.slug %}">{% trans "Environment Variables" %}</a></li>
         <li class="{% block project-notifications-active %}{% endblock %}"><a href="{% url "projects_notifications" project.slug %}">{% trans "Notifications" %}</a></li>
         <li class="{% block project-search-analytics-active %}{% endblock %}"><a href="{% url "projects_search_analytics" project.slug %}">{% trans "Search Analytics" %}</a></li>
+        <li class="{% block project-page-views-active %}{% endblock %}"><a href="{% url "projects_page_views" project.slug %}">{% trans "Page Views" %}</a></li>
         {% if USE_PROMOS %}
           <li class="{% block project-ads-active %}{% endblock %}"><a href="{% url "projects_advertising" project.slug %}">{% trans "Advertising" %} </a></li>
         {% endif %}
diff --git a/readthedocs/templates/projects/project_page_views.html b/readthedocs/templates/projects/project_page_views.html
new file mode 100644
index 00000000000..b2f168f78d3
--- /dev/null
+++ b/readthedocs/templates/projects/project_page_views.html
@@ -0,0 +1,52 @@
+{% extends "projects/project_edit_base.html" %}
+
+{% load i18n %}
+{% load static %}
+
+{% block title %}{% trans "Page Views" %}{% endblock %}
+
+{% block nav-dashboard %} class="active"{% endblock %}
+
+{% block project-page-views-active %}active{% endblock %}
+{% block project_edit_content_header %}{% trans "Page Views" %}{% endblock %}
+
+{% block project_edit_content %}
+	<h3>{% trans "Top Viewed Pages" %}</h3>
+		<div class="module-list">
+      <div class="module-list-wrapper">
+        <ul class="long-list-overflow">
+          {% for page, count in top_viewed_pages_iter %}
+            <li class="module-item">
+              {{ page }}
+              <span class="right quiet">
+                {{ count }} {{ view|pluralize:"s" }}
+              </span>
+            </li>
+          {% empty %}
+            <li class="module-item">
+              <p class="quiet">
+                {% trans 'No date available.' %}
+              </p>
+            </li>
+          {% endfor %}
+        </ul>
+      </div>
+    </div>
+
+	<br/>
+
+	<h2>{% trans "Page Views Per Page" %}</h2>
+	<canvas id="page-views-per-page" width="400" height="150"></canvas>
+
+{% endblock %}
+
+{% block extra_scripts %}
+{% endblock %}
+
+{% block extra_links %}
+  <!-- Chart.js v2.8.0 -->
+  <link rel="stylesheet" href="{% static 'vendor/chartjs/chartjs.min.css' %}">
+{% endblock %}
+
+{% block footerjs %}
+{% endblock %}

From f3894768f44b97259f67f8746601a255fcb72158 Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Sun, 8 Sep 2019 13:21:00 +0530
Subject: [PATCH 05/72] initial work for showing graphs to the user

---
 readthedocs/projects/views/private.py         | 15 +++++++
 readthedocs/search/models.py                  | 41 ++++++++++++++++---
 readthedocs/search/utils.py                   | 22 +++++++++-
 .../projects/project_page_views.html          | 26 ++++++++++++
 4 files changed, 98 insertions(+), 6 deletions(-)

diff --git a/readthedocs/projects/views/private.py b/readthedocs/projects/views/private.py
index a2cd3e25b94..a8a5a39c870 100644
--- a/readthedocs/projects/views/private.py
+++ b/readthedocs/projects/views/private.py
@@ -1036,11 +1036,26 @@ def page_views(request, project_slug):
         top_viewed_pages['view_counts']
     )
 
+    all_pages = PageView.objects.filter(project=project).values_list('path', flat=True)
+    if all_pages.exists():
+        all_pages = sorted(list(set(all_pages)))
+        page_path = request.GET.get('page', all_pages[0])
+    else:
+        all_pages = []
+        page_path = ''
+
+    page_data = PageView.get_page_view_count_of_one_month(
+        project_slug=project.slug,
+        page_path=page_path
+    )
     return render(
         request,
         'projects/project_page_views.html',
         {
             'project': project,
             'top_viewed_pages_iter': top_viewed_pages_iter,
+            'page_data': page_data,
+            'page_path': page_path,
+            'all_pages': all_pages,
         },
     )
diff --git a/readthedocs/search/models.py b/readthedocs/search/models.py
index 8bc7e8d2af2..63574a3d541 100644
--- a/readthedocs/search/models.py
+++ b/readthedocs/search/models.py
@@ -11,6 +11,7 @@
 from readthedocs.builds.models import Version
 from readthedocs.projects.models import Project
 from readthedocs.projects.querysets import RelatedProjectQuerySet
+from readthedocs.search.utils import _get_last_31_days_iter, _get_last_31_days_str
 
 
 class SearchQuery(TimeStampedModel):
@@ -59,7 +60,7 @@ def generate_queries_count_of_one_month(cls, project_slug):
         last_30th_day = timezone.now().date() - timezone.timedelta(days=30)
 
         # this includes the current day also
-        last_31_days_iter = [last_30th_day + timezone.timedelta(days=n) for n in range(31)]
+        last_31_days_iter = _get_last_31_days_iter()
 
         qs = cls.objects.filter(
             project__slug=project_slug,
@@ -81,10 +82,7 @@ def generate_queries_count_of_one_month(cls, project_slug):
 
         # format the date value to a more readable form
         # Eg. `16 Jul`
-        last_31_days_str = [
-            timezone.datetime.strftime(date, '%d %b')
-            for date in last_31_days_iter
-        ]
+        last_31_days_str = _get_last_31_days_str()
 
         final_data = {
             'labels': last_31_days_str,
@@ -194,3 +192,36 @@ def get_top_viewed_pages(cls, project):
         }
 
         return final_data
+
+    @classmethod
+    def get_page_view_count_of_one_month(cls, project_slug, page_path):
+        today = timezone.now().date()
+        last_30th_day = timezone.now().date() - timezone.timedelta(days=30)
+
+        # this includes the current day also
+        last_31_days_iter = _get_last_31_days_iter()
+
+        qs = cls.objects.filter(
+            project__slug=project_slug,
+            path=page_path,
+        ).order_by('-created')
+
+        count_dict = dict(
+            qs.annotate(created_date=TruncDate('created'))
+            .values('created_date')
+            .order_by('created_date')
+            .values_list('created_date', 'view_count')
+        )
+
+        count_data = [count_dict.get(date) or 0 for date in last_31_days_iter]
+
+        # format the date value to a more readable form
+        # Eg. `16 Jul`
+        last_31_days_str = _get_last_31_days_str()
+
+        final_data = {
+            'labels': last_31_days_str,
+            'int_data': count_data,
+        }
+
+        return final_data
diff --git a/readthedocs/search/utils.py b/readthedocs/search/utils.py
index a747c45f115..0e548842c94 100644
--- a/readthedocs/search/utils.py
+++ b/readthedocs/search/utils.py
@@ -3,13 +3,13 @@
 import logging
 from operator import attrgetter
 
+from django.utils import timezone
 from django.shortcuts import get_object_or_404
 from django_elasticsearch_dsl.apps import DEDConfig
 from django_elasticsearch_dsl.registries import registry
 
 from readthedocs.builds.models import Version
 from readthedocs.projects.models import HTMLFile, Project
-from readthedocs.search.documents import PageDocument
 
 
 log = logging.getLogger(__name__)
@@ -132,6 +132,7 @@ def _indexing_helper(html_objs_qs, wipe=False):
     If ``wipe`` is set to False, html_objs are deleted from the ES index,
     else, html_objs are indexed.
     """
+    from readthedocs.search.documents import PageDocument
     from readthedocs.search.tasks import index_objects_to_es, delete_objects_in_es
 
     if html_objs_qs:
@@ -168,3 +169,22 @@ def _get_sorted_results(results, source_key='_source'):
     ]
 
     return sorted_results
+
+
+def _get_last_31_days_iter():
+    today = timezone.now().date()
+    last_30th_day = timezone.now().date() - timezone.timedelta(days=30)
+
+    # this includes the current day also
+    last_31_days_iter = [last_30th_day + timezone.timedelta(days=n) for n in range(31)]
+    return last_31_days_iter
+
+
+def _get_last_31_days_str():
+    last_31_days_iter = _get_last_31_days_iter()
+    last_31_days_str = [
+        timezone.datetime.strftime(date, '%d %b')
+        for date in last_31_days_iter
+    ]
+    return last_31_days_str
+
diff --git a/readthedocs/templates/projects/project_page_views.html b/readthedocs/templates/projects/project_page_views.html
index b2f168f78d3..cb875f97ab2 100644
--- a/readthedocs/templates/projects/project_page_views.html
+++ b/readthedocs/templates/projects/project_page_views.html
@@ -36,11 +36,20 @@ <h3>{% trans "Top Viewed Pages" %}</h3>
 	<br/>
 
 	<h2>{% trans "Page Views Per Page" %}</h2>
+  <form method="GET">
+    <select name="page" onchange="this.form.submit()">
+      {% for option in all_pages %}
+        <option value="{{ option }}" {% if page_path == option %}selected{% endif %}>{{ option }}</option>
+      {% endfor %}
+    </select>
+  </form>
 	<canvas id="page-views-per-page" width="400" height="150"></canvas>
 
 {% endblock %}
 
 {% block extra_scripts %}
+  <!-- Chart.js v2.8.0 -->
+  <script src="{% static 'vendor/chartjs/chartjs.bundle.min.js' %}"></script>
 {% endblock %}
 
 {% block extra_links %}
@@ -49,4 +58,21 @@ <h2>{% trans "Page Views Per Page" %}</h2>
 {% endblock %}
 
 {% block footerjs %}
+  var line_chart = document.getElementById("page-views-per-page").getContext("2d");
+  var line_chart_labels = {{ page_data.labels|safe }};
+  var line_chart_data = {{ page_data.int_data|safe }};
+
+  var line_chart = new Chart(line_chart, {
+    type: "line",
+    data: {
+      labels: line_chart_labels,
+      datasets: [{
+        label: "# of views for {{ page_path }}",
+        data: line_chart_data,
+        fill: false,
+        borderColor: "rgba(75, 192, 192, 1)",
+        pointBorderColor: "rgba(75, 192, 192, 1)",
+      }]
+    },
+  });
 {% endblock %}

From a19823f7e1377514958f949814ea0043ef8dded7 Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Wed, 18 Sep 2019 11:50:51 +0530
Subject: [PATCH 06/72] show pageviews for a specific page

---
 readthedocs/api/v2/views/footer_views.py      |  4 ++--
 readthedocs/search/admin.py                   |  2 +-
 ...del.py => 0002_create_page_views_model.py} | 13 +++-------
 readthedocs/search/models.py                  | 24 ++++++++++++++-----
 readthedocs/search/tasks.py                   | 11 +++++----
 5 files changed, 31 insertions(+), 23 deletions(-)
 rename readthedocs/search/migrations/{0002_create_pageview_model.py => 0002_create_page_views_model.py} (67%)

diff --git a/readthedocs/api/v2/views/footer_views.py b/readthedocs/api/v2/views/footer_views.py
index 8c562275cee..f0cc5cb7b85 100644
--- a/readthedocs/api/v2/views/footer_views.py
+++ b/readthedocs/api/v2/views/footer_views.py
@@ -213,8 +213,8 @@ def get(self, request, format=None):
 
         # increase the page view count
         increase_page_view_count.delay(
-            project=context['project'],
-            version=context['version'],
+            project_slug=context['project'].slug,
+            version_slug=context['version'].slug,
             path=context['path'] if context['path'] else 'index.html'
         )
 
diff --git a/readthedocs/search/admin.py b/readthedocs/search/admin.py
index dce251a6197..80b88d0d75b 100644
--- a/readthedocs/search/admin.py
+++ b/readthedocs/search/admin.py
@@ -18,7 +18,7 @@ class PageViewAdmin(admin.ModelAdmin):
     raw_id_fields = ('project', 'version')
     list_display = ('__str__', 'view_count')
     search_fields = ('project__slug', 'version__slug', 'path')
-    readonly_fields = ('created', 'modified')
+    readonly_fields = ('date',)
     list_select_related = ('project', 'version', 'version__project')
 
 
diff --git a/readthedocs/search/migrations/0002_create_pageview_model.py b/readthedocs/search/migrations/0002_create_page_views_model.py
similarity index 67%
rename from readthedocs/search/migrations/0002_create_pageview_model.py
rename to readthedocs/search/migrations/0002_create_page_views_model.py
index 8284a80660a..8352ea28791 100644
--- a/readthedocs/search/migrations/0002_create_pageview_model.py
+++ b/readthedocs/search/migrations/0002_create_page_views_model.py
@@ -1,17 +1,16 @@
 # -*- coding: utf-8 -*-
-# Generated by Django 1.11.23 on 2019-08-29 18:07
+# Generated by Django 1.11.24 on 2019-09-18 06:11
 from __future__ import unicode_literals
 
 from django.db import migrations, models
 import django.db.models.deletion
-import django_extensions.db.fields
 
 
 class Migration(migrations.Migration):
 
     dependencies = [
-        ('projects', '0044_auto_20190703_1300'),
         ('builds', '0010_add-description-field-to-automation-rule'),
+        ('projects', '0044_auto_20190703_1300'),
         ('search', '0001_initial'),
     ]
 
@@ -20,17 +19,11 @@ class Migration(migrations.Migration):
             name='PageView',
             fields=[
                 ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
-                ('created', django_extensions.db.fields.CreationDateTimeField(auto_now_add=True, verbose_name='created')),
-                ('modified', django_extensions.db.fields.ModificationDateTimeField(auto_now=True, verbose_name='modified')),
                 ('path', models.CharField(max_length=4096)),
                 ('view_count', models.PositiveIntegerField(default=1)),
+                ('date', models.DateField()),
                 ('project', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='page_views', to='projects.Project')),
                 ('version', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='page_views', to='builds.Version', verbose_name='Version')),
             ],
-            options={
-                'ordering': ('-modified', '-created'),
-                'get_latest_by': 'modified',
-                'abstract': False,
-            },
         ),
     ]
diff --git a/readthedocs/search/models.py b/readthedocs/search/models.py
index 63574a3d541..8245061f53e 100644
--- a/readthedocs/search/models.py
+++ b/readthedocs/search/models.py
@@ -137,7 +137,7 @@ def generate_distribution_of_top_queries(cls, project_slug, n):
         return final_data
 
 
-class PageView(TimeStampedModel):
+class PageView(models.Model):
     project = models.ForeignKey(
         Project,
         related_name='page_views',
@@ -151,6 +151,7 @@ class PageView(TimeStampedModel):
     )
     path = models.CharField(max_length=4096)
     view_count = models.PositiveIntegerField(default=1)
+    date = models.DateField()
 
     def __str__(self):
         return f'[{self.project.slug}:{self.version.slug}]: {self.path}'
@@ -195,6 +196,18 @@ def get_top_viewed_pages(cls, project):
 
     @classmethod
     def get_page_view_count_of_one_month(cls, project_slug, page_path):
+        """
+        Returns the total page views count for last 30 days (including today) for a particular `page_path`.
+
+        Structure of returned data is compatible to make graphs.
+        Sample returned data::
+            {
+                'labels': ['01 Jul', '02 Jul', '03 Jul'],
+                'int_data': [150, 200, 143]
+            }
+        This data shows that there were 150 page views on 01 July,
+        200 page views on 02 July and 143 page views on 03 July for a particular `page_path`.
+        """
         today = timezone.now().date()
         last_30th_day = timezone.now().date() - timezone.timedelta(days=30)
 
@@ -204,13 +217,12 @@ def get_page_view_count_of_one_month(cls, project_slug, page_path):
         qs = cls.objects.filter(
             project__slug=project_slug,
             path=page_path,
-        ).order_by('-created')
+        ).order_by('-date')
 
         count_dict = dict(
-            qs.annotate(created_date=TruncDate('created'))
-            .values('created_date')
-            .order_by('created_date')
-            .values_list('created_date', 'view_count')
+            qs.values('date')
+            .order_by('date')
+            .values_list('date', 'view_count')
         )
 
         count_data = [count_dict.get(date) or 0 for date in last_31_days_iter]
diff --git a/readthedocs/search/tasks.py b/readthedocs/search/tasks.py
index 36c81e02c11..ebece39f744 100644
--- a/readthedocs/search/tasks.py
+++ b/readthedocs/search/tasks.py
@@ -215,21 +215,24 @@ def record_search_query(project_slug, version_slug, query, total_results, time_s
 
 
 @app.task(queue='web')
-def increase_page_view_count(project, version, path):
+def increase_page_view_count(project_slug, version_slug, path):
     today_date = timezone.now().date()
     page_view_obj = PageView.objects.filter(
-        project=project,
-        version=version,
+        project__slug=project_slug,
+        version__slug=version_slug,
         path=path,
-        created__date=today_date,
+        date=today_date,
     ).first()
 
     if page_view_obj:
         page_view_obj.view_count += 1
         page_view_obj.save()
     else:
+        project = Project.objects.get(slug=project_slug)
+        version = Version.objects.get(project=project, slug=version_slug)
         PageView.objects.create(
             project=project,
             version=version,
             path=path,
+            date=today_date,
         )

From a1d0a9b55a65ae55a0adcd1045561e08746f325b Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Wed, 2 Oct 2019 22:27:35 +0530
Subject: [PATCH 07/72] change view to class based view

---
 readthedocs/projects/urls/private.py  |  3 +-
 readthedocs/projects/views/private.py | 57 +++++++++++++--------------
 2 files changed, 30 insertions(+), 30 deletions(-)

diff --git a/readthedocs/projects/urls/private.py b/readthedocs/projects/urls/private.py
index 114fa153eb0..2f68ec67138 100644
--- a/readthedocs/projects/urls/private.py
+++ b/readthedocs/projects/urls/private.py
@@ -23,6 +23,7 @@
     IntegrationExchangeDetail,
     IntegrationList,
     IntegrationWebhookSync,
+    PageViewAdmin,
     ProjectAdvancedUpdate,
     ProjectAdvertisingUpdate,
     ProjectDashboard,
@@ -116,7 +117,7 @@
     ),
     url(
         r'^(?P<project_slug>[-\w]+)/page-views/$',
-        private.page_views, name='projects_page_views',
+        PageViewAdmin.as_view(), name='projects_page_views',
     ),
 ]
 
diff --git a/readthedocs/projects/views/private.py b/readthedocs/projects/views/private.py
index 8e306ce69f9..0cd4a7b528b 100644
--- a/readthedocs/projects/views/private.py
+++ b/readthedocs/projects/views/private.py
@@ -1004,40 +1004,39 @@ def _search_analytics_csv_data(request, project_slug):
     return response
 
 
-def page_views(request, project_slug):
-    """View for page views."""
+class PageViewAdmin(ProjectAdminMixin, PrivateViewMixin, TemplateView):
 
-    project = get_object_or_404(
-        Project.objects.for_admin_user(request.user),
-        slug=project_slug,
-    )
+    template_name = 'projects/project_page_views.html'
+    http_method_names = ['get']
 
-    top_viewed_pages = PageView.get_top_viewed_pages(project)
-    top_viewed_pages_iter = zip(
-        top_viewed_pages['pages'],
-        top_viewed_pages['view_counts']
-    )
+    def get_context_data(self, **kwargs):
+        context = super().get_context_data(**kwargs)
+        project = self.get_project()
 
-    all_pages = PageView.objects.filter(project=project).values_list('path', flat=True)
-    if all_pages.exists():
-        all_pages = sorted(list(set(all_pages)))
-        page_path = request.GET.get('page', all_pages[0])
-    else:
-        all_pages = []
-        page_path = ''
+        top_viewed_pages = PageView.get_top_viewed_pages(project)
+        top_viewed_pages_iter = zip(
+            top_viewed_pages['pages'],
+            top_viewed_pages['view_counts']
+        )
 
-    page_data = PageView.get_page_view_count_of_one_month(
-        project_slug=project.slug,
-        page_path=page_path
-    )
-    return render(
-        request,
-        'projects/project_page_views.html',
-        {
-            'project': project,
+        all_pages = PageView.objects.filter(project=project).values_list('path', flat=True)
+        if all_pages.exists():
+            all_pages = sorted(list(set(all_pages)))
+            page_path = self.request.GET.get('page', all_pages[0])
+        else:
+            all_pages = []
+            page_path = ''
+
+        page_data = PageView.get_page_view_count_of_one_month(
+            project_slug=project.slug,
+            page_path=page_path
+        )
+
+        context.update({
             'top_viewed_pages_iter': top_viewed_pages_iter,
             'page_data': page_data,
             'page_path': page_path,
             'all_pages': all_pages,
-        },
-    )
+        })
+
+        return context

From 415a3b31770d5b89d2f839f2663f5641f87ed63a Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Fri, 4 Oct 2019 00:54:03 +0530
Subject: [PATCH 08/72] fix lint

---
 readthedocs/search/utils.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/readthedocs/search/utils.py b/readthedocs/search/utils.py
index 0e548842c94..69c1c42b993 100644
--- a/readthedocs/search/utils.py
+++ b/readthedocs/search/utils.py
@@ -187,4 +187,3 @@ def _get_last_31_days_str():
         for date in last_31_days_iter
     ]
     return last_31_days_str
-

From 2073a823bfb91cd03a9a1f6e2df6783317603d6f Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Sat, 5 Oct 2019 12:05:25 +0530
Subject: [PATCH 09/72] fix more lint

---
 readthedocs/search/models.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/readthedocs/search/models.py b/readthedocs/search/models.py
index 1aa2f8ed6b0..fd4eefa2331 100644
--- a/readthedocs/search/models.py
+++ b/readthedocs/search/models.py
@@ -152,7 +152,7 @@ def get_top_viewed_pages(cls, project):
     @classmethod
     def get_page_view_count_of_one_month(cls, project_slug, page_path):
         """
-        Returns the total page views count for last 30 days (including today) for a particular `page_path`.
+        Returns the total page views count for last 30 days for a particular `page_path`.
 
         Structure of returned data is compatible to make graphs.
         Sample returned data::

From 3ec59dc150cd79fdbcd193f730ee9654cf5101b9 Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Tue, 15 Oct 2019 18:45:05 +0530
Subject: [PATCH 10/72] store page_slug instead of page_path

---
 readthedocs/api/v2/views/footer_views.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/readthedocs/api/v2/views/footer_views.py b/readthedocs/api/v2/views/footer_views.py
index f0cc5cb7b85..369dbad6a71 100644
--- a/readthedocs/api/v2/views/footer_views.py
+++ b/readthedocs/api/v2/views/footer_views.py
@@ -212,10 +212,11 @@ def get(self, request, format=None):
         }
 
         # increase the page view count
+        page_slug = request.GET.get('page', 'index')
         increase_page_view_count.delay(
             project_slug=context['project'].slug,
             version_slug=context['version'].slug,
-            path=context['path'] if context['path'] else 'index.html'
+            path=page_slug
         )
 
         # Allow folks to hook onto the footer response for various information

From 108fd5fe7fefc17f63f7cf92e1aad9d67510fd3c Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Tue, 15 Oct 2019 23:26:26 +0530
Subject: [PATCH 11/72] little refactor

---
 readthedocs/search/models.py | 14 +++++++-------
 readthedocs/search/utils.py  |  6 ++++--
 2 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/readthedocs/search/models.py b/readthedocs/search/models.py
index fd4eefa2331..51c28b0ca00 100644
--- a/readthedocs/search/models.py
+++ b/readthedocs/search/models.py
@@ -82,7 +82,7 @@ def generate_queries_count_of_one_month(cls, project_slug):
 
         # format the date value to a more readable form
         # Eg. `16 Jul`
-        last_31_days_str = _get_last_31_days_str()
+        last_31_days_str = _get_last_31_days_str(date_format='%d %b')
 
         final_data = {
             'labels': last_31_days_str,
@@ -119,12 +119,12 @@ def get_top_viewed_pages(cls, project):
         Structure of returned data is compatible to make graphs.
         Sample returned data::
         {
-            'pages': ['index.html', 'contribute.html', 'sponsors.html'],
-            'view_counts': [150, 200, 143]
+            'pages': ['index', 'config-file/v1', 'intro/import-guide'],
+            'view_counts': [150, 120, 100]
         }
-        This data shows that `index.html` is the most viewed page having 150 total views,
-        followed by `contribute.html` and `sponsors.html` having 200 and
-        143 total page views respectively.
+        This data shows that `index` is the most viewed page having 150 total views,
+        followed by `config-file/v1` and `intro/import-guide` having 120 and
+        100 total page views respectively.
         """
         qs = (
             cls.objects
@@ -184,7 +184,7 @@ def get_page_view_count_of_one_month(cls, project_slug, page_path):
 
         # format the date value to a more readable form
         # Eg. `16 Jul`
-        last_31_days_str = _get_last_31_days_str()
+        last_31_days_str = _get_last_31_days_str(date_format='%d %b')
 
         final_data = {
             'labels': last_31_days_str,
diff --git a/readthedocs/search/utils.py b/readthedocs/search/utils.py
index 69c1c42b993..c1ff956ecf6 100644
--- a/readthedocs/search/utils.py
+++ b/readthedocs/search/utils.py
@@ -172,6 +172,7 @@ def _get_sorted_results(results, source_key='_source'):
 
 
 def _get_last_31_days_iter():
+    """Returns iterator for last 31 days (including today)."""
     today = timezone.now().date()
     last_30th_day = timezone.now().date() - timezone.timedelta(days=30)
 
@@ -180,10 +181,11 @@ def _get_last_31_days_iter():
     return last_31_days_iter
 
 
-def _get_last_31_days_str():
+def _get_last_31_days_str(date_format):
+    """Returns the list of dates in string format for last 31 days (including today)."""
     last_31_days_iter = _get_last_31_days_iter()
     last_31_days_str = [
-        timezone.datetime.strftime(date, '%d %b')
+        timezone.datetime.strftime(date, date_format)
         for date in last_31_days_iter
     ]
     return last_31_days_str

From ddc96d9ff909936b8e2f29233c0ef506963187c0 Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Wed, 16 Oct 2019 01:38:33 +0530
Subject: [PATCH 12/72] update test

---
 readthedocs/rtd_tests/tests/test_footer.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/readthedocs/rtd_tests/tests/test_footer.py b/readthedocs/rtd_tests/tests/test_footer.py
index 0c48c2ad3b9..9affc2010d6 100644
--- a/readthedocs/rtd_tests/tests/test_footer.py
+++ b/readthedocs/rtd_tests/tests/test_footer.py
@@ -233,9 +233,11 @@ class TestFooterPerformance(APITestCase):
     url = '/api/v2/footer_html/?project=pip&version=latest&page=index&docroot=/'
     factory = APIRequestFactory()
 
-    # The expected number of queries for generating the footer
-    # This shouldn't increase unless we modify the footer API
-    EXPECTED_QUERIES = 9
+    # The expected number of queries for generating the footer.
+    # This shouldn't increase unless we modify the footer API.
+    # Here 9 queries are for serving footer views and 4 queries
+    # are for storing page views in the db.
+    EXPECTED_QUERIES = 9 + 4
 
     def setUp(self):
         self.pip = Project.objects.get(slug='pip')

From 8da0f9300f3bfc315f50dcac23cdbffd8bcf7806 Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Wed, 16 Oct 2019 02:57:08 +0530
Subject: [PATCH 13/72] fix tests

---
 readthedocs/rtd_tests/tests/test_footer.py | 56 ++++++++++++----------
 1 file changed, 30 insertions(+), 26 deletions(-)

diff --git a/readthedocs/rtd_tests/tests/test_footer.py b/readthedocs/rtd_tests/tests/test_footer.py
index 9affc2010d6..452df85cb1f 100644
--- a/readthedocs/rtd_tests/tests/test_footer.py
+++ b/readthedocs/rtd_tests/tests/test_footer.py
@@ -235,9 +235,7 @@ class TestFooterPerformance(APITestCase):
 
     # The expected number of queries for generating the footer.
     # This shouldn't increase unless we modify the footer API.
-    # Here 9 queries are for serving footer views and 4 queries
-    # are for storing page views in the db.
-    EXPECTED_QUERIES = 9 + 4
+    EXPECTED_QUERIES = 9
 
     def setUp(self):
         self.pip = Project.objects.get(slug='pip')
@@ -251,30 +249,36 @@ def render(self):
 
     def test_version_queries(self):
         # The number of Versions shouldn't impact the number of queries
-        with self.assertNumQueries(self.EXPECTED_QUERIES):
-            response = self.render()
-            self.assertContains(response, '0.8.1')
-
-        for patch in range(3):
-            identifier = '0.99.{}'.format(patch)
-            self.pip.versions.create(
-                verbose_name=identifier,
-                identifier=identifier,
-                type=TAG,
-                active=True,
-            )
-
-        with self.assertNumQueries(self.EXPECTED_QUERIES):
-            response = self.render()
-            self.assertContains(response, '0.99.0')
+        with mock.patch('readthedocs.api.v2.views.footer_views.increase_page_view_count') as mocked:
+            mocked.side_effect = None
+
+            with self.assertNumQueries(self.EXPECTED_QUERIES):
+                response = self.render()
+                self.assertContains(response, '0.8.1')
+
+            for patch in range(3):
+                identifier = '0.99.{}'.format(patch)
+                self.pip.versions.create(
+                    verbose_name=identifier,
+                    identifier=identifier,
+                    type=TAG,
+                    active=True,
+                )
+
+            with self.assertNumQueries(self.EXPECTED_QUERIES):
+                response = self.render()
+                self.assertContains(response, '0.99.0')
 
     def test_domain_queries(self):
         # Setting up a custom domain shouldn't impact the number of queries
-        self.pip.domains.create(
-            domain='http://docs.foobar.com',
-            canonical=True,
-        )
+        with mock.patch('readthedocs.api.v2.views.footer_views.increase_page_view_count') as mocked:
+            mocked.side_effect = None
 
-        with self.assertNumQueries(self.EXPECTED_QUERIES):
-            response = self.render()
-            self.assertContains(response, 'docs.foobar.com')
+            self.pip.domains.create(
+                domain='http://docs.foobar.com',
+                canonical=True,
+            )
+
+            with self.assertNumQueries(self.EXPECTED_QUERIES):
+                response = self.render()
+                self.assertContains(response, 'docs.foobar.com')

From d0e1317ff247a865d7eceb8595626d96794d255a Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Wed, 16 Oct 2019 20:49:36 +0530
Subject: [PATCH 14/72] add test for search tasks

---
 readthedocs/search/tests/test_search_tasks.py | 73 ++++++++++++++++++-
 1 file changed, 72 insertions(+), 1 deletion(-)

diff --git a/readthedocs/search/tests/test_search_tasks.py b/readthedocs/search/tests/test_search_tasks.py
index 86d2742ee67..81376c7c41c 100644
--- a/readthedocs/search/tests/test_search_tasks.py
+++ b/readthedocs/search/tests/test_search_tasks.py
@@ -8,7 +8,7 @@
 
 from readthedocs.projects.models import Project
 from readthedocs.builds.models import Version
-from readthedocs.search.models import SearchQuery
+from readthedocs.search.models import SearchQuery, PageView
 from readthedocs.search import tasks
 
 
@@ -124,3 +124,74 @@ def test_delete_old_search_queries_from_db(self, project):
         assert SearchQuery.objects.all().count() == 1
         tasks.delete_old_search_queries_from_db()
         assert SearchQuery.objects.all().count() == 0
+
+    def test_increase_page_view_count(self, project):
+        today = timezone.now()
+        tomorrow = timezone.now() + timezone.timedelta(days=1)
+        yesterday = timezone.now() - timezone.timedelta(days=1)
+
+        assert (
+            PageView.objects.all().count() == 0
+        ), 'There\'s no PageView object created yet.'
+
+        # testing for yesterday
+        with mock.patch('readthedocs.search.tasks.timezone') as mocked_timezone:
+            mocked_timezone.return_value = yesterday
+
+            tasks.increase_page_view_count(
+                project_slug=project.slug,
+                version_slug=project.versions.all().first().slug,
+                path='index',
+            )
+
+            assert (
+                PageView.objects.all().count() == 1,
+            ), 'PageView object for path \'index\' is created'
+            assert (
+                PageView.objects.all().first().view_count == 1
+            ), '\'index\' has 1 view'
+
+            tasks.increase_page_view_count(
+                project_slug=project.slug,
+                version_slug=project.versions.all().first().slug,
+                path='index',
+            )
+
+            assert (
+                PageView.objects.all().count() == 1,
+            ), 'PageView object for path \'index\' is already created'
+            assert (
+                PageView.objects.all().first().view_count == 2
+            ), '\'index\' has 2 views now'
+
+        # testing for today
+        with mock.patch('readthedocs.search.tasks.timezone') as mocked_timezone:
+            mocked_timezone.return_value = today
+            tasks.increase_page_view_count(
+                project_slug=project.slug,
+                version_slug=project.versions.all().first().slug,
+                path='index',
+            )
+
+            assert (
+                PageView.objects.all().count() == 2,
+            ), 'PageView object for path \'index\' is created for two days (yesterday and today)'
+            assert (
+                PageView.objects.all().order_by('-created').first().view_count == 1
+            ), '\'index\' has 1 view today'
+
+        # testing for tomorrow
+        with mock.patch('readthedocs.search.tasks.timezone') as mocked_timezone:
+            mocked_timezone.return_value = tomorrow
+            tasks.increase_page_view_count(
+                project_slug=project.slug,
+                version_slug=project.versions.all().first().slug,
+                path='index',
+            )
+
+            assert (
+                PageView.objects.all().count() == 3,
+            ), 'PageView object for path \'index\' is created for three days (yesterday, today & tomorrow)'
+            assert (
+                PageView.objects.all().order_by('-created').first().view_count == 1
+            ), '\'index\' has 1 view tomorrow'

From 39463981c5bd9da162082ddf0991bd90d006ca10 Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Thu, 17 Oct 2019 19:04:58 +0530
Subject: [PATCH 15/72] use F expression

---
 readthedocs/search/tasks.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/readthedocs/search/tasks.py b/readthedocs/search/tasks.py
index ebece39f744..6e1a552dfa9 100644
--- a/readthedocs/search/tasks.py
+++ b/readthedocs/search/tasks.py
@@ -2,6 +2,7 @@
 
 from dateutil.parser import parse
 from django.apps import apps
+from django.db.models import F
 from django.utils import timezone
 from django_elasticsearch_dsl.registries import registry
 
@@ -225,7 +226,7 @@ def increase_page_view_count(project_slug, version_slug, path):
     ).first()
 
     if page_view_obj:
-        page_view_obj.view_count += 1
+        page_view_obj.view_count = F('view_count') + 1
         page_view_obj.save()
     else:
         project = Project.objects.get(slug=project_slug)

From 11eb6acaacf11cebb6b8efcba4e5c9857807d4d8 Mon Sep 17 00:00:00 2001
From: dojutsu-user <vaibhgupt199@gmail.com>
Date: Wed, 23 Oct 2019 00:35:53 +0530
Subject: [PATCH 16/72] fix tests

---
 readthedocs/search/tests/test_search_tasks.py | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/readthedocs/search/tests/test_search_tasks.py b/readthedocs/search/tests/test_search_tasks.py
index 81376c7c41c..33dbe012d68 100644
--- a/readthedocs/search/tests/test_search_tasks.py
+++ b/readthedocs/search/tests/test_search_tasks.py
@@ -135,7 +135,7 @@ def test_increase_page_view_count(self, project):
         ), 'There\'s no PageView object created yet.'
 
         # testing for yesterday
-        with mock.patch('readthedocs.search.tasks.timezone') as mocked_timezone:
+        with mock.patch('readthedocs.search.tasks.timezone.now') as mocked_timezone:
             mocked_timezone.return_value = yesterday
 
             tasks.increase_page_view_count(
@@ -145,7 +145,7 @@ def test_increase_page_view_count(self, project):
             )
 
             assert (
-                PageView.objects.all().count() == 1,
+                PageView.objects.all().count() == 1
             ), 'PageView object for path \'index\' is created'
             assert (
                 PageView.objects.all().first().view_count == 1
@@ -158,14 +158,14 @@ def test_increase_page_view_count(self, project):
             )
 
             assert (
-                PageView.objects.all().count() == 1,
+                PageView.objects.all().count() == 1
             ), 'PageView object for path \'index\' is already created'
             assert (
                 PageView.objects.all().first().view_count == 2
             ), '\'index\' has 2 views now'
 
         # testing for today
-        with mock.patch('readthedocs.search.tasks.timezone') as mocked_timezone:
+        with mock.patch('readthedocs.search.tasks.timezone.now') as mocked_timezone:
             mocked_timezone.return_value = today
             tasks.increase_page_view_count(
                 project_slug=project.slug,
@@ -174,14 +174,14 @@ def test_increase_page_view_count(self, project):
             )
 
             assert (
-                PageView.objects.all().count() == 2,
+                PageView.objects.all().count() == 2
             ), 'PageView object for path \'index\' is created for two days (yesterday and today)'
             assert (
-                PageView.objects.all().order_by('-created').first().view_count == 1
+                PageView.objects.all().order_by('-date').first().view_count == 1
             ), '\'index\' has 1 view today'
 
         # testing for tomorrow
-        with mock.patch('readthedocs.search.tasks.timezone') as mocked_timezone:
+        with mock.patch('readthedocs.search.tasks.timezone.now') as mocked_timezone:
             mocked_timezone.return_value = tomorrow
             tasks.increase_page_view_count(
                 project_slug=project.slug,
@@ -190,8 +190,8 @@ def test_increase_page_view_count(self, project):
             )
 
             assert (
-                PageView.objects.all().count() == 3,
+                PageView.objects.all().count() == 3
             ), 'PageView object for path \'index\' is created for three days (yesterday, today & tomorrow)'
             assert (
-                PageView.objects.all().order_by('-created').first().view_count == 1
+                PageView.objects.all().order_by('-date').first().view_count == 1
             ), '\'index\' has 1 view tomorrow'

From da4673ace6c3df3c7cf149061345e2cb87d6534b Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Wed, 6 May 2020 13:56:35 -0500
Subject: [PATCH 17/72] RTDFacetedSearch: pass filters in one way only

Currently, we can pass filters as keywords (if they match a valid
filter) or in the `filters` keyword.

The original model FacetedSearch allows to pass filter only using the
filfilters keyword.

All places were refactored so we always pass the filters in the filters
arg.
---
 readthedocs/search/api.py            |  4 +++-
 readthedocs/search/faceted_search.py | 32 ++++++++++------------------
 readthedocs/search/views.py          |  9 ++++----
 3 files changed, 18 insertions(+), 27 deletions(-)

diff --git a/readthedocs/search/api.py b/readthedocs/search/api.py
index d5e123d2863..d6fedbf8779 100644
--- a/readthedocs/search/api.py
+++ b/readthedocs/search/api.py
@@ -120,13 +120,15 @@ def get_queryset(self):
         kwargs = {'filter_by_user': False, 'filters': {}}
         kwargs['filters']['project'] = [p.slug for p in self.get_all_projects()]
         kwargs['filters']['version'] = self._get_version().slug
-        # Check to avoid searching all projects in case project is empty.
+
+        # Check to avoid searching all projects in case these filters are empty.
         if not kwargs['filters']['project']:
             log.info("Unable to find a project to search")
             return HTMLFile.objects.none()
         if not kwargs['filters']['version']:
             log.info("Unable to find a version to search")
             return HTMLFile.objects.none()
+
         user = self.request.user
         queryset = PageSearch(
             query=query, user=user, **kwargs
diff --git a/readthedocs/search/faceted_search.py b/readthedocs/search/faceted_search.py
index 912e1ac99d9..7153f8628d1 100644
--- a/readthedocs/search/faceted_search.py
+++ b/readthedocs/search/faceted_search.py
@@ -1,18 +1,13 @@
 import logging
 
+from django.conf import settings
 from elasticsearch import Elasticsearch
 from elasticsearch_dsl import FacetedSearch, TermsFacet
 from elasticsearch_dsl.faceted_search import NestedFacet
-from elasticsearch_dsl.query import Bool, SimpleQueryString, Nested, Match
-
-from django.conf import settings
+from elasticsearch_dsl.query import Bool, Match, Nested, SimpleQueryString
 
 from readthedocs.core.utils.extend import SettingsOverrideObject
-from readthedocs.search.documents import (
-    PageDocument,
-    ProjectDocument,
-)
-
+from readthedocs.search.documents import PageDocument, ProjectDocument
 
 log = logging.getLogger(__name__)
 
@@ -21,7 +16,11 @@
 
 class RTDFacetedSearch(FacetedSearch):
 
-    def __init__(self, user, **kwargs):
+    """Custom wrapper around FacetedSearch."""
+
+    operators = []
+
+    def __init__(self, query=None, filters=None, user=None, **kwargs):
         """
         Pass in a user in order to filter search results by privacy.
 
@@ -33,23 +32,14 @@ def __init__(self, user, **kwargs):
         self.user = user
         self.filter_by_user = kwargs.pop('filter_by_user', True)
 
-        # Set filters properly
-        for facet in self.facets:
-            if facet in kwargs:
-                kwargs.setdefault('filters', {})[facet] = kwargs.pop(facet)
-
-        # Don't pass along unnecessary filters
-        for f in ALL_FACETS:
-            if f in kwargs:
-                del kwargs[f]
-
         # Hack a fix to our broken connection pooling
         # This creates a new connection on every request,
         # but actually works :)
         log.info('Hacking Elastic to fix search connection pooling')
         self.using = Elasticsearch(**settings.ELASTICSEARCH_DSL['default'])
 
-        super().__init__(**kwargs)
+        filters = filters or {}
+        super().__init__(query, filters, **kwargs)
 
     def query(self, search, query):
         """
@@ -57,7 +47,7 @@ def query(self, search, query):
 
         Also:
 
-        * Adds SimpleQueryString instead of default query.
+        * Adds SimpleQueryString with `self.operators` instead of default query.
         * Adds HTML encoding of results to avoid XSS issues.
         """
         search = search.highlight_options(encoder='html', number_of_fragments=3)
diff --git a/readthedocs/search/views.py b/readthedocs/search/views.py
index 94a63c43bee..23a6cd8dc32 100644
--- a/readthedocs/search/views.py
+++ b/readthedocs/search/views.py
@@ -8,13 +8,12 @@
 
 from readthedocs.builds.constants import LATEST
 from readthedocs.projects.models import Project
+from readthedocs.search import utils
 from readthedocs.search.faceted_search import (
     ALL_FACETS,
     PageSearch,
     ProjectSearch,
 )
-from readthedocs.search import utils
-
 
 log = logging.getLogger(__name__)
 LOG_TEMPLATE = '(Elastic Search) [%(user)s:%(type)s] [%(project)s:%(version)s:%(language)s] %(msg)s'
@@ -71,15 +70,15 @@ def elastic_search(request, project_slug=None):
     facets = {}
 
     if user_input.query:
-        kwargs = {}
+        filters = {}
 
         for avail_facet in ALL_FACETS:
             value = getattr(user_input, avail_facet, None)
             if value:
-                kwargs[avail_facet] = value
+                filters[avail_facet] = value
 
         search = search_facets[user_input.type](
-            query=user_input.query, user=request.user, **kwargs
+            query=user_input.query, filters=filters, user=request.user,
         )
         results = search[:50].execute()
         facets = results.facets

From 6c3bb51a326bb74b00907d13f9347dd8bca0bfbd Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Wed, 6 May 2020 15:42:19 -0500
Subject: [PATCH 18/72] Search view can still pass invalid values

---
 readthedocs/search/faceted_search.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/readthedocs/search/faceted_search.py b/readthedocs/search/faceted_search.py
index 7153f8628d1..e0aea1b6b68 100644
--- a/readthedocs/search/faceted_search.py
+++ b/readthedocs/search/faceted_search.py
@@ -39,7 +39,14 @@ def __init__(self, query=None, filters=None, user=None, **kwargs):
         self.using = Elasticsearch(**settings.ELASTICSEARCH_DSL['default'])
 
         filters = filters or {}
-        super().__init__(query, filters, **kwargs)
+
+        # We may recieve invalid filters
+        valid_filters = {
+            k: v
+            for k, v in filters.items()
+            if k in self.facets
+        }
+        super().__init__(query=query, filters=valid_filters, **kwargs)
 
     def query(self, search, query):
         """

From a5e8a3ad43ff30f2a5f35fe8acf3060396aafaff Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Wed, 6 May 2020 16:42:53 -0500
Subject: [PATCH 19/72] Search: iterate over valid facets only

This logic is the same as the previous one,
but it iterates over the valid facets only.
---
 readthedocs/search/views.py | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/readthedocs/search/views.py b/readthedocs/search/views.py
index 94a63c43bee..38590dac1d9 100644
--- a/readthedocs/search/views.py
+++ b/readthedocs/search/views.py
@@ -97,12 +97,10 @@ def elastic_search(request, project_slug=None):
         )
 
     # Make sure our selected facets are displayed even when they return 0 results
-    for avail_facet in ALL_FACETS:
-        value = getattr(user_input, avail_facet, None)
-        if not value or avail_facet not in facets:
-            continue
-        if value not in [val[0] for val in facets[avail_facet]]:
-            facets[avail_facet].insert(0, (value, 0, True))
+    for facet in facets:
+        value = getattr(user_input, facet, None)
+        if value and value not in (val[0] for val in facets[facet]):
+            facets[facet].insert(0, (value, 0, True))
 
     if results:
 

From a2f1503e1e385ab47785e704d653464077ee9e9f Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Wed, 6 May 2020 17:12:40 -0500
Subject: [PATCH 20/72] Search Document: remove unused class methods

This was only being used for testing.
---
 readthedocs/search/documents.py               | 37 -------------------
 .../search/tests/test_faceted_search.py       |  6 +--
 readthedocs/search/tests/test_xss.py          |  4 +-
 3 files changed, 5 insertions(+), 42 deletions(-)

diff --git a/readthedocs/search/documents.py b/readthedocs/search/documents.py
index 68dd80ee8d3..55efe0b4ca5 100644
--- a/readthedocs/search/documents.py
+++ b/readthedocs/search/documents.py
@@ -2,12 +2,10 @@
 
 from django.conf import settings
 from django_elasticsearch_dsl import DocType, Index, fields
-
 from elasticsearch import Elasticsearch
 
 from readthedocs.projects.models import HTMLFile, Project
 
-
 project_conf = settings.ES_INDEXES['project']
 project_index = Index(project_conf['name'])
 project_index.settings(**project_conf['settings'])
@@ -50,19 +48,6 @@ class Meta:
         fields = ('name', 'slug', 'description')
         ignore_signals = True
 
-    @classmethod
-    def faceted_search(cls, query, user, language=None):
-        from readthedocs.search.faceted_search import ProjectSearch
-        kwargs = {
-            'user': user,
-            'query': query,
-        }
-
-        if language:
-            kwargs['filters'] = {'language': language}
-
-        return ProjectSearch(**kwargs)
-
 
 @page_index.doc_type
 class PageDocument(RTDDocTypeMixin, DocType):
@@ -148,28 +133,6 @@ def prepare_domains(self, html_file):
 
         return all_domains
 
-    @classmethod
-    def faceted_search(
-            cls, query, user, projects_list=None, versions_list=None,
-            filter_by_user=True
-    ):
-        from readthedocs.search.faceted_search import PageSearch
-        kwargs = {
-            'user': user,
-            'query': query,
-            'filter_by_user': filter_by_user,
-        }
-
-        filters = {}
-        if projects_list is not None:
-            filters['project'] = projects_list
-        if versions_list is not None:
-            filters['version'] = versions_list
-
-        kwargs['filters'] = filters
-
-        return PageSearch(**kwargs)
-
     def get_queryset(self):
         """Overwrite default queryset to filter certain files to index."""
         queryset = super().get_queryset()
diff --git a/readthedocs/search/tests/test_faceted_search.py b/readthedocs/search/tests/test_faceted_search.py
index 74112321682..d62a6903300 100644
--- a/readthedocs/search/tests/test_faceted_search.py
+++ b/readthedocs/search/tests/test_faceted_search.py
@@ -1,6 +1,6 @@
 import pytest
 
-from readthedocs.search.documents import PageDocument
+from readthedocs.search.faceted_search import PageSearch
 
 
 @pytest.mark.django_db
@@ -21,7 +21,7 @@ def test_search_exact_match(self, client, project, case):
         cased_query = getattr(query_text, case)
         query = cased_query()
 
-        page_search = PageDocument.faceted_search(query=query, user='')
+        page_search = PageSearch(query=query, user='')
         results = page_search.execute()
 
         assert len(results) == 1
@@ -37,7 +37,7 @@ def test_search_combined_result(self, client, project):
         - Where `Foo` or `Bar` is present
         """
         query = 'Elasticsearch Query'
-        page_search = PageDocument.faceted_search(query=query, user='')
+        page_search = PageSearch(query=query, user='')
         results = page_search.execute()
         assert len(results) == 3
 
diff --git a/readthedocs/search/tests/test_xss.py b/readthedocs/search/tests/test_xss.py
index ed5d674f668..31353061e0d 100644
--- a/readthedocs/search/tests/test_xss.py
+++ b/readthedocs/search/tests/test_xss.py
@@ -1,6 +1,6 @@
 import pytest
 
-from readthedocs.search.documents import PageDocument
+from readthedocs.search.faceted_search import PageSearch
 
 
 @pytest.mark.django_db
@@ -9,7 +9,7 @@ class TestXSS:
 
     def test_facted_page_xss(self, client, project):
         query = 'XSS'
-        page_search = PageDocument.faceted_search(query=query, user='')
+        page_search = PageSearch(query=query, user='')
         results = page_search.execute()
         expected = """
         &lt;h3&gt;<span>XSS</span> exploit&lt;&#x2F;h3&gt;

From 3ce38c82e16285f12e1754afacdf422bb34ba4a2 Mon Sep 17 00:00:00 2001
From: David Fischer <david@readthedocs.org>
Date: Thu, 7 May 2020 17:01:44 -0700
Subject: [PATCH 21/72] Index and refactor page view counting

---
 .../0002_create_page_views_model.py           | 16 +++++-----
 readthedocs/search/models.py                  | 11 +++++--
 readthedocs/search/tasks.py                   | 29 +++++++------------
 3 files changed, 27 insertions(+), 29 deletions(-)

diff --git a/readthedocs/search/migrations/0002_create_page_views_model.py b/readthedocs/search/migrations/0002_create_page_views_model.py
index 8352ea28791..20281a18832 100644
--- a/readthedocs/search/migrations/0002_create_page_views_model.py
+++ b/readthedocs/search/migrations/0002_create_page_views_model.py
@@ -1,7 +1,6 @@
-# -*- coding: utf-8 -*-
-# Generated by Django 1.11.24 on 2019-09-18 06:11
-from __future__ import unicode_literals
+# Generated by Django 2.2.12 on 2020-05-07 23:32
 
+import datetime
 from django.db import migrations, models
 import django.db.models.deletion
 
@@ -9,8 +8,8 @@
 class Migration(migrations.Migration):
 
     dependencies = [
-        ('builds', '0010_add-description-field-to-automation-rule'),
-        ('projects', '0044_auto_20190703_1300'),
+        ('projects', '0048_remove_version_privacy_field'),
+        ('builds', '0019_migrate_protected_versions_to_hidden'),
         ('search', '0001_initial'),
     ]
 
@@ -20,10 +19,13 @@ class Migration(migrations.Migration):
             fields=[
                 ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
                 ('path', models.CharField(max_length=4096)),
-                ('view_count', models.PositiveIntegerField(default=1)),
-                ('date', models.DateField()),
+                ('view_count', models.PositiveIntegerField(default=0)),
+                ('date', models.DateField(db_index=True, default=datetime.date.today)),
                 ('project', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='page_views', to='projects.Project')),
                 ('version', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='page_views', to='builds.Version', verbose_name='Version')),
             ],
+            options={
+                'unique_together': {('project', 'version', 'path', 'date')},
+            },
         ),
     ]
diff --git a/readthedocs/search/models.py b/readthedocs/search/models.py
index 51c28b0ca00..12366085964 100644
--- a/readthedocs/search/models.py
+++ b/readthedocs/search/models.py
@@ -1,5 +1,7 @@
 """Search Queries."""
 
+import datetime
+
 from django.db import models
 from django.db.models import Count, Sum
 from django.db.models.functions import TruncDate
@@ -105,11 +107,14 @@ class PageView(models.Model):
         on_delete=models.CASCADE,
     )
     path = models.CharField(max_length=4096)
-    view_count = models.PositiveIntegerField(default=1)
-    date = models.DateField()
+    view_count = models.PositiveIntegerField(default=0)
+    date = models.DateField(default=datetime.date.today, db_index=True)
+
+    class Meta:
+        unique_together = ("project", "version", "path", "date")
 
     def __str__(self):
-        return f'[{self.project.slug}:{self.version.slug}]: {self.path}'
+        return f'PageView: [{self.project.slug}:{self.version.slug}] - {self.path}'
 
     @classmethod
     def get_top_viewed_pages(cls, project):
diff --git a/readthedocs/search/tasks.py b/readthedocs/search/tasks.py
index 14db55bfdfb..69a3d7961a9 100644
--- a/readthedocs/search/tasks.py
+++ b/readthedocs/search/tasks.py
@@ -214,23 +214,14 @@ def record_search_query(project_slug, version_slug, query, total_results, time_s
 
 @app.task(queue='web')
 def increase_page_view_count(project_slug, version_slug, path):
-    today_date = timezone.now().date()
-    page_view_obj = PageView.objects.filter(
-        project__slug=project_slug,
-        version__slug=version_slug,
+    project = Project.objects.get(slug=project_slug)
+
+    page_view, _ = PageView.objects.get_or_create(
+        project=project,
+        version=Version.objects.get(project=project, slug=version_slug),
         path=path,
-        date=today_date,
-    ).first()
-
-    if page_view_obj:
-        page_view_obj.view_count = F('view_count') + 1
-        page_view_obj.save()
-    else:
-        project = Project.objects.get(slug=project_slug)
-        version = Version.objects.get(project=project, slug=version_slug)
-        PageView.objects.create(
-            project=project,
-            version=version,
-            path=path,
-            date=today_date,
-        )
+        date=timezone.now().date(),
+    )
+    PageView.objects.filter(pk=page_view.pk).update(
+        view_count=F('view_count') + 1
+    )

From 46747b0be7447e79b9b16b0e4ee0728b38bc3c90 Mon Sep 17 00:00:00 2001
From: David Fischer <david@readthedocs.org>
Date: Fri, 8 May 2020 14:14:41 -0700
Subject: [PATCH 22/72] Feedback updates and renames for clarity

- Added a periodic task to remove old pageviews
- Show aggregated traffic on the admin view
---
 readthedocs/api/v2/views/footer_views.py      | 15 ++---
 readthedocs/projects/urls/private.py          |  6 +-
 readthedocs/projects/views/private.py         | 40 ++++----------
 readthedocs/search/models.py                  | 55 ++++++++++---------
 readthedocs/search/tasks.py                   | 11 ++++
 readthedocs/search/utils.py                   | 23 ++++----
 readthedocs/settings/base.py                  |  7 ++-
 .../templates/projects/project_edit_base.html |  2 +-
 ...ws.html => project_traffic_analytics.html} | 33 +++++------
 .../projects/projects_search_analytics.html   |  2 +-
 10 files changed, 92 insertions(+), 102 deletions(-)
 rename readthedocs/templates/projects/{project_page_views.html => project_traffic_analytics.html} (61%)

diff --git a/readthedocs/api/v2/views/footer_views.py b/readthedocs/api/v2/views/footer_views.py
index 81e03b224ef..5fe91e54240 100644
--- a/readthedocs/api/v2/views/footer_views.py
+++ b/readthedocs/api/v2/views/footer_views.py
@@ -222,13 +222,14 @@ def get(self, request, format=None):
             'version_supported': version.supported,
         }
 
-        # increase the page view count
-        page_slug = request.GET.get('page', 'index')
-        increase_page_view_count.delay(
-            project_slug=context['project'].slug,
-            version_slug=context['version'].slug,
-            path=page_slug
-        )
+        # increase the page view count for the given page
+        page_slug = request.GET.get('page', '')
+        if page_slug:
+            increase_page_view_count.delay(
+                project_slug=context['project'].slug,
+                version_slug=context['version'].slug,
+                path=page_slug
+            )
 
         # Allow folks to hook onto the footer response for various information
         # collection, or to modify the resp_data.
diff --git a/readthedocs/projects/urls/private.py b/readthedocs/projects/urls/private.py
index 0272f78b1cb..1db0be47af3 100644
--- a/readthedocs/projects/urls/private.py
+++ b/readthedocs/projects/urls/private.py
@@ -26,7 +26,7 @@
     IntegrationExchangeDetail,
     IntegrationList,
     IntegrationWebhookSync,
-    PageViewAdmin,
+    TrafficAnalyticsView,
     ProjectAdvancedUpdate,
     ProjectAdvertisingUpdate,
     ProjectDashboard,
@@ -141,8 +141,8 @@
         name='projects_search_analytics',
     ),
     url(
-        r'^(?P<project_slug>[-\w]+)/page-views/$',
-        PageViewAdmin.as_view(), name='projects_page_views',
+        r'^(?P<project_slug>[-\w]+)/traffic-analytics/$',
+        TrafficAnalyticsView.as_view(), name='projects_traffic_analytics',
     ),
 ]
 
diff --git a/readthedocs/projects/views/private.py b/readthedocs/projects/views/private.py
index 0399946a270..27dcb758259 100644
--- a/readthedocs/projects/views/private.py
+++ b/readthedocs/projects/views/private.py
@@ -6,7 +6,6 @@
 from allauth.socialaccount.models import SocialAccount
 from django.conf import settings
 from django.contrib import messages
-from django.contrib.auth.decorators import login_required
 from django.db.models import Count
 from django.http import (
     Http404,
@@ -41,7 +40,6 @@
 )
 from readthedocs.core.mixins import (
     ListViewWithForm,
-    LoginRequiredMixin,
     PrivateViewMixin,
 )
 from readthedocs.core.utils import broadcast, trigger_build
@@ -977,15 +975,6 @@ class RegexAutomationRuleUpdate(RegexAutomationRuleMixin, UpdateView):
     pass
 
 
-@login_required
-def search_analytics_view(request, project_slug):
-    """View for search analytics."""
-    project = get_object_or_404(
-        Project.objects.for_admin_user(request.user),
-        slug=project_slug,
-    )
-
-
 class SearchAnalytics(ProjectAdminMixin, PrivateViewMixin, TemplateView):
 
     template_name = 'projects/projects_search_analytics.html'
@@ -1065,39 +1054,30 @@ def _search_analytics_csv_data(self):
         return response
 
 
-class PageViewAdmin(ProjectAdminMixin, PrivateViewMixin, TemplateView):
+class TrafficAnalyticsView(ProjectAdminMixin, PrivateViewMixin, TemplateView):
 
-    template_name = 'projects/project_page_views.html'
+    template_name = 'projects/project_traffic_analytics.html'
     http_method_names = ['get']
 
     def get_context_data(self, **kwargs):
         context = super().get_context_data(**kwargs)
         project = self.get_project()
 
-        top_viewed_pages = PageView.get_top_viewed_pages(project)
-        top_viewed_pages_iter = zip(
-            top_viewed_pages['pages'],
-            top_viewed_pages['view_counts']
+        # Count of views for top pages over the month
+        top_pages = PageView.top_viewed_pages(project)
+        top_viewed_pages = zip(
+            top_pages['pages'],
+            top_pages['view_counts']
         )
 
-        all_pages = PageView.objects.filter(project=project).values_list('path', flat=True)
-        if all_pages.exists():
-            all_pages = sorted(list(set(all_pages)))
-            page_path = self.request.GET.get('page', all_pages[0])
-        else:
-            all_pages = []
-            page_path = ''
-
-        page_data = PageView.get_page_view_count_of_one_month(
+        # Aggregate pageviews grouped by day
+        page_data = PageView.page_views_by_date(
             project_slug=project.slug,
-            page_path=page_path
         )
 
         context.update({
-            'top_viewed_pages_iter': top_viewed_pages_iter,
+            'top_viewed_pages': top_viewed_pages,
             'page_data': page_data,
-            'page_path': page_path,
-            'all_pages': all_pages,
         })
 
         return context
diff --git a/readthedocs/search/models.py b/readthedocs/search/models.py
index 12366085964..7a6d169dfc5 100644
--- a/readthedocs/search/models.py
+++ b/readthedocs/search/models.py
@@ -13,7 +13,7 @@
 from readthedocs.builds.models import Version
 from readthedocs.projects.models import Project
 from readthedocs.projects.querysets import RelatedProjectQuerySet
-from readthedocs.search.utils import _get_last_31_days_iter, _get_last_31_days_str
+from readthedocs.search.utils import _last_30_days_iter
 
 
 class SearchQuery(TimeStampedModel):
@@ -61,9 +61,6 @@ def generate_queries_count_of_one_month(cls, project_slug):
         today = timezone.now().date()
         last_30th_day = timezone.now().date() - timezone.timedelta(days=30)
 
-        # this includes the current day also
-        last_31_days_iter = _get_last_31_days_iter()
-
         qs = cls.objects.filter(
             project__slug=project_slug,
             created__date__lte=today,
@@ -80,14 +77,17 @@ def generate_queries_count_of_one_month(cls, project_slug):
             .values_list('created_date', 'count')
         )
 
-        count_data = [count_dict.get(date) or 0 for date in last_31_days_iter]
+        count_data = [count_dict.get(date) or 0 for date in _last_30_days_iter()]
 
         # format the date value to a more readable form
         # Eg. `16 Jul`
-        last_31_days_str = _get_last_31_days_str(date_format='%d %b')
+        last_30_days_str = [
+            timezone.datetime.strftime(date, '%d %b')
+            for date in _last_30_days_iter()
+        ]
 
         final_data = {
-            'labels': last_31_days_str,
+            'labels': last_30_days_str,
             'int_data': count_data,
         }
 
@@ -114,10 +114,10 @@ class Meta:
         unique_together = ("project", "version", "path", "date")
 
     def __str__(self):
-        return f'PageView: [{self.project.slug}:{self.version.slug}] - {self.path}'
+        return f'PageView: [{self.project.slug}:{self.version.slug}] - {self.path} for {self.date}'
 
     @classmethod
-    def get_top_viewed_pages(cls, project):
+    def top_viewed_pages(cls, project, since=None):
         """
         Returns top 10 pages according to view counts.
 
@@ -131,9 +131,12 @@ def get_top_viewed_pages(cls, project):
         followed by `config-file/v1` and `intro/import-guide` having 120 and
         100 total page views respectively.
         """
+        if since is None:
+            since = timezone.now().date() - timezone.timedelta(days=30)
+
         qs = (
             cls.objects
-            .filter(project=project)
+            .filter(project=project, date__gte=since)
             .values_list('path')
             .annotate(total_views=Sum('view_count'))
             .values_list('path', 'total_views')
@@ -155,9 +158,9 @@ def get_top_viewed_pages(cls, project):
         return final_data
 
     @classmethod
-    def get_page_view_count_of_one_month(cls, project_slug, page_path):
+    def page_views_by_date(cls, project_slug, since=None):
         """
-        Returns the total page views count for last 30 days for a particular `page_path`.
+        Returns the total page views count for last 30 days for a particular project.
 
         Structure of returned data is compatible to make graphs.
         Sample returned data::
@@ -166,33 +169,33 @@ def get_page_view_count_of_one_month(cls, project_slug, page_path):
                 'int_data': [150, 200, 143]
             }
         This data shows that there were 150 page views on 01 July,
-        200 page views on 02 July and 143 page views on 03 July for a particular `page_path`.
+        200 page views on 02 July and 143 page views on 03 July.
         """
-        today = timezone.now().date()
-        last_30th_day = timezone.now().date() - timezone.timedelta(days=30)
-
-        # this includes the current day also
-        last_31_days_iter = _get_last_31_days_iter()
+        if since is None:
+            since = timezone.now().date() - timezone.timedelta(days=30)
 
         qs = cls.objects.filter(
             project__slug=project_slug,
-            path=page_path,
-        ).order_by('-date')
+            date__gt=since,
+        ).values('date').annotate(total_views=Sum('view_count')).order_by('date')
 
         count_dict = dict(
-            qs.values('date')
-            .order_by('date')
-            .values_list('date', 'view_count')
+            qs.order_by('date').values_list('date', 'total_views')
         )
 
-        count_data = [count_dict.get(date) or 0 for date in last_31_days_iter]
+        # This fills in any dates where there is no data
+        # to make sure we have a full 30 days of dates
+        count_data = [count_dict.get(date) or 0 for date in _last_30_days_iter()]
 
         # format the date value to a more readable form
         # Eg. `16 Jul`
-        last_31_days_str = _get_last_31_days_str(date_format='%d %b')
+        last_30_days_str = [
+            timezone.datetime.strftime(date, '%d %b')
+            for date in _last_30_days_iter()
+        ]
 
         final_data = {
-            'labels': last_31_days_str,
+            'labels': last_30_days_str,
             'int_data': count_data,
         }
 
diff --git a/readthedocs/search/tasks.py b/readthedocs/search/tasks.py
index 69a3d7961a9..221e4bd34df 100644
--- a/readthedocs/search/tasks.py
+++ b/readthedocs/search/tasks.py
@@ -225,3 +225,14 @@ def increase_page_view_count(project_slug, version_slug, path):
     PageView.objects.filter(pk=page_view.pk).update(
         view_count=F('view_count') + 1
     )
+
+
+@app.task(queue='web')
+def delete_old_page_counts():
+    """
+    Delete page counts older than 30 days.
+
+    This is intended to run from a periodic task daily.
+    """
+    thirty_days_ago = timezone.now().date() - timezone.timedelta(days=30)
+    return PageView.objects.filter(date__lt=thirty_days_ago).delete()
diff --git a/readthedocs/search/utils.py b/readthedocs/search/utils.py
index 89237dc78d3..70b0e5f0e80 100644
--- a/readthedocs/search/utils.py
+++ b/readthedocs/search/utils.py
@@ -156,21 +156,18 @@ def _get_sorted_results(results, source_key='_source'):
     return sorted_results
 
 
-def _get_last_31_days_iter():
-    """Returns iterator for last 31 days (including today)."""
-    today = timezone.now().date()
-    last_30th_day = timezone.now().date() - timezone.timedelta(days=30)
+def _last_30_days_iter():
+    """Returns iterator for previous 30 days (including today)."""
+    thirty_days_ago = timezone.now().date() - timezone.timedelta(days=30)
 
-    # this includes the current day also
-    last_31_days_iter = [last_30th_day + timezone.timedelta(days=n) for n in range(31)]
-    return last_31_days_iter
+    # this includes the current day, len() = 31
+    return (thirty_days_ago + timezone.timedelta(days=n) for n in range(31))
 
 
-def _get_last_31_days_str(date_format):
-    """Returns the list of dates in string format for last 31 days (including today)."""
-    last_31_days_iter = _get_last_31_days_iter()
-    last_31_days_str = [
+def _get_last_30_days_str(date_format='%Y-%m-%d'):
+    """Returns the list of dates in string format for previous 30 days (including today)."""
+    last_30_days_str = [
         timezone.datetime.strftime(date, date_format)
-        for date in last_31_days_iter
+        for date in _last_30_days_iter()
     ]
-    return last_31_days_str
+    return last_30_days_str
diff --git a/readthedocs/settings/base.py b/readthedocs/settings/base.py
index 0dace8774a4..3f07ea307d7 100644
--- a/readthedocs/settings/base.py
+++ b/readthedocs/settings/base.py
@@ -350,7 +350,12 @@ def USE_PROMOS(self):  # noqa
             'task': 'readthedocs.search.tasks.delete_old_search_queries_from_db',
             'schedule': crontab(minute=0, hour=0),
             'options': {'queue': 'web'},
-        }
+        },
+        'every-day-delete-old-page-views': {
+            'task': 'readthedocs.search.tasks.delete_old_page_counts',
+            'schedule': crontab(minute=0, hour=1),
+            'options': {'queue': 'web'},
+        },
     }
     MULTIPLE_APP_SERVERS = [CELERY_DEFAULT_QUEUE]
     MULTIPLE_BUILD_SERVERS = [CELERY_DEFAULT_QUEUE]
diff --git a/readthedocs/templates/projects/project_edit_base.html b/readthedocs/templates/projects/project_edit_base.html
index 43de55ddac9..2199bd0005d 100644
--- a/readthedocs/templates/projects/project_edit_base.html
+++ b/readthedocs/templates/projects/project_edit_base.html
@@ -27,8 +27,8 @@
         <li class="{% block project-environment-variables-active %}{% endblock %}"><a href="{% url "projects_environmentvariables" project.slug %}">{% trans "Environment Variables" %}</a></li>
         <li class="{% block project-automation-rules-active %}{% endblock %}"><a href="{% url "projects_automation_rule_list" project.slug %}">{% trans "Automation Rules" %}</a></li>
         <li class="{% block project-notifications-active %}{% endblock %}"><a href="{% url "projects_notifications" project.slug %}">{% trans "Notifications" %}</a></li>
+        <li class="{% block project-traffic-analytics-active %}{% endblock %}"><a href="{% url "projects_traffic_analytics" project.slug %}">{% trans "Traffic Analytics" %}</a></li>
         <li class="{% block project-search-analytics-active %}{% endblock %}"><a href="{% url "projects_search_analytics" project.slug %}">{% trans "Search Analytics" %}</a></li>
-        <li class="{% block project-page-views-active %}{% endblock %}"><a href="{% url "projects_page_views" project.slug %}">{% trans "Page Views" %}</a></li>
         {% if USE_PROMOS %}
           <li class="{% block project-ads-active %}{% endblock %}"><a href="{% url "projects_advertising" project.slug %}">{% trans "Advertising" %} </a></li>
         {% endif %}
diff --git a/readthedocs/templates/projects/project_page_views.html b/readthedocs/templates/projects/project_traffic_analytics.html
similarity index 61%
rename from readthedocs/templates/projects/project_page_views.html
rename to readthedocs/templates/projects/project_traffic_analytics.html
index cb875f97ab2..0de7e4e7b19 100644
--- a/readthedocs/templates/projects/project_page_views.html
+++ b/readthedocs/templates/projects/project_traffic_analytics.html
@@ -3,24 +3,22 @@
 {% load i18n %}
 {% load static %}
 
-{% block title %}{% trans "Page Views" %}{% endblock %}
+{% block title %}{% trans "Traffic Analytics" %}{% endblock %}
 
 {% block nav-dashboard %} class="active"{% endblock %}
 
-{% block project-page-views-active %}active{% endblock %}
-{% block project_edit_content_header %}{% trans "Page Views" %}{% endblock %}
+{% block project-traffic-analytics-active %}active{% endblock %}
+{% block project_edit_content_header %}{% trans "Traffic Analytics" %}{% endblock %}
 
 {% block project_edit_content %}
-	<h3>{% trans "Top Viewed Pages" %}</h3>
-		<div class="module-list">
+  <h3>{% trans "Top viewed pages of the past month" %}</h3>
+    <div class="module-list">
       <div class="module-list-wrapper">
         <ul class="long-list-overflow">
-          {% for page, count in top_viewed_pages_iter %}
+          {% for page, count in top_viewed_pages %}
             <li class="module-item">
               {{ page }}
-              <span class="right quiet">
-                {{ count }} {{ view|pluralize:"s" }}
-              </span>
+              <span class="right quiet">{{ count }}</span>
             </li>
           {% empty %}
             <li class="module-item">
@@ -33,17 +31,10 @@ <h3>{% trans "Top Viewed Pages" %}</h3>
       </div>
     </div>
 
-	<br/>
+  <br/>
 
-	<h2>{% trans "Page Views Per Page" %}</h2>
-  <form method="GET">
-    <select name="page" onchange="this.form.submit()">
-      {% for option in all_pages %}
-        <option value="{{ option }}" {% if page_path == option %}selected{% endif %}>{{ option }}</option>
-      {% endfor %}
-    </select>
-  </form>
-	<canvas id="page-views-per-page" width="400" height="150"></canvas>
+  <h2>{% trans "Overview of the past month" %}</h2>
+  <canvas id="page-views-per-page" width="400" height="150"></canvas>
 
 {% endblock %}
 
@@ -59,6 +50,8 @@ <h2>{% trans "Page Views Per Page" %}</h2>
 
 {% block footerjs %}
   var line_chart = document.getElementById("page-views-per-page").getContext("2d");
+
+  {# Using |safe here is ok since this is just integers and formatted dates #}
   var line_chart_labels = {{ page_data.labels|safe }};
   var line_chart_data = {{ page_data.int_data|safe }};
 
@@ -67,7 +60,7 @@ <h2>{% trans "Page Views Per Page" %}</h2>
     data: {
       labels: line_chart_labels,
       datasets: [{
-        label: "# of views for {{ page_path }}",
+        label: "# of views",
         data: line_chart_data,
         fill: false,
         borderColor: "rgba(75, 192, 192, 1)",
diff --git a/readthedocs/templates/projects/projects_search_analytics.html b/readthedocs/templates/projects/projects_search_analytics.html
index 93fa412f4ad..f713e4ebf1c 100644
--- a/readthedocs/templates/projects/projects_search_analytics.html
+++ b/readthedocs/templates/projects/projects_search_analytics.html
@@ -36,7 +36,7 @@ <h3>{% trans "Top queries" %}</h3>
 
   <br/>
   {% if query_count_of_1_month.labels and query_count_of_1_month.int_data %}
-    <h2>{% trans "Overview of the past 1 month:" %}</h2>
+    <h2>{% trans "Overview of the past month" %}</h2>
     <canvas id="analytics-chart-last-7-days" width="400" height="150"></canvas>
   {% endif %}
 

From 92bd4a371652c8b0a449f8e26a129fe44ec8ee80 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Mon, 11 May 2020 20:37:55 -0500
Subject: [PATCH 23/72] Search: Index more content from sphinx

Closes https://github.com/readthedocs/readthedocs.org/issues/7059
---
 readthedocs/search/parse_json.py | 99 ++++++++++++++++----------------
 1 file changed, 49 insertions(+), 50 deletions(-)

diff --git a/readthedocs/search/parse_json.py b/readthedocs/search/parse_json.py
index 715bd81c866..72eb37e8a09 100644
--- a/readthedocs/search/parse_json.py
+++ b/readthedocs/search/parse_json.py
@@ -13,7 +13,7 @@
 log = logging.getLogger(__name__)
 
 
-def generate_page_sections(body, fjson_storage_path):
+def generate_page_sections(page_title, body, fjson_storage_path):
     """Generate section dicts for each section."""
 
     # Removing all <dl> tags to prevent duplicate indexing with Sphinx Domains.
@@ -38,54 +38,49 @@ def generate_page_sections(body, fjson_storage_path):
     for node in nodes_to_be_removed:
         node.decompose()
 
-    # Capture text inside h1 before the first h2
-    h1_section = body.css('.section > h1')
-    if h1_section:
-        h1_section = h1_section[0]
-        div = h1_section.parent
-        h1_title = h1_section.text().replace('¶', '').strip()
-        h1_id = div.attributes.get('id', '')
-        h1_content = ''
-        next_p = body.css_first('h1').next
-        while next_p:
-            if next_p.tag == 'div' and 'class' in next_p.attributes:
-                if 'section' in next_p.attributes['class']:
-                    break
-
-            text = parse_content(next_p.text(), remove_first_line=False)
-
-            if h1_content:
-                if text:
-                    h1_content = f'{h1_content} {text}'
-            else:
-                h1_content = text
-
-            next_p = next_p.next
-
-        if h1_content:
-            yield {
-                'id': h1_id,
-                'title': h1_title,
-                'content': h1_content,
-            }
+    # Index content for pages that don't start with a title.
+    content = _get_content_from_tag(body.body.child)
+    if content:
+        yield {
+            'id': '',
+            'title': page_title,
+            'content': content,
+        }
 
-    # Capture text inside h2's
-    section_list = body.css('.section > h2')
-    for tag in section_list:
-        div = tag.parent
-        title = tag.text().replace('¶', '').strip()
-        section_id = div.attributes.get('id', '')
+    # sub-sections are nested, so they are children of the outer section.
+    # sections with the same level are neighbors.
+    for head_level in range(1, 7):
+        tags = body.css(f'.section > h{head_level}')
+        for tag in tags:
+            title = tag.text().replace('¶', '').strip()
 
-        content = div.text()
-        content = parse_content(content, remove_first_line=True)
+            div = tag.parent
+            section_id = div.attributes.get('id', '')
 
-        if content:
             yield {
                 'id': section_id,
                 'title': title,
-                'content': content,
+                'content': _get_content_from_tag(tag.next),
             }
 
+def _get_content_from_tag(tag):
+    contents = []
+    next_tag = tag
+    while next_tag and not _is_section(next_tag):
+        content = parse_content(next_tag.text())
+        if content:
+            contents.append(content)
+        next_tag = next_tag.next
+    return ' '.join(contents)
+
+
+def _is_section(tag):
+    """Check if the `tag` is a sphinx section (linkeable header)."""
+    return (
+        tag.tag == 'div' and
+        'section' in tag.attributes.get('class', [])
+    )
+
 
 def process_file(fjson_storage_path):
     """Read the fjson file from disk and parse it into a structured dict."""
@@ -111,10 +106,20 @@ def process_file(fjson_storage_path):
     else:
         log.info('Unable to index file due to no name %s', fjson_storage_path)
 
+    if 'title' in data:
+        title = data['title']
+        title = HTMLParser(title).text().replace('¶', '').strip()
+    else:
+        log.info('Unable to index title for: %s', fjson_storage_path)
+
     if data.get('body'):
         body = HTMLParser(data['body'])
         body_copy = HTMLParser(data['body'])
-        sections = generate_page_sections(body, fjson_storage_path)
+        sections = generate_page_sections(
+            page_title=title,
+            body=body,
+            fjson_storage_path=fjson_storage_path,
+        )
 
         # pass a copy of `body` so that the removed
         # nodes in the original don't reflect here.
@@ -122,12 +127,6 @@ def process_file(fjson_storage_path):
     else:
         log.info('Unable to index content for: %s', fjson_storage_path)
 
-    if 'title' in data:
-        title = data['title']
-        title = HTMLParser(title).text().replace('¶', '').strip()
-    else:
-        log.info('Unable to index title for: %s', fjson_storage_path)
-
     return {
         'path': path,
         'title': title,
@@ -195,8 +194,8 @@ def parse_content(content, remove_first_line=False):
     if remove_first_line and len(content) > 1:
         content = content[1:]
 
-    # converting newlines to ". "
-    content = ' '.join(text.strip() for text in content if text)
+    content = map(lambda x: x.strip(), content)
+    content = ' '.join(text for text in content if text)
     return content
 
 

From 1c859c234677c4ca3796ae39ea011835cc67d9f1 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Tue, 12 May 2020 12:02:39 -0500
Subject: [PATCH 24/72] Add tests

---
 readthedocs/search/parse_json.py              | 27 ++++++---
 .../search/tests/data/sphinx/in/no-title.html |  7 +++
 .../search/tests/data/sphinx/in/no-title.json | 59 +++++++++++++++++++
 .../search/tests/data/sphinx/in/page.html     | 22 +++++++
 .../search/tests/data/sphinx/in/page.json     | 59 +++++++++++++++++++
 .../tests/data/sphinx/out/no-title.json       | 12 ++++
 .../search/tests/data/sphinx/out/page.json    | 31 ++++++++++
 readthedocs/search/tests/test_parse_json.py   | 56 +++++++++++++++++-
 8 files changed, 264 insertions(+), 9 deletions(-)
 create mode 100644 readthedocs/search/tests/data/sphinx/in/no-title.html
 create mode 100644 readthedocs/search/tests/data/sphinx/in/no-title.json
 create mode 100644 readthedocs/search/tests/data/sphinx/in/page.html
 create mode 100644 readthedocs/search/tests/data/sphinx/in/page.json
 create mode 100644 readthedocs/search/tests/data/sphinx/out/no-title.json
 create mode 100644 readthedocs/search/tests/data/sphinx/out/page.json

diff --git a/readthedocs/search/parse_json.py b/readthedocs/search/parse_json.py
index 72eb37e8a09..3c356785da6 100644
--- a/readthedocs/search/parse_json.py
+++ b/readthedocs/search/parse_json.py
@@ -2,19 +2,29 @@
 
 import logging
 from urllib.parse import urlparse
-import orjson as json
 
+import orjson as json
 from django.conf import settings
 from django.core.files.storage import get_storage_class
-
 from selectolax.parser import HTMLParser
 
-
 log = logging.getLogger(__name__)
 
 
 def generate_page_sections(page_title, body, fjson_storage_path):
-    """Generate section dicts for each section."""
+    """
+    Generate section dicts for each section for sphinx.
+
+    In Sphinx sub-sections are nested, so they are children of the outer section,
+    and sections with the same level are neighbors.
+    We index the content under a section till before the next one.
+
+    We can have pages that have content before the first title or that don't have a title,
+    we index that content first under the title of the original page (`page_title`).
+
+    Contents that are likely to be a sphinx domain are deleted,
+    since we already index those in another step.
+    """
 
     # Removing all <dl> tags to prevent duplicate indexing with Sphinx Domains.
     nodes_to_be_removed = []
@@ -47,8 +57,7 @@ def generate_page_sections(page_title, body, fjson_storage_path):
             'content': content,
         }
 
-    # sub-sections are nested, so they are children of the outer section.
-    # sections with the same level are neighbors.
+    # Index content from h1 to h6 headers.
     for head_level in range(1, 7):
         tags = body.css(f'.section > h{head_level}')
         for tag in tags:
@@ -63,7 +72,9 @@ def generate_page_sections(page_title, body, fjson_storage_path):
                 'content': _get_content_from_tag(tag.next),
             }
 
+
 def _get_content_from_tag(tag):
+    """Gets the content from tag till before a new section."""
     contents = []
     next_tag = tag
     while next_tag and not _is_section(next_tag):
@@ -75,7 +86,7 @@ def _get_content_from_tag(tag):
 
 
 def _is_section(tag):
-    """Check if the `tag` is a sphinx section (linkeable header)."""
+    """Check if `tag` is a sphinx section (linkeable header)."""
     return (
         tag.tag == 'div' and
         'section' in tag.attributes.get('class', [])
@@ -130,7 +141,7 @@ def process_file(fjson_storage_path):
     return {
         'path': path,
         'title': title,
-        'sections': tuple(sections),
+        'sections': list(sections),
         'domain_data': domain_data,
     }
 
diff --git a/readthedocs/search/tests/data/sphinx/in/no-title.html b/readthedocs/search/tests/data/sphinx/in/no-title.html
new file mode 100644
index 00000000000..5af77ac2e7f
--- /dev/null
+++ b/readthedocs/search/tests/data/sphinx/in/no-title.html
@@ -0,0 +1,7 @@
+<p>A page without a title.</p>
+<p>Only content.</p>
+<ul class="simple">
+  <li>One</li>
+  <li>Two</li>
+  <li>Three</li>
+</ul>
diff --git a/readthedocs/search/tests/data/sphinx/in/no-title.json b/readthedocs/search/tests/data/sphinx/in/no-title.json
new file mode 100644
index 00000000000..ae78faddcef
--- /dev/null
+++ b/readthedocs/search/tests/data/sphinx/in/no-title.json
@@ -0,0 +1,59 @@
+{
+  "parents": [
+    {
+      "link": "../",
+      "title": "Guides"
+    }
+  ],
+  "prev": {
+    "link": "../conda/",
+    "title": "Conda Support"
+  },
+  "next": {
+    "link": "../feature-flags/",
+    "title": "Feature Flags"
+  },
+  "title": "&lt;no title&gt;",
+  "meta": {},
+  "body": "",
+  "metatags": "",
+  "rellinks": [
+    [
+      "genindex",
+      "General Index",
+      "I",
+      "index"
+    ],
+    [
+      "http-routingtable",
+      "HTTP Routing Table",
+      "",
+      "routing table"
+    ],
+    [
+      "guides/feature-flags",
+      "Feature Flags",
+      "N",
+      "next"
+    ],
+    [
+      "guides/conda",
+      "Conda Support",
+      "P",
+      "previous"
+    ]
+  ],
+  "sourcename": "guides/environment-variables.rst.txt",
+  "toc": "<ul class=\"simple\">\n</ul>\n",
+  "display_toc": false,
+  "page_source_suffix": ".rst",
+  "current_page_name": "guides/environment-variables",
+  "sidebars": [
+    "localtoc.html",
+    "relations.html",
+    "sourcelink.html",
+    "searchbox.html"
+  ],
+  "customsidebar": null,
+  "alabaster_version": "0.7.12"
+}
diff --git a/readthedocs/search/tests/data/sphinx/in/page.html b/readthedocs/search/tests/data/sphinx/in/page.html
new file mode 100644
index 00000000000..dcdcbac030e
--- /dev/null
+++ b/readthedocs/search/tests/data/sphinx/in/page.html
@@ -0,0 +1,22 @@
+<p>Content at the beginning.</p>
+
+<div class="section" id="i-need-secrets-or-environment-variables-in-my-build">
+  <h1>I Need Secrets (or Environment Variables) in my Build<a class="headerlink"
+      href="#i-need-secrets-or-environment-variables-in-my-build" title="Permalink to this headline">¶</a></h1>
+  <p>It may happen that your documentation depends on an authenticated service to be built properly.</p>
+</div>
+
+<div class="section" id="title-one">
+  <h1>Title One<a class="headerlink" href="#title-one" title="Permalink to this headline">¶</a></h1>
+  <p>This is another H1 title.</p>
+
+  <div class="section" id="sub-title-one">
+    <h2>Sub-title one<a class="headerlink" href="#sub-title-one" title="Permalink to this headline">¶</a></h2>
+    <p>Sub title</p>
+
+    <div class="section" id="subsub-title">
+      <h3>Subsub title<a class="headerlink" href="#subsub-title" title="Permalink to this headline">¶</a></h3>
+      <p>This is a H3 title.</p>
+    </div>
+  </div>
+</div>
diff --git a/readthedocs/search/tests/data/sphinx/in/page.json b/readthedocs/search/tests/data/sphinx/in/page.json
new file mode 100644
index 00000000000..464200077c7
--- /dev/null
+++ b/readthedocs/search/tests/data/sphinx/in/page.json
@@ -0,0 +1,59 @@
+{
+  "parents": [
+    {
+      "link": "../",
+      "title": "Guides"
+    }
+  ],
+  "prev": {
+    "link": "../conda/",
+    "title": "Conda Support"
+  },
+  "next": {
+    "link": "../feature-flags/",
+    "title": "Feature Flags"
+  },
+  "title": "I Need Secrets (or Environment Variables) in my Build",
+  "meta": {},
+  "body": "",
+  "metatags": "",
+  "rellinks": [
+    [
+      "genindex",
+      "General Index",
+      "I",
+      "index"
+    ],
+    [
+      "http-routingtable",
+      "HTTP Routing Table",
+      "",
+      "routing table"
+    ],
+    [
+      "guides/feature-flags",
+      "Feature Flags",
+      "N",
+      "next"
+    ],
+    [
+      "guides/conda",
+      "Conda Support",
+      "P",
+      "previous"
+    ]
+  ],
+  "sourcename": "guides/environment-variables.rst.txt",
+  "toc": "<ul>\n<li><a class=\"reference internal\" href=\"#\">I Need Secrets (or Environment Variables) in my Build</a></li>\n<li><a class=\"reference internal\" href=\"#title-one\">Title One</a><ul>\n<li><a class=\"reference internal\" href=\"#sub-title-one\">Sub-title one</a><ul>\n<li><a class=\"reference internal\" href=\"#subsub-title\">Subsub title</a></li>\n</ul>\n</li>\n</ul>\n</li>\n</ul>\n",
+  "display_toc": true,
+  "page_source_suffix": ".rst",
+  "current_page_name": "guides/environment-variables",
+  "sidebars": [
+    "localtoc.html",
+    "relations.html",
+    "sourcelink.html",
+    "searchbox.html"
+  ],
+  "customsidebar": null,
+  "alabaster_version": "0.7.12"
+}
diff --git a/readthedocs/search/tests/data/sphinx/out/no-title.json b/readthedocs/search/tests/data/sphinx/out/no-title.json
new file mode 100644
index 00000000000..5ad8077ab2e
--- /dev/null
+++ b/readthedocs/search/tests/data/sphinx/out/no-title.json
@@ -0,0 +1,12 @@
+{
+  "title": "<no title>",
+  "path": "guides/environment-variables",
+  "sections": [
+    {
+      "id": "",
+      "title": "<no title>",
+      "content": "A page without a title. Only content. One Two Three"
+    }
+  ],
+  "domain_data": {}
+}
diff --git a/readthedocs/search/tests/data/sphinx/out/page.json b/readthedocs/search/tests/data/sphinx/out/page.json
new file mode 100644
index 00000000000..1996fb2d976
--- /dev/null
+++ b/readthedocs/search/tests/data/sphinx/out/page.json
@@ -0,0 +1,31 @@
+{
+  "title": "I Need Secrets (or Environment Variables) in my Build",
+  "path": "guides/environment-variables",
+  "sections": [
+    {
+      "id": "",
+      "title": "I Need Secrets (or Environment Variables) in my Build",
+      "content": "Content at the beginning."
+    },
+    {
+      "id": "i-need-secrets-or-environment-variables-in-my-build",
+      "title": "I Need Secrets (or Environment Variables) in my Build",
+      "content": "It may happen that your documentation depends on an authenticated service to be built properly."
+    },
+    {
+      "content": "This is another H1 title.",
+      "id": "title-one",
+      "title": "Title One"
+    },
+    {
+      "content": "Sub title",
+      "id": "sub-title-one",
+      "title": "Sub-title one"},
+    {
+      "content": "This is a H3 title.",
+      "id": "subsub-title",
+      "title": "Subsub title"
+    }
+  ],
+  "domain_data": {}
+}
diff --git a/readthedocs/search/tests/test_parse_json.py b/readthedocs/search/tests/test_parse_json.py
index 3d6b3860041..e5ab1927da3 100644
--- a/readthedocs/search/tests/test_parse_json.py
+++ b/readthedocs/search/tests/test_parse_json.py
@@ -7,7 +7,7 @@
 from django_dynamic_fixture import get
 
 from readthedocs.builds.storage import BuildMediaFileSystemStorage
-from readthedocs.projects.constants import MKDOCS
+from readthedocs.projects.constants import MKDOCS, SPHINX
 from readthedocs.projects.models import HTMLFile, Project
 
 data_path = Path(__file__).parent.resolve() / 'data'
@@ -103,3 +103,57 @@ def test_mkdocs_old_version(self, storage_open, storage_exists):
         ]
         expected_json = json.load(open(data_path / 'mkdocs/out/search_index_old.json'))
         assert parsed_json == expected_json
+
+    @mock.patch.object(BuildMediaFileSystemStorage, 'exists')
+    @mock.patch.object(BuildMediaFileSystemStorage, 'open')
+    def test_sphinx(self, storage_open, storage_exists):
+        json_file = data_path / 'sphinx/in/page.json'
+        html_content = data_path / 'sphinx/in/page.html'
+
+        json_content = json.load(json_file.open())
+        json_content['body'] = html_content.open().read()
+        storage_open.side_effect = self._mock_open(
+            json.dumps(json_content)
+        )
+        storage_exists.return_value = True
+
+        self.version.documentation_type = SPHINX
+        self.version.save()
+
+        page_file = get(
+            HTMLFile,
+            project=self.project,
+            version=self.version,
+            path='page.html',
+        )
+
+        parsed_json = page_file.processed_json
+        expected_json = json.load(open(data_path / 'sphinx/out/page.json'))
+        assert parsed_json == expected_json
+
+    @mock.patch.object(BuildMediaFileSystemStorage, 'exists')
+    @mock.patch.object(BuildMediaFileSystemStorage, 'open')
+    def test_sphinx_page_without_title(self, storage_open, storage_exists):
+        json_file = data_path / 'sphinx/in/no-title.json'
+        html_content = data_path / 'sphinx/in/no-title.html'
+
+        json_content = json.load(json_file.open())
+        json_content['body'] = html_content.open().read()
+        storage_open.side_effect = self._mock_open(
+            json.dumps(json_content)
+        )
+        storage_exists.return_value = True
+
+        self.version.documentation_type = SPHINX
+        self.version.save()
+
+        page_file = get(
+            HTMLFile,
+            project=self.project,
+            version=self.version,
+            path='no-title.html',
+        )
+
+        parsed_json = page_file.processed_json
+        expected_json = json.load(open(data_path / 'sphinx/out/no-title.json'))
+        assert parsed_json == expected_json

From 2066a46b6a9efaf5cc9816b5614ebc0880f7c54c Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Tue, 12 May 2020 13:28:16 -0700
Subject: [PATCH 25/72] Add a page about choosing between .com/.org
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This is an initial attempt,
but I think it’s important to document this.
We get a lot of questions so it seems obvious we need to explain it better.
---
 docs/choosing-a-site.rst | 43 ++++++++++++++++++++++++++++++++++++++++
 docs/index.rst           |  1 +
 2 files changed, 44 insertions(+)
 create mode 100644 docs/choosing-a-site.rst

diff --git a/docs/choosing-a-site.rst b/docs/choosing-a-site.rst
new file mode 100644
index 00000000000..0f02918845e
--- /dev/null
+++ b/docs/choosing-a-site.rst
@@ -0,0 +1,43 @@
+Choosing between our two platforms
+==================================
+
+A question our users often have is what the difference is between |org_brand| and |com_brand|.
+This page will lay out the functional and philosophical differences between the two sites,
+which should help you choose which is a better fit for your organization.
+
+The features available on both platforms are the same.
+The primary difference is the audience and use cases that are supported.
+
+|org_brand|
+--------------------
+
+|org_brand| is meant for open source projects to use for documentation hosting.
+This is great for user and developer documentation for your project.
+
+Important points:
+
+* All documentation sites have advertising
+* Only supports public VCS repositories
+* All documentation is publicly accessible to the world
+* Less build time and fewer build resources (memory & CPU)
+
+|com_brand|
+-------------------
+
+|com_brand| is meant for companies and users who have private documentation.
+It works well for product documentation as well as internal docs for your developers.
+
+Important points:
+
+* No advertising
+* Allows importing *private*and public repositories from VCS.
+* Supports private versions that only your organization or people you give access to can see.
+* More build time and more build resources (memory & CPU)
+
+
+Questions?
+----------
+
+If you have a question about which platform would be best,
+you can email us at support@readthedocs.org.
+
diff --git a/docs/index.rst b/docs/index.rst
index 7b0bd26f8f8..8f107ee6a89 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -45,6 +45,7 @@ to help you create fantastic documentation for your project.
   :doc:`With Sphinx </intro/getting-started-with-sphinx>` |
   :doc:`With MkDocs </intro/getting-started-with-mkdocs>` |
   :doc:`Feature Overview </features>`
+  :doc:`Choosing between our two sites </choosing-a-site>`
 
 * **Importing your existing documentation**:
   :doc:`Import guide </intro/import-guide>`

From 76b5361c64b542cc243f68ca046521b753bf5b33 Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Tue, 12 May 2020 13:35:08 -0700
Subject: [PATCH 26/72] Missed a spot

---
 docs/choosing-a-site.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/choosing-a-site.rst b/docs/choosing-a-site.rst
index 0f02918845e..4b11654b1a1 100644
--- a/docs/choosing-a-site.rst
+++ b/docs/choosing-a-site.rst
@@ -1,5 +1,5 @@
-Choosing between our two platforms
-==================================
+Choosing between our two sites
+==============================
 
 A question our users often have is what the difference is between |org_brand| and |com_brand|.
 This page will lay out the functional and philosophical differences between the two sites,

From b533db07d14bce546147989aa3619057a58ab771 Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Tue, 12 May 2020 13:47:51 -0700
Subject: [PATCH 27/72] Review fixes

---
 docs/choosing-a-site.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/choosing-a-site.rst b/docs/choosing-a-site.rst
index 4b11654b1a1..e79749ce546 100644
--- a/docs/choosing-a-site.rst
+++ b/docs/choosing-a-site.rst
@@ -1,4 +1,4 @@
-Choosing between our two sites
+Choosing Between Our Two Sites
 ==============================
 
 A question our users often have is what the difference is between |org_brand| and |com_brand|.
@@ -30,7 +30,7 @@ It works well for product documentation as well as internal docs for your develo
 Important points:
 
 * No advertising
-* Allows importing *private*and public repositories from VCS.
+* Allows importing private and public repositories from VCS.
 * Supports private versions that only your organization or people you give access to can see.
 * More build time and more build resources (memory & CPU)
 

From 116b72ce373ae2db4dd52abf83d7082a6f361b88 Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Tue, 12 May 2020 13:52:41 -0700
Subject: [PATCH 28/72] Mention orgs

---
 docs/choosing-a-site.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/choosing-a-site.rst b/docs/choosing-a-site.rst
index e79749ce546..5376e27939b 100644
--- a/docs/choosing-a-site.rst
+++ b/docs/choosing-a-site.rst
@@ -20,6 +20,7 @@ Important points:
 * Only supports public VCS repositories
 * All documentation is publicly accessible to the world
 * Less build time and fewer build resources (memory & CPU)
+* Documentation is organized by projects
 
 |com_brand|
 -------------------
@@ -30,9 +31,10 @@ It works well for product documentation as well as internal docs for your develo
 Important points:
 
 * No advertising
-* Allows importing private and public repositories from VCS.
-* Supports private versions that only your organization or people you give access to can see.
+* Allows importing private and public repositories from VCS
+* Supports private versions that only your organization or people you give access to can see
 * More build time and more build resources (memory & CPU)
+* Documentation is organized by organization, giving more control over permissions
 
 
 Questions?

From e129b330d453414056385466b063c44f8c917078 Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Tue, 12 May 2020 14:19:01 -0700
Subject: [PATCH 29/72] Fix PR builds being marked built

This was removed in https://github.com/readthedocs/readthedocs.org/pull/7044,
and it's needed to properly link to the PR builds and update their status.
---
 readthedocs/projects/tasks.py | 20 ++++++++------------
 1 file changed, 8 insertions(+), 12 deletions(-)

diff --git a/readthedocs/projects/tasks.py b/readthedocs/projects/tasks.py
index 48d9e94d8ab..06ccde4300f 100644
--- a/readthedocs/projects/tasks.py
+++ b/readthedocs/projects/tasks.py
@@ -787,14 +787,13 @@ def run_build(self, record):
                     # We upload EXTERNAL version media files to blob storage
                     # We should have this check here to make sure
                     # the files don't get re-uploaded on web.
-                    if self.version.type != EXTERNAL:
-                        self.update_app_instances(
-                            html=bool(outcomes['html']),
-                            search=bool(outcomes['search']),
-                            localmedia=bool(outcomes['localmedia']),
-                            pdf=bool(outcomes['pdf']),
-                            epub=bool(outcomes['epub']),
-                        )
+                    self.update_app_instances(
+                        html=bool(outcomes['html']),
+                        search=bool(outcomes['search']),
+                        localmedia=bool(outcomes['localmedia']),
+                        pdf=bool(outcomes['pdf']),
+                        epub=bool(outcomes['epub']),
+                    )
                 else:
                     log.warning('No build ID, not syncing files')
 
@@ -1114,9 +1113,6 @@ def update_app_instances(
                 'Updating version failed, skipping file sync: version=%s',
                 self.version,
             )
-        hostname = socket.gethostname()
-
-        delete_unsynced_media = True
 
         # Broadcast finalization steps to web application instances
         fileify.delay(
@@ -1272,7 +1268,7 @@ def fileify(version_pk, commit, build):
     This is so we have an idea of what files we have in the database.
     """
     version = Version.objects.get_object_or_log(pk=version_pk)
-    if not version:
+    if not version or version.type == EXTERNAL:
         return
     project = version.project
 

From 90ac6731442570fa1a8bc7514114e57e25e95203 Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Tue, 12 May 2020 14:27:19 -0700
Subject: [PATCH 30/72] Fix comments

---
 readthedocs/projects/tasks.py | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/readthedocs/projects/tasks.py b/readthedocs/projects/tasks.py
index 06ccde4300f..79df64cfb6d 100644
--- a/readthedocs/projects/tasks.py
+++ b/readthedocs/projects/tasks.py
@@ -783,10 +783,7 @@ def run_build(self, record):
                         epub=bool(outcomes['epub']),
                     )
 
-                    # Finalize build and update web servers
-                    # We upload EXTERNAL version media files to blob storage
-                    # We should have this check here to make sure
-                    # the files don't get re-uploaded on web.
+                    # TODO: Remove this function and just update the DB and index search directly
                     self.update_app_instances(
                         html=bool(outcomes['html']),
                         search=bool(outcomes['search']),
@@ -1268,6 +1265,7 @@ def fileify(version_pk, commit, build):
     This is so we have an idea of what files we have in the database.
     """
     version = Version.objects.get_object_or_log(pk=version_pk)
+    # Don't index external version builds for now
     if not version or version.type == EXTERNAL:
         return
     project = version.project

From d663294511751782fd63306998540848ce21d31f Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Tue, 12 May 2020 14:53:05 -0700
Subject: [PATCH 31/72] Add to toc

---
 docs/index.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/docs/index.rst b/docs/index.rst
index 8f107ee6a89..379cbf895f9 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -56,11 +56,12 @@ to help you create fantastic documentation for your project.
    :hidden:
    :caption: First steps
 
-   intro/getting-started-with-sphinx
-   intro/getting-started-with-mkdocs
+   /intro/getting-started-with-sphinx
+   /intro/getting-started-with-mkdocs
 
-   intro/import-guide
-   features
+   /intro/import-guide
+   /features
+   /choosing-a-site
 
 
 Getting started with Read the Docs

From 82921ac0b727f25d41da28f592347ee60ed3f4f9 Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Tue, 12 May 2020 14:53:41 -0700
Subject: [PATCH 32/72] Use title directly

---
 docs/index.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/index.rst b/docs/index.rst
index 379cbf895f9..c8057acc7df 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -45,7 +45,7 @@ to help you create fantastic documentation for your project.
   :doc:`With Sphinx </intro/getting-started-with-sphinx>` |
   :doc:`With MkDocs </intro/getting-started-with-mkdocs>` |
   :doc:`Feature Overview </features>`
-  :doc:`Choosing between our two sites </choosing-a-site>`
+  :doc:`/choosing-a-site`
 
 * **Importing your existing documentation**:
   :doc:`Import guide </intro/import-guide>`

From 4c487755fb658f2361526f9db40959521518a770 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Tue, 12 May 2020 17:34:33 -0500
Subject: [PATCH 33/72] Search: generate full link from the server side

We were returning an invalid link from the api,
and the cliente was in charge of guessing the correct link.

This also drops our builder as dependency for search :tada:

Half fixex/ https://github.com/readthedocs/readthedocs.org/issues/5821
Fixes https://github.com/readthedocs/readthedocs.org/issues/6102
---
 .../static-src/core/js/doc-embed/search.js    |  9 +---
 .../static/core/js/readthedocs-doc-embed.js   |  2 +-
 readthedocs/search/api.py                     | 52 +++++++++++++------
 3 files changed, 39 insertions(+), 24 deletions(-)

diff --git a/readthedocs/core/static-src/core/js/doc-embed/search.js b/readthedocs/core/static-src/core/js/doc-embed/search.js
index e16cddf4671..d3b774ce749 100644
--- a/readthedocs/core/static-src/core/js/doc-embed/search.js
+++ b/readthedocs/core/static-src/core/js/doc-embed/search.js
@@ -74,14 +74,7 @@ function attach_elastic_search_query(data) {
                             }
                         }
 
-                        // Creating the result from elements
-                        var suffix = DOCUMENTATION_OPTIONS.FILE_SUFFIX;
-                        // Since sphinx 2.2.1 FILE_SUFFIX is .html for all builders,
-                        // and there is a new BUILDER option.
-                        if ('BUILDER' in DOCUMENTATION_OPTIONS && DOCUMENTATION_OPTIONS.BUILDER === 'readthedocsdirhtml') {
-                          suffix = '';
-                        }
-                        var link = doc.link + suffix + "?highlight=" + $.urlencode(query);
+                        var link = doc.link + "?highlight=" + $.urlencode(query);
 
                         var item = $('<a>', {'href': link});
 
diff --git a/readthedocs/core/static/core/js/readthedocs-doc-embed.js b/readthedocs/core/static/core/js/readthedocs-doc-embed.js
index 19496750196..97675bf4529 100644
--- a/readthedocs/core/static/core/js/readthedocs-doc-embed.js
+++ b/readthedocs/core/static/core/js/readthedocs-doc-embed.js
@@ -1 +1 @@
-!function o(s,a,l){function d(t,e){if(!a[t]){if(!s[t]){var i="function"==typeof require&&require;if(!e&&i)return i(t,!0);if(c)return c(t,!0);var n=new Error("Cannot find module '"+t+"'");throw n.code="MODULE_NOT_FOUND",n}var r=a[t]={exports:{}};s[t][0].call(r.exports,function(e){return d(s[t][1][e]||e)},r,r.exports,o,s,a,l)}return a[t].exports}for(var c="function"==typeof require&&require,e=0;e<l.length;e++)d(l[e]);return d}({1:[function(e,t,i){var n="undefined"!=typeof window?window.jQuery:e("jquery");t.exports.ThemeNav={navBar:null,win:null,winScroll:!1,winResize:!1,linkScroll:!1,winPosition:0,winHeight:null,docHeight:null,isRunning:!1,enable:function(t){var i=this;"undefined"==typeof withStickNav&&(t=!0),i.isRunning||(i.isRunning=!0,n(function(e){i.init(e),i.reset(),i.win.on("hashchange",i.reset),t&&i.win.on("scroll",function(){i.linkScroll||i.winScroll||(i.winScroll=!0,requestAnimationFrame(function(){i.onScroll()}))}),i.win.on("resize",function(){i.winResize||(i.winResize=!0,requestAnimationFrame(function(){i.onResize()}))}),i.onResize()}))},enableSticky:function(){this.enable(!0)},init:function(i){i(document);var n=this;this.navBar=i("div.wy-side-scroll:first"),this.win=i(window),i(document).on("click","[data-toggle='wy-nav-top']",function(){i("[data-toggle='wy-nav-shift']").toggleClass("shift"),i("[data-toggle='rst-versions']").toggleClass("shift")}).on("click",".wy-menu-vertical .current ul li a",function(){var e=i(this);i("[data-toggle='wy-nav-shift']").removeClass("shift"),i("[data-toggle='rst-versions']").toggleClass("shift"),n.toggleCurrent(e),n.hashChange()}).on("click","[data-toggle='rst-current-version']",function(){i("[data-toggle='rst-versions']").toggleClass("shift-up")}),i("table.docutils:not(.field-list,.footnote,.citation)").wrap("<div class='wy-table-responsive'></div>"),i("table.docutils.footnote").wrap("<div class='wy-table-responsive footnote'></div>"),i("table.docutils.citation").wrap("<div class='wy-table-responsive citation'></div>"),i(".wy-menu-vertical ul").not(".simple").siblings("a").each(function(){var t=i(this);expand=i('<span class="toctree-expand"></span>'),expand.on("click",function(e){return n.toggleCurrent(t),e.stopPropagation(),!1}),t.prepend(expand)})},reset:function(){var e=encodeURI(window.location.hash)||"#";try{var t=$(".wy-menu-vertical"),i=t.find('[href="'+e+'"]');if(0===i.length){var n=$('.document [id="'+e.substring(1)+'"]').closest("div.section");0===(i=t.find('[href="#'+n.attr("id")+'"]')).length&&(i=t.find('[href="#"]'))}0<i.length&&($(".wy-menu-vertical .current").removeClass("current"),i.addClass("current"),i.closest("li.toctree-l1").addClass("current"),i.closest("li.toctree-l1").parent().addClass("current"),i.closest("li.toctree-l1").addClass("current"),i.closest("li.toctree-l2").addClass("current"),i.closest("li.toctree-l3").addClass("current"),i.closest("li.toctree-l4").addClass("current"))}catch(e){console.log("Error expanding nav for anchor",e)}},onScroll:function(){this.winScroll=!1;var e=this.win.scrollTop(),t=e+this.winHeight,i=this.navBar.scrollTop()+(e-this.winPosition);e<0||t>this.docHeight||(this.navBar.scrollTop(i),this.winPosition=e)},onResize:function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()},hashChange:function(){this.linkScroll=!0,this.win.one("hashchange",function(){this.linkScroll=!1})},toggleCurrent:function(e){var t=e.closest("li");t.siblings("li.current").removeClass("current"),t.siblings().find("li.current").removeClass("current"),t.find("> ul li.current").removeClass("current"),t.toggleClass("current")}},"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:t.exports.ThemeNav,StickyNav:t.exports.ThemeNav}),function(){for(var o=0,e=["ms","moz","webkit","o"],t=0;t<e.length&&!window.requestAnimationFrame;++t)window.requestAnimationFrame=window[e[t]+"RequestAnimationFrame"],window.cancelAnimationFrame=window[e[t]+"CancelAnimationFrame"]||window[e[t]+"CancelRequestAnimationFrame"];window.requestAnimationFrame||(window.requestAnimationFrame=function(e,t){var i=(new Date).getTime(),n=Math.max(0,16-(i-o)),r=window.setTimeout(function(){e(i+n)},n);return o=i+n,r}),window.cancelAnimationFrame||(window.cancelAnimationFrame=function(e){clearTimeout(e)})}()},{jquery:"jquery"}],2:[function(e,t,i){var n=e("cssfilter").FilterCSS,r=e("cssfilter").getDefaultWhiteList,c=e("./util");function o(){return{a:["target","href","title"],abbr:["title"],address:[],area:["shape","coords","href","alt"],article:[],aside:[],audio:["autoplay","controls","loop","preload","src"],b:[],bdi:["dir"],bdo:["dir"],big:[],blockquote:["cite"],br:[],caption:[],center:[],cite:[],code:[],col:["align","valign","span","width"],colgroup:["align","valign","span","width"],dd:[],del:["datetime"],details:["open"],div:[],dl:[],dt:[],em:[],font:["color","size","face"],footer:[],h1:[],h2:[],h3:[],h4:[],h5:[],h6:[],header:[],hr:[],i:[],img:["src","alt","title","width","height"],ins:["datetime"],li:[],mark:[],nav:[],ol:[],p:[],pre:[],s:[],section:[],small:[],span:[],sub:[],sup:[],strong:[],table:["width","border","align","valign"],tbody:["align","valign"],td:["width","rowspan","colspan","align","valign"],tfoot:["align","valign"],th:["width","rowspan","colspan","align","valign"],thead:["align","valign"],tr:["rowspan","align","valign"],tt:[],u:[],ul:[],video:["autoplay","controls","loop","preload","src","height","width"]}}var s=new n;function a(e){return e.replace(l,"&lt;").replace(d,"&gt;")}var l=/</g,d=/>/g,u=/"/g,h=/&quot;/g,p=/&#([a-zA-Z0-9]*);?/gim,f=/&colon;?/gim,g=/&newline;?/gim,m=/((j\s*a\s*v\s*a|v\s*b|l\s*i\s*v\s*e)\s*s\s*c\s*r\s*i\s*p\s*t\s*|m\s*o\s*c\s*h\s*a)\:/gi,v=/e\s*x\s*p\s*r\s*e\s*s\s*s\s*i\s*o\s*n\s*\(.*/gi,w=/u\s*r\s*l\s*\(.*/gi;function b(e){return e.replace(u,"&quot;")}function _(e){return e.replace(h,'"')}function y(e){return e.replace(p,function(e,t){return"x"===t[0]||"X"===t[0]?String.fromCharCode(parseInt(t.substr(1),16)):String.fromCharCode(parseInt(t,10))})}function x(e){return e.replace(f,":").replace(g," ")}function k(e){for(var t="",i=0,n=e.length;i<n;i++)t+=e.charCodeAt(i)<32?" ":e.charAt(i);return c.trim(t)}function T(e){return e=k(e=x(e=y(e=_(e))))}function E(e){return e=a(e=b(e))}var O=/<!--[\s\S]*?-->/g;i.whiteList={a:["target","href","title"],abbr:["title"],address:[],area:["shape","coords","href","alt"],article:[],aside:[],audio:["autoplay","controls","loop","preload","src"],b:[],bdi:["dir"],bdo:["dir"],big:[],blockquote:["cite"],br:[],caption:[],center:[],cite:[],code:[],col:["align","valign","span","width"],colgroup:["align","valign","span","width"],dd:[],del:["datetime"],details:["open"],div:[],dl:[],dt:[],em:[],font:["color","size","face"],footer:[],h1:[],h2:[],h3:[],h4:[],h5:[],h6:[],header:[],hr:[],i:[],img:["src","alt","title","width","height"],ins:["datetime"],li:[],mark:[],nav:[],ol:[],p:[],pre:[],s:[],section:[],small:[],span:[],sub:[],sup:[],strong:[],table:["width","border","align","valign"],tbody:["align","valign"],td:["width","rowspan","colspan","align","valign"],tfoot:["align","valign"],th:["width","rowspan","colspan","align","valign"],thead:["align","valign"],tr:["rowspan","align","valign"],tt:[],u:[],ul:[],video:["autoplay","controls","loop","preload","src","height","width"]},i.getDefaultWhiteList=o,i.onTag=function(e,t,i){},i.onIgnoreTag=function(e,t,i){},i.onTagAttr=function(e,t,i){},i.onIgnoreTagAttr=function(e,t,i){},i.safeAttrValue=function(e,t,i,n){if(i=T(i),"href"===t||"src"===t){if("#"===(i=c.trim(i)))return"#";if("http://"!==i.substr(0,7)&&"https://"!==i.substr(0,8)&&"mailto:"!==i.substr(0,7)&&"tel:"!==i.substr(0,4)&&"#"!==i[0]&&"/"!==i[0])return""}else if("background"===t){if(m.lastIndex=0,m.test(i))return""}else if("style"===t){if(v.lastIndex=0,v.test(i))return"";if(w.lastIndex=0,w.test(i)&&(m.lastIndex=0,m.test(i)))return"";!1!==n&&(i=(n=n||s).process(i))}return i=E(i)},i.escapeHtml=a,i.escapeQuote=b,i.unescapeQuote=_,i.escapeHtmlEntities=y,i.escapeDangerHtml5Entities=x,i.clearNonPrintableCharacter=k,i.friendlyAttrValue=T,i.escapeAttrValue=E,i.onIgnoreTagStripAll=function(){return""},i.StripTagBody=function(o,s){"function"!=typeof s&&(s=function(){});var a=!Array.isArray(o),l=[],d=!1;return{onIgnoreTag:function(e,t,i){if(function(e){return a||-1!==c.indexOf(o,e)}(e)){if(i.isClosing){var n="[/removed]",r=i.position+n.length;return l.push([!1!==d?d:i.position,r]),d=!1,n}return d=d||i.position,"[removed]"}return s(e,t,i)},remove:function(t){var i="",n=0;return c.forEach(l,function(e){i+=t.slice(n,e[0]),n=e[1]}),i+=t.slice(n)}}},i.stripCommentTag=function(e){return e.replace(O,"")},i.stripBlankChar=function(e){var t=e.split("");return(t=t.filter(function(e){var t=e.charCodeAt(0);return 127!==t&&(!(t<=31)||(10===t||13===t))})).join("")},i.cssFilter=s,i.getDefaultCSSWhiteList=r},{"./util":5,cssfilter:10}],3:[function(e,t,i){var n=e("./default"),r=e("./parser"),o=e("./xss");for(var s in(i=t.exports=function(e,t){return new o(t).process(e)}).FilterXSS=o,n)i[s]=n[s];for(var s in r)i[s]=r[s];"undefined"!=typeof window&&(window.filterXSS=t.exports)},{"./default":2,"./parser":4,"./xss":6}],4:[function(e,t,i){var c=e("./util");function h(e){var t=c.spaceIndex(e);if(-1===t)var i=e.slice(1,-1);else i=e.slice(1,t+1);return"/"===(i=c.trim(i).toLowerCase()).slice(0,1)&&(i=i.slice(1)),"/"===i.slice(-1)&&(i=i.slice(0,-1)),i}var u=/[^a-zA-Z0-9_:\.\-]/gim;function p(e,t){for(;t<e.length;t++){var i=e[t];if(" "!==i)return"="===i?t:-1}}function f(e,t){for(;0<t;t--){var i=e[t];if(" "!==i)return"="===i?t:-1}}function g(e){return function(e){return'"'===e[0]&&'"'===e[e.length-1]||"'"===e[0]&&"'"===e[e.length-1]}(e)?e.substr(1,e.length-2):e}i.parseTag=function(e,t,i){var n="",r=0,o=!1,s=!1,a=0,l=e.length,d="",c="";for(a=0;a<l;a++){var u=e.charAt(a);if(!1===o){if("<"===u){o=a;continue}}else if(!1===s){if("<"===u){n+=i(e.slice(r,a)),r=o=a;continue}if(">"===u){n+=i(e.slice(r,o)),c=h(d=e.slice(o,a+1)),n+=t(o,n.length,c,d,"</"===d.slice(0,2)),r=a+1,o=!1;continue}if(('"'===u||"'"===u)&&"="===e.charAt(a-1)){s=u;continue}}else if(u===s){s=!1;continue}}return r<e.length&&(n+=i(e.substr(r))),n},i.parseAttr=function(e,n){var t=0,r=[],i=!1,o=e.length;function s(e,t){if(!((e=(e=c.trim(e)).replace(u,"").toLowerCase()).length<1)){var i=n(e,t||"");i&&r.push(i)}}for(var a=0;a<o;a++){var l,d=e.charAt(a);if(!1!==i||"="!==d)if(!1===i||a!==t||'"'!==d&&"'"!==d||"="!==e.charAt(a-1))if(/\s|\n|\t/.test(d)){if(e=e.replace(/\s|\n|\t/g," "),!1===i){if(-1===(l=p(e,a))){s(c.trim(e.slice(t,a))),i=!1,t=a+1;continue}a=l-1;continue}if(-1!==(l=f(e,a-1)))continue;s(i,g(c.trim(e.slice(t,a)))),i=!1,t=a+1}else;else{if(-1===(l=e.indexOf(d,a+1)))break;s(i,c.trim(e.slice(t+1,l))),i=!1,t=(a=l)+1}else i=e.slice(t,a),t=a+1}return t<e.length&&(!1===i?s(e.slice(t)):s(i,g(c.trim(e.slice(t))))),c.trim(r.join(" "))}},{"./util":5}],5:[function(e,t,i){t.exports={indexOf:function(e,t){var i,n;if(Array.prototype.indexOf)return e.indexOf(t);for(i=0,n=e.length;i<n;i++)if(e[i]===t)return i;return-1},forEach:function(e,t,i){var n,r;if(Array.prototype.forEach)return e.forEach(t,i);for(n=0,r=e.length;n<r;n++)t.call(i,e[n],n,e)},trim:function(e){return String.prototype.trim?e.trim():e.replace(/(^\s*)|(\s*$)/g,"")},spaceIndex:function(e){var t=/\s|\n|\t/.exec(e);return t?t.index:-1}}},{}],6:[function(e,t,i){var n=e("cssfilter").FilterCSS,r=e("./default"),o=e("./parser"),s=o.parseTag,w=o.parseAttr,b=e("./util");function _(e){return null==e}function a(e){(e=function(e){var t={};for(var i in e)t[i]=e[i];return t}(e||{})).stripIgnoreTag&&(e.onIgnoreTag&&console.error('Notes: cannot use these two options "stripIgnoreTag" and "onIgnoreTag" at the same time'),e.onIgnoreTag=r.onIgnoreTagStripAll),e.whiteList=e.whiteList||r.whiteList,e.onTag=e.onTag||r.onTag,e.onTagAttr=e.onTagAttr||r.onTagAttr,e.onIgnoreTag=e.onIgnoreTag||r.onIgnoreTag,e.onIgnoreTagAttr=e.onIgnoreTagAttr||r.onIgnoreTagAttr,e.safeAttrValue=e.safeAttrValue||r.safeAttrValue,e.escapeHtml=e.escapeHtml||r.escapeHtml,!1===(this.options=e).css?this.cssFilter=!1:(e.css=e.css||{},this.cssFilter=new n(e.css))}a.prototype.process=function(e){if(!(e=(e=e||"").toString()))return"";var t=this.options,c=t.whiteList,u=t.onTag,h=t.onIgnoreTag,p=t.onTagAttr,f=t.onIgnoreTagAttr,g=t.safeAttrValue,m=t.escapeHtml,v=this.cssFilter;t.stripBlankChar&&(e=r.stripBlankChar(e)),t.allowCommentTag||(e=r.stripCommentTag(e));var i=!1;if(t.stripIgnoreTagBody){i=r.StripTagBody(t.stripIgnoreTagBody,h);h=i.onIgnoreTag}var n=s(e,function(e,t,r,i,n){var o,s={sourcePosition:e,position:t,isClosing:n,isWhite:r in c};if(!_(o=u(r,i,s)))return o;if(s.isWhite){if(s.isClosing)return"</"+r+">";var a=function(e){var t=b.spaceIndex(e);if(-1===t)return{html:"",closing:"/"===e[e.length-2]};var i="/"===(e=b.trim(e.slice(t+1,-1)))[e.length-1];return i&&(e=b.trim(e.slice(0,-1))),{html:e,closing:i}}(i),l=c[r],d=w(a.html,function(e,t){var i,n=-1!==b.indexOf(l,e);return _(i=p(r,e,t,n))?n?(t=g(r,e,t,v))?e+'="'+t+'"':e:_(i=f(r,e,t,n))?void 0:i:i});i="<"+r;return d&&(i+=" "+d),a.closing&&(i+=" /"),i+=">"}return _(o=h(r,i,s))?m(i):o},m);return i&&(n=i.remove(n)),n},t.exports=a},{"./default":2,"./parser":4,"./util":5,cssfilter:10}],7:[function(e,t,i){var n,r;n=this,r=function(){var T=!0;function s(i){function e(e){var t=i.match(e);return t&&1<t.length&&t[1]||""}function t(e){var t=i.match(e);return t&&1<t.length&&t[2]||""}var n,r=e(/(ipod|iphone|ipad)/i).toLowerCase(),o=!/like android/i.test(i)&&/android/i.test(i),s=/nexus\s*[0-6]\s*/i.test(i),a=!s&&/nexus\s*[0-9]+/i.test(i),l=/CrOS/.test(i),d=/silk/i.test(i),c=/sailfish/i.test(i),u=/tizen/i.test(i),h=/(web|hpw)(o|0)s/i.test(i),p=/windows phone/i.test(i),f=(/SamsungBrowser/i.test(i),!p&&/windows/i.test(i)),g=!r&&!d&&/macintosh/i.test(i),m=!o&&!c&&!u&&!h&&/linux/i.test(i),v=t(/edg([ea]|ios)\/(\d+(\.\d+)?)/i),w=e(/version\/(\d+(\.\d+)?)/i),b=/tablet/i.test(i)&&!/tablet pc/i.test(i),_=!b&&/[^-]mobi/i.test(i),y=/xbox/i.test(i);/opera/i.test(i)?n={name:"Opera",opera:T,version:w||e(/(?:opera|opr|opios)[\s\/](\d+(\.\d+)?)/i)}:/opr\/|opios/i.test(i)?n={name:"Opera",opera:T,version:e(/(?:opr|opios)[\s\/](\d+(\.\d+)?)/i)||w}:/SamsungBrowser/i.test(i)?n={name:"Samsung Internet for Android",samsungBrowser:T,version:w||e(/(?:SamsungBrowser)[\s\/](\d+(\.\d+)?)/i)}:/Whale/i.test(i)?n={name:"NAVER Whale browser",whale:T,version:e(/(?:whale)[\s\/](\d+(?:\.\d+)+)/i)}:/MZBrowser/i.test(i)?n={name:"MZ Browser",mzbrowser:T,version:e(/(?:MZBrowser)[\s\/](\d+(?:\.\d+)+)/i)}:/coast/i.test(i)?n={name:"Opera Coast",coast:T,version:w||e(/(?:coast)[\s\/](\d+(\.\d+)?)/i)}:/focus/i.test(i)?n={name:"Focus",focus:T,version:e(/(?:focus)[\s\/](\d+(?:\.\d+)+)/i)}:/yabrowser/i.test(i)?n={name:"Yandex Browser",yandexbrowser:T,version:w||e(/(?:yabrowser)[\s\/](\d+(\.\d+)?)/i)}:/ucbrowser/i.test(i)?n={name:"UC Browser",ucbrowser:T,version:e(/(?:ucbrowser)[\s\/](\d+(?:\.\d+)+)/i)}:/mxios/i.test(i)?n={name:"Maxthon",maxthon:T,version:e(/(?:mxios)[\s\/](\d+(?:\.\d+)+)/i)}:/epiphany/i.test(i)?n={name:"Epiphany",epiphany:T,version:e(/(?:epiphany)[\s\/](\d+(?:\.\d+)+)/i)}:/puffin/i.test(i)?n={name:"Puffin",puffin:T,version:e(/(?:puffin)[\s\/](\d+(?:\.\d+)?)/i)}:/sleipnir/i.test(i)?n={name:"Sleipnir",sleipnir:T,version:e(/(?:sleipnir)[\s\/](\d+(?:\.\d+)+)/i)}:/k-meleon/i.test(i)?n={name:"K-Meleon",kMeleon:T,version:e(/(?:k-meleon)[\s\/](\d+(?:\.\d+)+)/i)}:p?(n={name:"Windows Phone",osname:"Windows Phone",windowsphone:T},v?(n.msedge=T,n.version=v):(n.msie=T,n.version=e(/iemobile\/(\d+(\.\d+)?)/i))):/msie|trident/i.test(i)?n={name:"Internet Explorer",msie:T,version:e(/(?:msie |rv:)(\d+(\.\d+)?)/i)}:l?n={name:"Chrome",osname:"Chrome OS",chromeos:T,chromeBook:T,chrome:T,version:e(/(?:chrome|crios|crmo)\/(\d+(\.\d+)?)/i)}:/edg([ea]|ios)/i.test(i)?n={name:"Microsoft Edge",msedge:T,version:v}:/vivaldi/i.test(i)?n={name:"Vivaldi",vivaldi:T,version:e(/vivaldi\/(\d+(\.\d+)?)/i)||w}:c?n={name:"Sailfish",osname:"Sailfish OS",sailfish:T,version:e(/sailfish\s?browser\/(\d+(\.\d+)?)/i)}:/seamonkey\//i.test(i)?n={name:"SeaMonkey",seamonkey:T,version:e(/seamonkey\/(\d+(\.\d+)?)/i)}:/firefox|iceweasel|fxios/i.test(i)?(n={name:"Firefox",firefox:T,version:e(/(?:firefox|iceweasel|fxios)[ \/](\d+(\.\d+)?)/i)},/\((mobile|tablet);[^\)]*rv:[\d\.]+\)/i.test(i)&&(n.firefoxos=T,n.osname="Firefox OS")):d?n={name:"Amazon Silk",silk:T,version:e(/silk\/(\d+(\.\d+)?)/i)}:/phantom/i.test(i)?n={name:"PhantomJS",phantom:T,version:e(/phantomjs\/(\d+(\.\d+)?)/i)}:/slimerjs/i.test(i)?n={name:"SlimerJS",slimer:T,version:e(/slimerjs\/(\d+(\.\d+)?)/i)}:/blackberry|\bbb\d+/i.test(i)||/rim\stablet/i.test(i)?n={name:"BlackBerry",osname:"BlackBerry OS",blackberry:T,version:w||e(/blackberry[\d]+\/(\d+(\.\d+)?)/i)}:h?(n={name:"WebOS",osname:"WebOS",webos:T,version:w||e(/w(?:eb)?osbrowser\/(\d+(\.\d+)?)/i)},/touchpad\//i.test(i)&&(n.touchpad=T)):/bada/i.test(i)?n={name:"Bada",osname:"Bada",bada:T,version:e(/dolfin\/(\d+(\.\d+)?)/i)}:u?n={name:"Tizen",osname:"Tizen",tizen:T,version:e(/(?:tizen\s?)?browser\/(\d+(\.\d+)?)/i)||w}:/qupzilla/i.test(i)?n={name:"QupZilla",qupzilla:T,version:e(/(?:qupzilla)[\s\/](\d+(?:\.\d+)+)/i)||w}:/chromium/i.test(i)?n={name:"Chromium",chromium:T,version:e(/(?:chromium)[\s\/](\d+(?:\.\d+)?)/i)||w}:/chrome|crios|crmo/i.test(i)?n={name:"Chrome",chrome:T,version:e(/(?:chrome|crios|crmo)\/(\d+(\.\d+)?)/i)}:o?n={name:"Android",version:w}:/safari|applewebkit/i.test(i)?(n={name:"Safari",safari:T},w&&(n.version=w)):r?(n={name:"iphone"==r?"iPhone":"ipad"==r?"iPad":"iPod"},w&&(n.version=w)):n=/googlebot/i.test(i)?{name:"Googlebot",googlebot:T,version:e(/googlebot\/(\d+(\.\d+))/i)||w}:{name:e(/^(.*)\/(.*) /),version:t(/^(.*)\/(.*) /)},!n.msedge&&/(apple)?webkit/i.test(i)?(/(apple)?webkit\/537\.36/i.test(i)?(n.name=n.name||"Blink",n.blink=T):(n.name=n.name||"Webkit",n.webkit=T),!n.version&&w&&(n.version=w)):!n.opera&&/gecko\//i.test(i)&&(n.name=n.name||"Gecko",n.gecko=T,n.version=n.version||e(/gecko\/(\d+(\.\d+)?)/i)),n.windowsphone||!o&&!n.silk?!n.windowsphone&&r?(n[r]=T,n.ios=T,n.osname="iOS"):g?(n.mac=T,n.osname="macOS"):y?(n.xbox=T,n.osname="Xbox"):f?(n.windows=T,n.osname="Windows"):m&&(n.linux=T,n.osname="Linux"):(n.android=T,n.osname="Android");var x="";n.windows?x=function(e){switch(e){case"NT":return"NT";case"XP":return"XP";case"NT 5.0":return"2000";case"NT 5.1":return"XP";case"NT 5.2":return"2003";case"NT 6.0":return"Vista";case"NT 6.1":return"7";case"NT 6.2":return"8";case"NT 6.3":return"8.1";case"NT 10.0":return"10";default:return}}(e(/Windows ((NT|XP)( \d\d?.\d)?)/i)):n.windowsphone?x=e(/windows phone (?:os)?\s?(\d+(\.\d+)*)/i):n.mac?x=(x=e(/Mac OS X (\d+([_\.\s]\d+)*)/i)).replace(/[_\s]/g,"."):r?x=(x=e(/os (\d+([_\s]\d+)*) like mac os x/i)).replace(/[_\s]/g,"."):o?x=e(/android[ \/-](\d+(\.\d+)*)/i):n.webos?x=e(/(?:web|hpw)os\/(\d+(\.\d+)*)/i):n.blackberry?x=e(/rim\stablet\sos\s(\d+(\.\d+)*)/i):n.bada?x=e(/bada\/(\d+(\.\d+)*)/i):n.tizen&&(x=e(/tizen[\/\s](\d+(\.\d+)*)/i)),x&&(n.osversion=x);var k=!n.windows&&x.split(".")[0];return b||a||"ipad"==r||o&&(3==k||4<=k&&!_)||n.silk?n.tablet=T:(_||"iphone"==r||"ipod"==r||o||s||n.blackberry||n.webos||n.bada)&&(n.mobile=T),n.msedge||n.msie&&10<=n.version||n.yandexbrowser&&15<=n.version||n.vivaldi&&1<=n.version||n.chrome&&20<=n.version||n.samsungBrowser&&4<=n.version||n.whale&&1===E([n.version,"1.0"])||n.mzbrowser&&1===E([n.version,"6.0"])||n.focus&&1===E([n.version,"1.0"])||n.firefox&&20<=n.version||n.safari&&6<=n.version||n.opera&&10<=n.version||n.ios&&n.osversion&&6<=n.osversion.split(".")[0]||n.blackberry&&10.1<=n.version||n.chromium&&20<=n.version?n.a=T:n.msie&&n.version<10||n.chrome&&n.version<20||n.firefox&&n.version<20||n.safari&&n.version<6||n.opera&&n.version<10||n.ios&&n.osversion&&n.osversion.split(".")[0]<6||n.chromium&&n.version<20?n.c=T:n.x=T,n}var a=s("undefined"!=typeof navigator&&navigator.userAgent||"");function n(e){return e.split(".").length}function r(e,t){var i,n=[];if(Array.prototype.map)return Array.prototype.map.call(e,t);for(i=0;i<e.length;i++)n.push(t(e[i]));return n}function E(e){for(var i=Math.max(n(e[0]),n(e[1])),t=r(e,function(e){var t=i-n(e);return r((e+=new Array(1+t).join(".0")).split("."),function(e){return new Array(20-e.length).join("0")+e}).reverse()});0<=--i;){if(t[0][i]>t[1][i])return 1;if(t[0][i]!==t[1][i])return-1;if(0===i)return 0}}function o(e,t,i){var n=a;"string"==typeof t&&(i=t,t=void 0),void 0===t&&(t=!1),i&&(n=s(i));var r=""+n.version;for(var o in e)if(e.hasOwnProperty(o)&&n[o]){if("string"!=typeof e[o])throw new Error("Browser version in the minVersion map should be a string: "+o+": "+String(e));return E([r,e[o]])<0}return t}return a.test=function(e){for(var t=0;t<e.length;++t){var i=e[t];if("string"==typeof i&&i in a)return!0}return!1},a.isUnsupportedBrowser=o,a.compareVersions=E,a.check=function(e,t,i){return!o(e,t,i)},a._detect=s,a.detect=s,a},void 0!==t&&t.exports?t.exports=r():"function"==typeof define&&define.amd?define("bowser",r):n.bowser=r()},{}],8:[function(e,t,i){var n=e("./default"),r=e("./parser");e("./util");function h(e){return null==e}function o(e){(e=e||{}).whiteList=e.whiteList||n.whiteList,e.onAttr=e.onAttr||n.onAttr,e.onIgnoreAttr=e.onIgnoreAttr||n.onIgnoreAttr,this.options=e}o.prototype.process=function(e){if(!(e=(e=e||"").toString()))return"";var t=this.options,d=t.whiteList,c=t.onAttr,u=t.onIgnoreAttr;return r(e,function(e,t,i,n,r){var o=d[i],s=!1;!0===o?s=o:"function"==typeof o?s=o(n):o instanceof RegExp&&(s=o.test(n)),!0!==s&&(s=!1);var a,l={position:t,sourcePosition:e,source:r,isWhite:s};return s?h(a=c(i,n,l))?i+":"+n:a:h(a=u(i,n,l))?void 0:a})},t.exports=o},{"./default":9,"./parser":11,"./util":12}],9:[function(e,t,i){function n(){var e={"align-content":!1,"align-items":!1,"align-self":!1,"alignment-adjust":!1,"alignment-baseline":!1,all:!1,"anchor-point":!1,animation:!1,"animation-delay":!1,"animation-direction":!1,"animation-duration":!1,"animation-fill-mode":!1,"animation-iteration-count":!1,"animation-name":!1,"animation-play-state":!1,"animation-timing-function":!1,azimuth:!1,"backface-visibility":!1,background:!0,"background-attachment":!0,"background-clip":!0,"background-color":!0,"background-image":!0,"background-origin":!0,"background-position":!0,"background-repeat":!0,"background-size":!0,"baseline-shift":!1,binding:!1,bleed:!1,"bookmark-label":!1,"bookmark-level":!1,"bookmark-state":!1,border:!0,"border-bottom":!0,"border-bottom-color":!0,"border-bottom-left-radius":!0,"border-bottom-right-radius":!0,"border-bottom-style":!0,"border-bottom-width":!0,"border-collapse":!0,"border-color":!0,"border-image":!0,"border-image-outset":!0,"border-image-repeat":!0,"border-image-slice":!0,"border-image-source":!0,"border-image-width":!0,"border-left":!0,"border-left-color":!0,"border-left-style":!0,"border-left-width":!0,"border-radius":!0,"border-right":!0,"border-right-color":!0,"border-right-style":!0,"border-right-width":!0,"border-spacing":!0,"border-style":!0,"border-top":!0,"border-top-color":!0,"border-top-left-radius":!0,"border-top-right-radius":!0,"border-top-style":!0,"border-top-width":!0,"border-width":!0,bottom:!1,"box-decoration-break":!0,"box-shadow":!0,"box-sizing":!0,"box-snap":!0,"box-suppress":!0,"break-after":!0,"break-before":!0,"break-inside":!0,"caption-side":!1,chains:!1,clear:!0,clip:!1,"clip-path":!1,"clip-rule":!1,color:!0,"color-interpolation-filters":!0,"column-count":!1,"column-fill":!1,"column-gap":!1,"column-rule":!1,"column-rule-color":!1,"column-rule-style":!1,"column-rule-width":!1,"column-span":!1,"column-width":!1,columns:!1,contain:!1,content:!1,"counter-increment":!1,"counter-reset":!1,"counter-set":!1,crop:!1,cue:!1,"cue-after":!1,"cue-before":!1,cursor:!1,direction:!1,display:!0,"display-inside":!0,"display-list":!0,"display-outside":!0,"dominant-baseline":!1,elevation:!1,"empty-cells":!1,filter:!1,flex:!1,"flex-basis":!1,"flex-direction":!1,"flex-flow":!1,"flex-grow":!1,"flex-shrink":!1,"flex-wrap":!1,float:!1,"float-offset":!1,"flood-color":!1,"flood-opacity":!1,"flow-from":!1,"flow-into":!1,font:!0,"font-family":!0,"font-feature-settings":!0,"font-kerning":!0,"font-language-override":!0,"font-size":!0,"font-size-adjust":!0,"font-stretch":!0,"font-style":!0,"font-synthesis":!0,"font-variant":!0,"font-variant-alternates":!0,"font-variant-caps":!0,"font-variant-east-asian":!0,"font-variant-ligatures":!0,"font-variant-numeric":!0,"font-variant-position":!0,"font-weight":!0,grid:!1,"grid-area":!1,"grid-auto-columns":!1,"grid-auto-flow":!1,"grid-auto-rows":!1,"grid-column":!1,"grid-column-end":!1,"grid-column-start":!1,"grid-row":!1,"grid-row-end":!1,"grid-row-start":!1,"grid-template":!1,"grid-template-areas":!1,"grid-template-columns":!1,"grid-template-rows":!1,"hanging-punctuation":!1,height:!0,hyphens:!1,icon:!1,"image-orientation":!1,"image-resolution":!1,"ime-mode":!1,"initial-letters":!1,"inline-box-align":!1,"justify-content":!1,"justify-items":!1,"justify-self":!1,left:!1,"letter-spacing":!0,"lighting-color":!0,"line-box-contain":!1,"line-break":!1,"line-grid":!1,"line-height":!1,"line-snap":!1,"line-stacking":!1,"line-stacking-ruby":!1,"line-stacking-shift":!1,"line-stacking-strategy":!1,"list-style":!0,"list-style-image":!0,"list-style-position":!0,"list-style-type":!0,margin:!0,"margin-bottom":!0,"margin-left":!0,"margin-right":!0,"margin-top":!0,"marker-offset":!1,"marker-side":!1,marks:!1,mask:!1,"mask-box":!1,"mask-box-outset":!1,"mask-box-repeat":!1,"mask-box-slice":!1,"mask-box-source":!1,"mask-box-width":!1,"mask-clip":!1,"mask-image":!1,"mask-origin":!1,"mask-position":!1,"mask-repeat":!1,"mask-size":!1,"mask-source-type":!1,"mask-type":!1,"max-height":!0,"max-lines":!1,"max-width":!0,"min-height":!0,"min-width":!0,"move-to":!1,"nav-down":!1,"nav-index":!1,"nav-left":!1,"nav-right":!1,"nav-up":!1,"object-fit":!1,"object-position":!1,opacity:!1,order:!1,orphans:!1,outline:!1,"outline-color":!1,"outline-offset":!1,"outline-style":!1,"outline-width":!1,overflow:!1,"overflow-wrap":!1,"overflow-x":!1,"overflow-y":!1,padding:!0,"padding-bottom":!0,"padding-left":!0,"padding-right":!0,"padding-top":!0,page:!1,"page-break-after":!1,"page-break-before":!1,"page-break-inside":!1,"page-policy":!1,pause:!1,"pause-after":!1,"pause-before":!1,perspective:!1,"perspective-origin":!1,pitch:!1,"pitch-range":!1,"play-during":!1,position:!1,"presentation-level":!1,quotes:!1,"region-fragment":!1,resize:!1,rest:!1,"rest-after":!1,"rest-before":!1,richness:!1,right:!1,rotation:!1,"rotation-point":!1,"ruby-align":!1,"ruby-merge":!1,"ruby-position":!1,"shape-image-threshold":!1,"shape-outside":!1,"shape-margin":!1,size:!1,speak:!1,"speak-as":!1,"speak-header":!1,"speak-numeral":!1,"speak-punctuation":!1,"speech-rate":!1,stress:!1,"string-set":!1,"tab-size":!1,"table-layout":!1,"text-align":!0,"text-align-last":!0,"text-combine-upright":!0,"text-decoration":!0,"text-decoration-color":!0,"text-decoration-line":!0,"text-decoration-skip":!0,"text-decoration-style":!0,"text-emphasis":!0,"text-emphasis-color":!0,"text-emphasis-position":!0,"text-emphasis-style":!0,"text-height":!0,"text-indent":!0,"text-justify":!0,"text-orientation":!0,"text-overflow":!0,"text-shadow":!0,"text-space-collapse":!0,"text-transform":!0,"text-underline-position":!0,"text-wrap":!0,top:!1,transform:!1,"transform-origin":!1,"transform-style":!1,transition:!1,"transition-delay":!1,"transition-duration":!1,"transition-property":!1,"transition-timing-function":!1,"unicode-bidi":!1,"vertical-align":!1,visibility:!1,"voice-balance":!1,"voice-duration":!1,"voice-family":!1,"voice-pitch":!1,"voice-range":!1,"voice-rate":!1,"voice-stress":!1,"voice-volume":!1,volume:!1,"white-space":!1,widows:!1,width:!0,"will-change":!1,"word-break":!0,"word-spacing":!0,"word-wrap":!0,"wrap-flow":!1,"wrap-through":!1,"writing-mode":!1,"z-index":!1};return e}i.whiteList=n(),i.getDefaultWhiteList=n,i.onAttr=function(e,t,i){},i.onIgnoreAttr=function(e,t,i){}},{}],10:[function(e,t,i){var n=e("./default"),r=e("./css");for(var o in(i=t.exports=function(e,t){return new r(t).process(e)}).FilterCSS=r,n)i[o]=n[o];"undefined"!=typeof window&&(window.filterCSS=t.exports)},{"./css":8,"./default":9}],11:[function(e,t,i){var u=e("./util");t.exports=function(o,s){";"!==(o=u.trimRight(o))[o.length-1]&&(o+=";");var e=o.length,a=!1,l=0,d=0,c="";function t(){if(!a){var e=u.trim(o.slice(l,d)),t=e.indexOf(":");if(-1!==t){var i=u.trim(e.slice(0,t)),n=u.trim(e.slice(t+1));if(i){var r=s(l,c.length,i,n,e);r&&(c+=r+"; ")}}}l=d+1}for(;d<e;d++){var i=o[d];if("/"===i&&"*"===o[d+1]){var n=o.indexOf("*/",d+2);if(-1===n)break;l=(d=n+1)+1,a=!1}else"("===i?a=!0:")"===i?a=!1:";"===i?a||t():"\n"===i&&t()}return u.trim(c)}},{"./util":12}],12:[function(e,t,i){t.exports={indexOf:function(e,t){var i,n;if(Array.prototype.indexOf)return e.indexOf(t);for(i=0,n=e.length;i<n;i++)if(e[i]===t)return i;return-1},forEach:function(e,t,i){var n,r;if(Array.prototype.forEach)return e.forEach(t,i);for(n=0,r=e.length;n<r;n++)t.call(i,e[n],n,e)},trim:function(e){return String.prototype.trim?e.trim():e.replace(/(^\s*)|(\s*$)/g,"")},trimRight:function(e){return String.prototype.trimRight?e.trimRight():e.replace(/(\s*$)/g,"")}}},{}],13:[function(e,t,i){var n,r;n=this,r=function(){var e={},i="undefined"!=typeof window&&window,t="undefined"!=typeof document&&document,n=t&&t.documentElement,r=i.matchMedia||i.msMatchMedia,o=r?function(e){return!!r.call(i,e).matches}:function(){return!1},s=e.viewportW=function(){var e=n.clientWidth,t=i.innerWidth;return e<t?t:e},a=e.viewportH=function(){var e=n.clientHeight,t=i.innerHeight;return e<t?t:e};function l(){return{width:s(),height:a()}}function d(e,t){return!(!(e=e&&!e.nodeType?e[0]:e)||1!==e.nodeType)&&function(e,t){var i={};return t=+t||0,i.width=(i.right=e.right+t)-(i.left=e.left-t),i.height=(i.bottom=e.bottom+t)-(i.top=e.top-t),i}(e.getBoundingClientRect(),t)}return e.mq=o,e.matchMedia=r?function(){return r.apply(i,arguments)}:function(){return{}},e.viewport=l,e.scrollX=function(){return i.pageXOffset||n.scrollLeft},e.scrollY=function(){return i.pageYOffset||n.scrollTop},e.rectangle=d,e.aspect=function(e){var t=(e=null==e?l():1===e.nodeType?d(e):e).height,i=e.width;return t="function"==typeof t?t.call(e):t,(i="function"==typeof i?i.call(e):i)/t},e.inX=function(e,t){var i=d(e,t);return!!i&&0<=i.right&&i.left<=s()},e.inY=function(e,t){var i=d(e,t);return!!i&&0<=i.bottom&&i.top<=a()},e.inViewport=function(e,t){var i=d(e,t);return!!i&&0<=i.bottom&&0<=i.right&&i.top<=a()&&i.left<=s()},e},void 0!==t&&t.exports?t.exports=r():n.verge=r()},{}],14:[function(e,t,i){(i={THEME_RTD:"sphinx_rtd_theme",THEME_ALABASTER:"alabaster",THEME_MKDOCS_RTD:"readthedocs",THEME_CELERY:"sphinx_celery",THEME_BABEL:"babel",THEME_CLICK:"click",THEME_FLASK_SQLALCHEMY:"flask-sqlalchemy",THEME_FLASK:"flask",THEME_JINJA:"jinja",THEME_PLATTER:"platter",THEME_POCOO:"pocoo",THEME_WERKZEUG:"werkzeug",DEFAULT_PROMO_PRIORITY:5,MINIMUM_PROMO_PRIORITY:10,MAXIMUM_PROMO_PRIORITY:1,LOW_PROMO_PRIORITY:10}).ALABASTER_LIKE_THEMES=[i.THEME_ALABASTER,i.THEME_CELERY,i.THEME_BABEL,i.THEME_CLICK,i.THEME_FLASK_SQLALCHEMY,i.THEME_FLASK,i.THEME_JINJA,i.THEME_PLATTER,i.THEME_POCOO,i.THEME_WERKZEUG],i.PROMO_TYPES={LEFTNAV:"doc",FOOTER:"site-footer",FIXED_FOOTER:"fixed-footer"},t.exports=i},{}],15:[function(e,t,i){var n=e("./rtd-data"),r=e("./version-compare");function o(){$.ajaxSetup({beforeSend:function(e,t){!function(e){return/^(GET|HEAD|OPTIONS|TRACE)$/.test(e)}(t.type)&&e.setRequestHeader("X-CSRFToken",$("a.bookmark[token]").attr("token"))}})}t.exports={init:function(){var e=n.get(),t={project:e.project,version:e.version,page:e.page,theme:e.get_theme_name(),format:"jsonp"};"docroot"in e&&(t.docroot=e.docroot),"source_suffix"in e&&(t.source_suffix=e.source_suffix),0===window.location.pathname.indexOf("/projects/")&&(t.subproject=!0),$.ajax({url:e.proxied_api_host+"/api/v2/footer_html/",crossDomain:!0,xhrFields:{withCredentials:!0},dataType:"jsonp",data:t,success:function(e){e.show_version_warning&&r.init(e.version_compare),function(e){var t=n.get();t.is_sphinx_builder()&&t.is_rtd_like_theme()?$("div.rst-other-versions").html(e.html):$("body").append(e.html),e.version_active?e.version_supported:$(".rst-current-version").addClass("rst-out-of-date")}(e),o()},error:function(){console.error("Error loading Read the Docs footer")}})}}},{"./rtd-data":16,"./version-compare":20}],16:[function(e,t,i){var n=e("./constants"),r={is_rtd_like_theme:function(){return 1===$("div.rst-other-versions").length||(this.theme===n.THEME_RTD||this.theme===n.THEME_MKDOCS_RTD)},is_alabaster_like_theme:function(){return-1<n.ALABASTER_LIKE_THEMES.indexOf(this.get_theme_name())},is_sphinx_builder:function(){return!("builder"in this)||"mkdocs"!==this.builder},is_mkdocs_builder:function(){return"builder"in this&&"mkdocs"===this.builder},get_theme_name:function(){return this.theme},show_promo:function(){return"https://readthedocs.org"===this.api_host||"http://community.dev.readthedocs.io"===this.api_host||"http://127.0.0.1:8000"===this.api_host}};t.exports={get:function(){var e=Object.create(r);return $.extend(e,{api_host:"https://readthedocs.org",ad_free:!1},window.READTHEDOCS_DATA),e.proxied_api_host="/_",e}}},{"./constants":14}],17:[function(e,t,i){var n=e("./rtd-data"),R=e("./../../../../../../bower_components/xss/lib/index"),C=3,I=100;function M(t,i,n){try{t.append($u.template(i,n))}catch(e){t.append($u.template(i)(n))}}t.exports={init:function(){!function(t){var S=t.project,i=t.version,r=t.language||"en";if("undefined"!=typeof Search&&S&&i&&(!t.features||!t.features.docsearch_disabled)){var e=Search.query;Search.query_fallback=e,Search.query=function(A){var n=$.Deferred(),e=document.createElement("a");e.href=t.proxied_api_host+"/api/v2/docsearch/",e.search="?q="+$.urlencode(A)+"&project="+S+"&version="+i+"&language="+r,n.then(function(e){var t=e.results||[];e.count;if(t.length)for(var i=0;i<t.length;i+=1){var n=t[i],r=n.highlight,o=n.inner_hits||[],s=$('<li style="display: none;"></li>'),a=n.title;r&&r.title&&(a=R(r.title[0]));var l=DOCUMENTATION_OPTIONS.FILE_SUFFIX;"BUILDER"in DOCUMENTATION_OPTIONS&&"readthedocsdirhtml"===DOCUMENTATION_OPTIONS.BUILDER&&(l="");var d=n.link+l+"?highlight="+$.urlencode(A),c=$("<a>",{href:d});if(c.html(a),c.find("span").addClass("highlighted"),s.append(c),n.project!==S){var u=" (from project "+n.project+")",h=$("<span>",{text:u});s.append(h)}for(var p=0;p<o.length;p+=1){var f=$('<div class="context">'),g="",m="",v="",w="",b="",y="",x="",k="",T="",E="";if("sections"===o[p].type){if(m=(g=o[p])._source.title,v=d+"#"+g._source.id,w=[g._source.content.substr(0,I)+" ..."],g.highlight&&(g.highlight["sections.title"]&&(m=R(g.highlight["sections.title"][0])),g.highlight["sections.content"])){b=g.highlight["sections.content"],w=[];for(var O=0;O<b.length&&O<C;O+=1)w.push("... "+R(b[O])+" ...")}M(f,'<div><a href="<%= section_subtitle_link %>"><%= section_subtitle %></a></div><% for (var i = 0; i < section_content.length; ++i) { %><div><%= section_content[i] %></div><% } %>',{section_subtitle_link:v,section_subtitle:m,section_content:w})}"domains"===o[p].type&&(x=(y=o[p])._source.role_name,k=d+"#"+y._source.anchor,T=y._source.name,(E="")!==y._source.docstrings&&(E=y._source.docstrings.substr(0,I)+" ..."),y.highlight&&(y.highlight["domains.docstrings"]&&(E="... "+R(y.highlight["domains.docstrings"][0])+" ..."),y.highlight["domains.name"]&&(T=R(y.highlight["domains.name"][0]))),M(f,'<div><a href="<%= domain_subtitle_link %>"><%= domain_subtitle %></a></div><div><%= domain_content %></div>',{domain_subtitle_link:k,domain_subtitle:"["+x+"]: "+T,domain_content:E})),f.find("span").addClass("highlighted"),s.append(f),p!==o.length-1&&s.append($("<div class='rtd_search_hits_spacing'></div>"))}Search.output.append(s),s.slideDown(5)}t.length?Search.status.text(_("Search finished, found %s page(s) matching the search query.").replace("%s",t.length)):(Search.query_fallback(A),console.log("Read the Docs search failed. Falling back to Sphinx search."))}).fail(function(e){Search.query_fallback(A)}).always(function(){$("#search-progress").empty(),Search.stopPulse(),Search.title.text(_("Search Results")),Search.status.fadeIn(500)}),$.ajax({url:e.href,crossDomain:!0,xhrFields:{withCredentials:!0},complete:function(e,t){return"success"!==t||void 0===e.responseJSON||0===e.responseJSON.count?n.reject():n.resolve(e.responseJSON)}}).fail(function(e,t,i){return n.reject()})}}$(document).ready(function(){"undefined"!=typeof Search&&Search.init()})}(n.get())}}},{"./../../../../../../bower_components/xss/lib/index":3,"./rtd-data":16}],18:[function(r,e,t){var o=r("./rtd-data");e.exports={init:function(){var e=o.get();if($(document).on("click","[data-toggle='rst-current-version']",function(){var e=$("[data-toggle='rst-versions']").hasClass("shift-up")?"was_open":"was_closed";"undefined"!=typeof ga?ga("rtfd.send","event","Flyout","Click",e):"undefined"!=typeof _gaq&&_gaq.push(["rtfd._setAccount","UA-17997319-1"],["rtfd._trackEvent","Flyout","Click",e])}),void 0===window.SphinxRtdTheme){var t=r("./../../../../../../bower_components/sphinx-rtd-theme/js/theme.js").ThemeNav;if($(document).ready(function(){setTimeout(function(){t.navBar||t.enable()},1e3)}),e.is_rtd_like_theme())if(!$("div.wy-side-scroll:first").length){console.log("Applying theme sidebar fix...");var i=$("nav.wy-nav-side:first"),n=$("<div />").addClass("wy-side-scroll");i.children().detach().appendTo(n),n.prependTo(i),t.navBar=n}}}}},{"./../../../../../../bower_components/sphinx-rtd-theme/js/theme.js":1,"./rtd-data":16}],19:[function(e,t,i){var l,d=e("./constants"),c=e("./rtd-data"),n=e("bowser"),u="#ethical-ad-placement";function h(){var e,t,i="rtd-"+(Math.random()+1).toString(36).substring(4),n=d.PROMO_TYPES.LEFTNAV,r=d.DEFAULT_PROMO_PRIORITY,o=null;return l.is_mkdocs_builder()&&l.is_rtd_like_theme()?(o="nav.wy-nav-side",e="ethical-rtd ethical-dark-theme"):l.is_rtd_like_theme()?(o="nav.wy-nav-side > div.wy-side-scroll",e="ethical-rtd ethical-dark-theme"):l.is_alabaster_like_theme()&&(o="div.sphinxsidebar > div.sphinxsidebarwrapper",e="ethical-alabaster"),o?($("<div />").attr("id",i).addClass(e).appendTo(o),(!(t=$("#"+i).offset())||t.top>$(window).height())&&(r=d.LOW_PROMO_PRIORITY),{div_id:i,display_type:n,priority:r}):null}function p(){var e,t,i="rtd-"+(Math.random()+1).toString(36).substring(4),n=d.PROMO_TYPES.FOOTER,r=d.DEFAULT_PROMO_PRIORITY,o=null;return l.is_rtd_like_theme()?(o=$("<div />").insertAfter("footer hr"),e="ethical-rtd"):l.is_alabaster_like_theme()&&(o="div.bodywrapper .body",e="ethical-alabaster"),o?($("<div />").attr("id",i).addClass(e).appendTo(o),(!(t=$("#"+i).offset())||t.top<$(window).height())&&(r=d.LOW_PROMO_PRIORITY),{div_id:i,display_type:n,priority:r}):null}function f(){var e="rtd-"+(Math.random()+1).toString(36).substring(4),t=d.PROMO_TYPES.FIXED_FOOTER,i=d.DEFAULT_PROMO_PRIORITY;return n&&n.mobile&&(i=d.MAXIMUM_PROMO_PRIORITY),$("<div />").attr("id",e).appendTo("body"),{div_id:e,display_type:t,priority:i}}function g(e){this.id=e.id,this.div_id=e.div_id||"",this.html=e.html||"",this.display_type=e.display_type||"",this.view_tracking_url=e.view_url,this.click_handler=function(){"undefined"!=typeof ga?ga("rtfd.send","event","Promo","Click",e.id):"undefined"!=typeof _gaq&&_gaq.push(["rtfd._setAccount","UA-17997319-1"],["rtfd._trackEvent","Promo","Click",e.id])}}g.prototype.display=function(){var e="#"+this.div_id,t=this.view_tracking_url;$(e).html(this.html),$(e).find('a[href*="/sustainability/click/"]').on("click",this.click_handler);function i(){$.inViewport($(e),-3)&&($("<img />").attr("src",t).css("display","none").appendTo(e),$(window).off(".rtdinview"),$(".wy-side-scroll").off(".rtdinview"))}$(window).on("DOMContentLoaded.rtdinview load.rtdinview scroll.rtdinview resize.rtdinview",i),$(".wy-side-scroll").on("scroll.rtdinview",i),$(".ethical-close").on("click",function(){return $(e).hide(),!1}),this.post_promo_display()},g.prototype.disable=function(){$("#"+this.div_id).hide()},g.prototype.post_promo_display=function(){this.display_type===d.PROMO_TYPES.FOOTER&&($("<hr />").insertAfter("#"+this.div_id),$("<hr />").insertBefore("#"+this.div_id+".ethical-alabaster .ethical-footer"))},t.exports={Promo:g,init:function(){var e,t,i={format:"jsonp"},n=[],r=[],o=[],s=[p,h,f];if(l=c.get(),t=function(){var e,t="rtd-"+(Math.random()+1).toString(36).substring(4),i=d.PROMO_TYPES.LEFTNAV;return e=l.is_rtd_like_theme()?"ethical-rtd ethical-dark-theme":"ethical-alabaster",0<$(u).length?($("<div />").attr("id",t).addClass(e).appendTo(u),{div_id:t,display_type:i}):null}())n.push(t.div_id),r.push(t.display_type),o.push(t.priority||d.DEFAULT_PROMO_PRIORITY),!0;else{if(!l.show_promo())return;for(var a=0;a<s.length;a+=1)(t=s[a]())&&(n.push(t.div_id),r.push(t.display_type),o.push(t.priority||d.DEFAULT_PROMO_PRIORITY))}i.div_ids=n.join("|"),i.display_types=r.join("|"),i.priorities=o.join("|"),i.project=l.project,i.theme=l.get_theme_name(),"undefined"!=typeof URL&&"undefined"!=typeof URLSearchParams&&((e=new URL(window.location).searchParams).get("force_promo")&&(i.force_promo=e.get("force_promo")),e.get("force_campaign")&&(i.force_campaign=e.get("force_campaign"))),$.ajax({url:l.api_host+"/api/v2/sustainability/",crossDomain:!0,xhrFields:{withCredentials:!0},dataType:"jsonp",data:i,success:function(e){e&&e.div_id&&e.html&&new g(e).display()},error:function(){console.error("Error loading Read the Docs promo"),!l.ad_free&&"https://readthedocs.org"===l.api_host&&function(){var e=!1;return $("<div />").attr("id","rtd-detection").attr("class","ethical-rtd").html("&nbsp;").appendTo("body"),0===$("#rtd-detection").height()&&(e=!0),$("#rtd-detection").remove(),e}()&&(console.log("---------------------------------------------------------------------------------------"),console.log("Read the Docs hosts documentation for tens of thousands of open source projects."),console.log("We fund our development (we are open source) and operations through advertising."),console.log("We promise to:"),console.log(" - never let advertisers run 3rd party JavaScript"),console.log(" - never sell user data to advertisers or other 3rd parties"),console.log(" - only show advertisements of interest to developers"),console.log("Read more about our approach to advertising here: https://docs.readthedocs.io/en/latest/advertising/ethical-advertising.html"),console.log("%cPlease allow our Ethical Ads or go ad-free:","font-size: 2em"),console.log("https://docs.readthedocs.io/en/latest/advertising/ad-blocking.html"),console.log("--------------------------------------------------------------------------------------"),function(){var e=h(),t=null;e&&e.div_id&&(t=$("#"+e.div_id).attr("class","keep-us-sustainable"),$("<p />").text("Support Read the Docs!").appendTo(t),$("<p />").html('Please help keep us sustainable by <a href="https://docs.readthedocs.io/en/latest/advertising/ad-blocking.html#allowing-ethical-ads">allowing our Ethical Ads in your ad blocker</a> or <a href="https://readthedocs.org/sustainability/">go ad-free</a> by subscribing.').appendTo(t),$("<p />").text("Thank you! ❤️").appendTo(t))}())}})}}},{"./constants":14,"./rtd-data":16,bowser:7}],20:[function(e,t,i){var o=e("./rtd-data");t.exports={init:function(e){var t=o.get();if(!e.is_highest){var i=window.location.pathname.replace(t.version,e.slug),n=$('<div class="admonition warning"> <p class="first admonition-title">Note</p> <p class="last"> You are not reading the most recent version of this documentation. <a href="#"></a> is the latest version available.</p></div>');n.find("a").attr("href",i).text(e.slug);var r=$("div.body");r.length||(r=$("div.document")),r.prepend(n)}}}},{"./rtd-data":16}],21:[function(e,t,i){var n=e("./doc-embed/sponsorship"),r=e("./doc-embed/footer.js"),o=(e("./doc-embed/rtd-data"),e("./doc-embed/sphinx")),s=e("./doc-embed/search");$.extend(e("verge")),$(document).ready(function(){r.init(),o.init(),s.init(),n.init()})},{"./doc-embed/footer.js":15,"./doc-embed/rtd-data":16,"./doc-embed/search":17,"./doc-embed/sphinx":18,"./doc-embed/sponsorship":19,verge:13}]},{},[21]);
\ No newline at end of file
+!function o(s,a,l){function d(t,e){if(!a[t]){if(!s[t]){var i="function"==typeof require&&require;if(!e&&i)return i(t,!0);if(c)return c(t,!0);var n=new Error("Cannot find module '"+t+"'");throw n.code="MODULE_NOT_FOUND",n}var r=a[t]={exports:{}};s[t][0].call(r.exports,function(e){return d(s[t][1][e]||e)},r,r.exports,o,s,a,l)}return a[t].exports}for(var c="function"==typeof require&&require,e=0;e<l.length;e++)d(l[e]);return d}({1:[function(e,t,i){var n="undefined"!=typeof window?window.jQuery:e("jquery");t.exports.ThemeNav={navBar:null,win:null,winScroll:!1,winResize:!1,linkScroll:!1,winPosition:0,winHeight:null,docHeight:null,isRunning:!1,enable:function(t){var i=this;"undefined"==typeof withStickNav&&(t=!0),i.isRunning||(i.isRunning=!0,n(function(e){i.init(e),i.reset(),i.win.on("hashchange",i.reset),t&&i.win.on("scroll",function(){i.linkScroll||i.winScroll||(i.winScroll=!0,requestAnimationFrame(function(){i.onScroll()}))}),i.win.on("resize",function(){i.winResize||(i.winResize=!0,requestAnimationFrame(function(){i.onResize()}))}),i.onResize()}))},enableSticky:function(){this.enable(!0)},init:function(i){i(document);var n=this;this.navBar=i("div.wy-side-scroll:first"),this.win=i(window),i(document).on("click","[data-toggle='wy-nav-top']",function(){i("[data-toggle='wy-nav-shift']").toggleClass("shift"),i("[data-toggle='rst-versions']").toggleClass("shift")}).on("click",".wy-menu-vertical .current ul li a",function(){var e=i(this);i("[data-toggle='wy-nav-shift']").removeClass("shift"),i("[data-toggle='rst-versions']").toggleClass("shift"),n.toggleCurrent(e),n.hashChange()}).on("click","[data-toggle='rst-current-version']",function(){i("[data-toggle='rst-versions']").toggleClass("shift-up")}),i("table.docutils:not(.field-list,.footnote,.citation)").wrap("<div class='wy-table-responsive'></div>"),i("table.docutils.footnote").wrap("<div class='wy-table-responsive footnote'></div>"),i("table.docutils.citation").wrap("<div class='wy-table-responsive citation'></div>"),i(".wy-menu-vertical ul").not(".simple").siblings("a").each(function(){var t=i(this);expand=i('<span class="toctree-expand"></span>'),expand.on("click",function(e){return n.toggleCurrent(t),e.stopPropagation(),!1}),t.prepend(expand)})},reset:function(){var e=encodeURI(window.location.hash)||"#";try{var t=$(".wy-menu-vertical"),i=t.find('[href="'+e+'"]');if(0===i.length){var n=$('.document [id="'+e.substring(1)+'"]').closest("div.section");0===(i=t.find('[href="#'+n.attr("id")+'"]')).length&&(i=t.find('[href="#"]'))}0<i.length&&($(".wy-menu-vertical .current").removeClass("current"),i.addClass("current"),i.closest("li.toctree-l1").addClass("current"),i.closest("li.toctree-l1").parent().addClass("current"),i.closest("li.toctree-l1").addClass("current"),i.closest("li.toctree-l2").addClass("current"),i.closest("li.toctree-l3").addClass("current"),i.closest("li.toctree-l4").addClass("current"))}catch(e){console.log("Error expanding nav for anchor",e)}},onScroll:function(){this.winScroll=!1;var e=this.win.scrollTop(),t=e+this.winHeight,i=this.navBar.scrollTop()+(e-this.winPosition);e<0||t>this.docHeight||(this.navBar.scrollTop(i),this.winPosition=e)},onResize:function(){this.winResize=!1,this.winHeight=this.win.height(),this.docHeight=$(document).height()},hashChange:function(){this.linkScroll=!0,this.win.one("hashchange",function(){this.linkScroll=!1})},toggleCurrent:function(e){var t=e.closest("li");t.siblings("li.current").removeClass("current"),t.siblings().find("li.current").removeClass("current"),t.find("> ul li.current").removeClass("current"),t.toggleClass("current")}},"undefined"!=typeof window&&(window.SphinxRtdTheme={Navigation:t.exports.ThemeNav,StickyNav:t.exports.ThemeNav}),function(){for(var o=0,e=["ms","moz","webkit","o"],t=0;t<e.length&&!window.requestAnimationFrame;++t)window.requestAnimationFrame=window[e[t]+"RequestAnimationFrame"],window.cancelAnimationFrame=window[e[t]+"CancelAnimationFrame"]||window[e[t]+"CancelRequestAnimationFrame"];window.requestAnimationFrame||(window.requestAnimationFrame=function(e,t){var i=(new Date).getTime(),n=Math.max(0,16-(i-o)),r=window.setTimeout(function(){e(i+n)},n);return o=i+n,r}),window.cancelAnimationFrame||(window.cancelAnimationFrame=function(e){clearTimeout(e)})}()},{jquery:"jquery"}],2:[function(e,t,i){var n=e("cssfilter").FilterCSS,r=e("cssfilter").getDefaultWhiteList,c=e("./util");function o(){return{a:["target","href","title"],abbr:["title"],address:[],area:["shape","coords","href","alt"],article:[],aside:[],audio:["autoplay","controls","loop","preload","src"],b:[],bdi:["dir"],bdo:["dir"],big:[],blockquote:["cite"],br:[],caption:[],center:[],cite:[],code:[],col:["align","valign","span","width"],colgroup:["align","valign","span","width"],dd:[],del:["datetime"],details:["open"],div:[],dl:[],dt:[],em:[],font:["color","size","face"],footer:[],h1:[],h2:[],h3:[],h4:[],h5:[],h6:[],header:[],hr:[],i:[],img:["src","alt","title","width","height"],ins:["datetime"],li:[],mark:[],nav:[],ol:[],p:[],pre:[],s:[],section:[],small:[],span:[],sub:[],sup:[],strong:[],table:["width","border","align","valign"],tbody:["align","valign"],td:["width","rowspan","colspan","align","valign"],tfoot:["align","valign"],th:["width","rowspan","colspan","align","valign"],thead:["align","valign"],tr:["rowspan","align","valign"],tt:[],u:[],ul:[],video:["autoplay","controls","loop","preload","src","height","width"]}}var s=new n;function a(e){return e.replace(l,"&lt;").replace(d,"&gt;")}var l=/</g,d=/>/g,u=/"/g,h=/&quot;/g,p=/&#([a-zA-Z0-9]*);?/gim,f=/&colon;?/gim,g=/&newline;?/gim,m=/((j\s*a\s*v\s*a|v\s*b|l\s*i\s*v\s*e)\s*s\s*c\s*r\s*i\s*p\s*t\s*|m\s*o\s*c\s*h\s*a)\:/gi,v=/e\s*x\s*p\s*r\s*e\s*s\s*s\s*i\s*o\s*n\s*\(.*/gi,w=/u\s*r\s*l\s*\(.*/gi;function b(e){return e.replace(u,"&quot;")}function _(e){return e.replace(h,'"')}function y(e){return e.replace(p,function(e,t){return"x"===t[0]||"X"===t[0]?String.fromCharCode(parseInt(t.substr(1),16)):String.fromCharCode(parseInt(t,10))})}function x(e){return e.replace(f,":").replace(g," ")}function k(e){for(var t="",i=0,n=e.length;i<n;i++)t+=e.charCodeAt(i)<32?" ":e.charAt(i);return c.trim(t)}function T(e){return e=k(e=x(e=y(e=_(e))))}function E(e){return e=a(e=b(e))}var A=/<!--[\s\S]*?-->/g;i.whiteList={a:["target","href","title"],abbr:["title"],address:[],area:["shape","coords","href","alt"],article:[],aside:[],audio:["autoplay","controls","loop","preload","src"],b:[],bdi:["dir"],bdo:["dir"],big:[],blockquote:["cite"],br:[],caption:[],center:[],cite:[],code:[],col:["align","valign","span","width"],colgroup:["align","valign","span","width"],dd:[],del:["datetime"],details:["open"],div:[],dl:[],dt:[],em:[],font:["color","size","face"],footer:[],h1:[],h2:[],h3:[],h4:[],h5:[],h6:[],header:[],hr:[],i:[],img:["src","alt","title","width","height"],ins:["datetime"],li:[],mark:[],nav:[],ol:[],p:[],pre:[],s:[],section:[],small:[],span:[],sub:[],sup:[],strong:[],table:["width","border","align","valign"],tbody:["align","valign"],td:["width","rowspan","colspan","align","valign"],tfoot:["align","valign"],th:["width","rowspan","colspan","align","valign"],thead:["align","valign"],tr:["rowspan","align","valign"],tt:[],u:[],ul:[],video:["autoplay","controls","loop","preload","src","height","width"]},i.getDefaultWhiteList=o,i.onTag=function(e,t,i){},i.onIgnoreTag=function(e,t,i){},i.onTagAttr=function(e,t,i){},i.onIgnoreTagAttr=function(e,t,i){},i.safeAttrValue=function(e,t,i,n){if(i=T(i),"href"===t||"src"===t){if("#"===(i=c.trim(i)))return"#";if("http://"!==i.substr(0,7)&&"https://"!==i.substr(0,8)&&"mailto:"!==i.substr(0,7)&&"tel:"!==i.substr(0,4)&&"#"!==i[0]&&"/"!==i[0])return""}else if("background"===t){if(m.lastIndex=0,m.test(i))return""}else if("style"===t){if(v.lastIndex=0,v.test(i))return"";if(w.lastIndex=0,w.test(i)&&(m.lastIndex=0,m.test(i)))return"";!1!==n&&(i=(n=n||s).process(i))}return i=E(i)},i.escapeHtml=a,i.escapeQuote=b,i.unescapeQuote=_,i.escapeHtmlEntities=y,i.escapeDangerHtml5Entities=x,i.clearNonPrintableCharacter=k,i.friendlyAttrValue=T,i.escapeAttrValue=E,i.onIgnoreTagStripAll=function(){return""},i.StripTagBody=function(o,s){"function"!=typeof s&&(s=function(){});var a=!Array.isArray(o),l=[],d=!1;return{onIgnoreTag:function(e,t,i){if(function(e){return a||-1!==c.indexOf(o,e)}(e)){if(i.isClosing){var n="[/removed]",r=i.position+n.length;return l.push([!1!==d?d:i.position,r]),d=!1,n}return d=d||i.position,"[removed]"}return s(e,t,i)},remove:function(t){var i="",n=0;return c.forEach(l,function(e){i+=t.slice(n,e[0]),n=e[1]}),i+=t.slice(n)}}},i.stripCommentTag=function(e){return e.replace(A,"")},i.stripBlankChar=function(e){var t=e.split("");return(t=t.filter(function(e){var t=e.charCodeAt(0);return 127!==t&&(!(t<=31)||(10===t||13===t))})).join("")},i.cssFilter=s,i.getDefaultCSSWhiteList=r},{"./util":5,cssfilter:10}],3:[function(e,t,i){var n=e("./default"),r=e("./parser"),o=e("./xss");for(var s in(i=t.exports=function(e,t){return new o(t).process(e)}).FilterXSS=o,n)i[s]=n[s];for(var s in r)i[s]=r[s];"undefined"!=typeof window&&(window.filterXSS=t.exports)},{"./default":2,"./parser":4,"./xss":6}],4:[function(e,t,i){var c=e("./util");function h(e){var t=c.spaceIndex(e);if(-1===t)var i=e.slice(1,-1);else i=e.slice(1,t+1);return"/"===(i=c.trim(i).toLowerCase()).slice(0,1)&&(i=i.slice(1)),"/"===i.slice(-1)&&(i=i.slice(0,-1)),i}var u=/[^a-zA-Z0-9_:\.\-]/gim;function p(e,t){for(;t<e.length;t++){var i=e[t];if(" "!==i)return"="===i?t:-1}}function f(e,t){for(;0<t;t--){var i=e[t];if(" "!==i)return"="===i?t:-1}}function g(e){return function(e){return'"'===e[0]&&'"'===e[e.length-1]||"'"===e[0]&&"'"===e[e.length-1]}(e)?e.substr(1,e.length-2):e}i.parseTag=function(e,t,i){var n="",r=0,o=!1,s=!1,a=0,l=e.length,d="",c="";for(a=0;a<l;a++){var u=e.charAt(a);if(!1===o){if("<"===u){o=a;continue}}else if(!1===s){if("<"===u){n+=i(e.slice(r,a)),r=o=a;continue}if(">"===u){n+=i(e.slice(r,o)),c=h(d=e.slice(o,a+1)),n+=t(o,n.length,c,d,"</"===d.slice(0,2)),r=a+1,o=!1;continue}if(('"'===u||"'"===u)&&"="===e.charAt(a-1)){s=u;continue}}else if(u===s){s=!1;continue}}return r<e.length&&(n+=i(e.substr(r))),n},i.parseAttr=function(e,n){var t=0,r=[],i=!1,o=e.length;function s(e,t){if(!((e=(e=c.trim(e)).replace(u,"").toLowerCase()).length<1)){var i=n(e,t||"");i&&r.push(i)}}for(var a=0;a<o;a++){var l,d=e.charAt(a);if(!1!==i||"="!==d)if(!1===i||a!==t||'"'!==d&&"'"!==d||"="!==e.charAt(a-1))if(/\s|\n|\t/.test(d)){if(e=e.replace(/\s|\n|\t/g," "),!1===i){if(-1===(l=p(e,a))){s(c.trim(e.slice(t,a))),i=!1,t=a+1;continue}a=l-1;continue}if(-1!==(l=f(e,a-1)))continue;s(i,g(c.trim(e.slice(t,a)))),i=!1,t=a+1}else;else{if(-1===(l=e.indexOf(d,a+1)))break;s(i,c.trim(e.slice(t+1,l))),i=!1,t=(a=l)+1}else i=e.slice(t,a),t=a+1}return t<e.length&&(!1===i?s(e.slice(t)):s(i,g(c.trim(e.slice(t))))),c.trim(r.join(" "))}},{"./util":5}],5:[function(e,t,i){t.exports={indexOf:function(e,t){var i,n;if(Array.prototype.indexOf)return e.indexOf(t);for(i=0,n=e.length;i<n;i++)if(e[i]===t)return i;return-1},forEach:function(e,t,i){var n,r;if(Array.prototype.forEach)return e.forEach(t,i);for(n=0,r=e.length;n<r;n++)t.call(i,e[n],n,e)},trim:function(e){return String.prototype.trim?e.trim():e.replace(/(^\s*)|(\s*$)/g,"")},spaceIndex:function(e){var t=/\s|\n|\t/.exec(e);return t?t.index:-1}}},{}],6:[function(e,t,i){var n=e("cssfilter").FilterCSS,r=e("./default"),o=e("./parser"),s=o.parseTag,w=o.parseAttr,b=e("./util");function _(e){return null==e}function a(e){(e=function(e){var t={};for(var i in e)t[i]=e[i];return t}(e||{})).stripIgnoreTag&&(e.onIgnoreTag&&console.error('Notes: cannot use these two options "stripIgnoreTag" and "onIgnoreTag" at the same time'),e.onIgnoreTag=r.onIgnoreTagStripAll),e.whiteList=e.whiteList||r.whiteList,e.onTag=e.onTag||r.onTag,e.onTagAttr=e.onTagAttr||r.onTagAttr,e.onIgnoreTag=e.onIgnoreTag||r.onIgnoreTag,e.onIgnoreTagAttr=e.onIgnoreTagAttr||r.onIgnoreTagAttr,e.safeAttrValue=e.safeAttrValue||r.safeAttrValue,e.escapeHtml=e.escapeHtml||r.escapeHtml,!1===(this.options=e).css?this.cssFilter=!1:(e.css=e.css||{},this.cssFilter=new n(e.css))}a.prototype.process=function(e){if(!(e=(e=e||"").toString()))return"";var t=this.options,c=t.whiteList,u=t.onTag,h=t.onIgnoreTag,p=t.onTagAttr,f=t.onIgnoreTagAttr,g=t.safeAttrValue,m=t.escapeHtml,v=this.cssFilter;t.stripBlankChar&&(e=r.stripBlankChar(e)),t.allowCommentTag||(e=r.stripCommentTag(e));var i=!1;if(t.stripIgnoreTagBody){i=r.StripTagBody(t.stripIgnoreTagBody,h);h=i.onIgnoreTag}var n=s(e,function(e,t,r,i,n){var o,s={sourcePosition:e,position:t,isClosing:n,isWhite:r in c};if(!_(o=u(r,i,s)))return o;if(s.isWhite){if(s.isClosing)return"</"+r+">";var a=function(e){var t=b.spaceIndex(e);if(-1===t)return{html:"",closing:"/"===e[e.length-2]};var i="/"===(e=b.trim(e.slice(t+1,-1)))[e.length-1];return i&&(e=b.trim(e.slice(0,-1))),{html:e,closing:i}}(i),l=c[r],d=w(a.html,function(e,t){var i,n=-1!==b.indexOf(l,e);return _(i=p(r,e,t,n))?n?(t=g(r,e,t,v))?e+'="'+t+'"':e:_(i=f(r,e,t,n))?void 0:i:i});i="<"+r;return d&&(i+=" "+d),a.closing&&(i+=" /"),i+=">"}return _(o=h(r,i,s))?m(i):o},m);return i&&(n=i.remove(n)),n},t.exports=a},{"./default":2,"./parser":4,"./util":5,cssfilter:10}],7:[function(e,t,i){var n,r;n=this,r=function(){var T=!0;function s(i){function e(e){var t=i.match(e);return t&&1<t.length&&t[1]||""}function t(e){var t=i.match(e);return t&&1<t.length&&t[2]||""}var n,r=e(/(ipod|iphone|ipad)/i).toLowerCase(),o=!/like android/i.test(i)&&/android/i.test(i),s=/nexus\s*[0-6]\s*/i.test(i),a=!s&&/nexus\s*[0-9]+/i.test(i),l=/CrOS/.test(i),d=/silk/i.test(i),c=/sailfish/i.test(i),u=/tizen/i.test(i),h=/(web|hpw)(o|0)s/i.test(i),p=/windows phone/i.test(i),f=(/SamsungBrowser/i.test(i),!p&&/windows/i.test(i)),g=!r&&!d&&/macintosh/i.test(i),m=!o&&!c&&!u&&!h&&/linux/i.test(i),v=t(/edg([ea]|ios)\/(\d+(\.\d+)?)/i),w=e(/version\/(\d+(\.\d+)?)/i),b=/tablet/i.test(i)&&!/tablet pc/i.test(i),_=!b&&/[^-]mobi/i.test(i),y=/xbox/i.test(i);/opera/i.test(i)?n={name:"Opera",opera:T,version:w||e(/(?:opera|opr|opios)[\s\/](\d+(\.\d+)?)/i)}:/opr\/|opios/i.test(i)?n={name:"Opera",opera:T,version:e(/(?:opr|opios)[\s\/](\d+(\.\d+)?)/i)||w}:/SamsungBrowser/i.test(i)?n={name:"Samsung Internet for Android",samsungBrowser:T,version:w||e(/(?:SamsungBrowser)[\s\/](\d+(\.\d+)?)/i)}:/Whale/i.test(i)?n={name:"NAVER Whale browser",whale:T,version:e(/(?:whale)[\s\/](\d+(?:\.\d+)+)/i)}:/MZBrowser/i.test(i)?n={name:"MZ Browser",mzbrowser:T,version:e(/(?:MZBrowser)[\s\/](\d+(?:\.\d+)+)/i)}:/coast/i.test(i)?n={name:"Opera Coast",coast:T,version:w||e(/(?:coast)[\s\/](\d+(\.\d+)?)/i)}:/focus/i.test(i)?n={name:"Focus",focus:T,version:e(/(?:focus)[\s\/](\d+(?:\.\d+)+)/i)}:/yabrowser/i.test(i)?n={name:"Yandex Browser",yandexbrowser:T,version:w||e(/(?:yabrowser)[\s\/](\d+(\.\d+)?)/i)}:/ucbrowser/i.test(i)?n={name:"UC Browser",ucbrowser:T,version:e(/(?:ucbrowser)[\s\/](\d+(?:\.\d+)+)/i)}:/mxios/i.test(i)?n={name:"Maxthon",maxthon:T,version:e(/(?:mxios)[\s\/](\d+(?:\.\d+)+)/i)}:/epiphany/i.test(i)?n={name:"Epiphany",epiphany:T,version:e(/(?:epiphany)[\s\/](\d+(?:\.\d+)+)/i)}:/puffin/i.test(i)?n={name:"Puffin",puffin:T,version:e(/(?:puffin)[\s\/](\d+(?:\.\d+)?)/i)}:/sleipnir/i.test(i)?n={name:"Sleipnir",sleipnir:T,version:e(/(?:sleipnir)[\s\/](\d+(?:\.\d+)+)/i)}:/k-meleon/i.test(i)?n={name:"K-Meleon",kMeleon:T,version:e(/(?:k-meleon)[\s\/](\d+(?:\.\d+)+)/i)}:p?(n={name:"Windows Phone",osname:"Windows Phone",windowsphone:T},v?(n.msedge=T,n.version=v):(n.msie=T,n.version=e(/iemobile\/(\d+(\.\d+)?)/i))):/msie|trident/i.test(i)?n={name:"Internet Explorer",msie:T,version:e(/(?:msie |rv:)(\d+(\.\d+)?)/i)}:l?n={name:"Chrome",osname:"Chrome OS",chromeos:T,chromeBook:T,chrome:T,version:e(/(?:chrome|crios|crmo)\/(\d+(\.\d+)?)/i)}:/edg([ea]|ios)/i.test(i)?n={name:"Microsoft Edge",msedge:T,version:v}:/vivaldi/i.test(i)?n={name:"Vivaldi",vivaldi:T,version:e(/vivaldi\/(\d+(\.\d+)?)/i)||w}:c?n={name:"Sailfish",osname:"Sailfish OS",sailfish:T,version:e(/sailfish\s?browser\/(\d+(\.\d+)?)/i)}:/seamonkey\//i.test(i)?n={name:"SeaMonkey",seamonkey:T,version:e(/seamonkey\/(\d+(\.\d+)?)/i)}:/firefox|iceweasel|fxios/i.test(i)?(n={name:"Firefox",firefox:T,version:e(/(?:firefox|iceweasel|fxios)[ \/](\d+(\.\d+)?)/i)},/\((mobile|tablet);[^\)]*rv:[\d\.]+\)/i.test(i)&&(n.firefoxos=T,n.osname="Firefox OS")):d?n={name:"Amazon Silk",silk:T,version:e(/silk\/(\d+(\.\d+)?)/i)}:/phantom/i.test(i)?n={name:"PhantomJS",phantom:T,version:e(/phantomjs\/(\d+(\.\d+)?)/i)}:/slimerjs/i.test(i)?n={name:"SlimerJS",slimer:T,version:e(/slimerjs\/(\d+(\.\d+)?)/i)}:/blackberry|\bbb\d+/i.test(i)||/rim\stablet/i.test(i)?n={name:"BlackBerry",osname:"BlackBerry OS",blackberry:T,version:w||e(/blackberry[\d]+\/(\d+(\.\d+)?)/i)}:h?(n={name:"WebOS",osname:"WebOS",webos:T,version:w||e(/w(?:eb)?osbrowser\/(\d+(\.\d+)?)/i)},/touchpad\//i.test(i)&&(n.touchpad=T)):/bada/i.test(i)?n={name:"Bada",osname:"Bada",bada:T,version:e(/dolfin\/(\d+(\.\d+)?)/i)}:u?n={name:"Tizen",osname:"Tizen",tizen:T,version:e(/(?:tizen\s?)?browser\/(\d+(\.\d+)?)/i)||w}:/qupzilla/i.test(i)?n={name:"QupZilla",qupzilla:T,version:e(/(?:qupzilla)[\s\/](\d+(?:\.\d+)+)/i)||w}:/chromium/i.test(i)?n={name:"Chromium",chromium:T,version:e(/(?:chromium)[\s\/](\d+(?:\.\d+)?)/i)||w}:/chrome|crios|crmo/i.test(i)?n={name:"Chrome",chrome:T,version:e(/(?:chrome|crios|crmo)\/(\d+(\.\d+)?)/i)}:o?n={name:"Android",version:w}:/safari|applewebkit/i.test(i)?(n={name:"Safari",safari:T},w&&(n.version=w)):r?(n={name:"iphone"==r?"iPhone":"ipad"==r?"iPad":"iPod"},w&&(n.version=w)):n=/googlebot/i.test(i)?{name:"Googlebot",googlebot:T,version:e(/googlebot\/(\d+(\.\d+))/i)||w}:{name:e(/^(.*)\/(.*) /),version:t(/^(.*)\/(.*) /)},!n.msedge&&/(apple)?webkit/i.test(i)?(/(apple)?webkit\/537\.36/i.test(i)?(n.name=n.name||"Blink",n.blink=T):(n.name=n.name||"Webkit",n.webkit=T),!n.version&&w&&(n.version=w)):!n.opera&&/gecko\//i.test(i)&&(n.name=n.name||"Gecko",n.gecko=T,n.version=n.version||e(/gecko\/(\d+(\.\d+)?)/i)),n.windowsphone||!o&&!n.silk?!n.windowsphone&&r?(n[r]=T,n.ios=T,n.osname="iOS"):g?(n.mac=T,n.osname="macOS"):y?(n.xbox=T,n.osname="Xbox"):f?(n.windows=T,n.osname="Windows"):m&&(n.linux=T,n.osname="Linux"):(n.android=T,n.osname="Android");var x="";n.windows?x=function(e){switch(e){case"NT":return"NT";case"XP":return"XP";case"NT 5.0":return"2000";case"NT 5.1":return"XP";case"NT 5.2":return"2003";case"NT 6.0":return"Vista";case"NT 6.1":return"7";case"NT 6.2":return"8";case"NT 6.3":return"8.1";case"NT 10.0":return"10";default:return}}(e(/Windows ((NT|XP)( \d\d?.\d)?)/i)):n.windowsphone?x=e(/windows phone (?:os)?\s?(\d+(\.\d+)*)/i):n.mac?x=(x=e(/Mac OS X (\d+([_\.\s]\d+)*)/i)).replace(/[_\s]/g,"."):r?x=(x=e(/os (\d+([_\s]\d+)*) like mac os x/i)).replace(/[_\s]/g,"."):o?x=e(/android[ \/-](\d+(\.\d+)*)/i):n.webos?x=e(/(?:web|hpw)os\/(\d+(\.\d+)*)/i):n.blackberry?x=e(/rim\stablet\sos\s(\d+(\.\d+)*)/i):n.bada?x=e(/bada\/(\d+(\.\d+)*)/i):n.tizen&&(x=e(/tizen[\/\s](\d+(\.\d+)*)/i)),x&&(n.osversion=x);var k=!n.windows&&x.split(".")[0];return b||a||"ipad"==r||o&&(3==k||4<=k&&!_)||n.silk?n.tablet=T:(_||"iphone"==r||"ipod"==r||o||s||n.blackberry||n.webos||n.bada)&&(n.mobile=T),n.msedge||n.msie&&10<=n.version||n.yandexbrowser&&15<=n.version||n.vivaldi&&1<=n.version||n.chrome&&20<=n.version||n.samsungBrowser&&4<=n.version||n.whale&&1===E([n.version,"1.0"])||n.mzbrowser&&1===E([n.version,"6.0"])||n.focus&&1===E([n.version,"1.0"])||n.firefox&&20<=n.version||n.safari&&6<=n.version||n.opera&&10<=n.version||n.ios&&n.osversion&&6<=n.osversion.split(".")[0]||n.blackberry&&10.1<=n.version||n.chromium&&20<=n.version?n.a=T:n.msie&&n.version<10||n.chrome&&n.version<20||n.firefox&&n.version<20||n.safari&&n.version<6||n.opera&&n.version<10||n.ios&&n.osversion&&n.osversion.split(".")[0]<6||n.chromium&&n.version<20?n.c=T:n.x=T,n}var a=s("undefined"!=typeof navigator&&navigator.userAgent||"");function n(e){return e.split(".").length}function r(e,t){var i,n=[];if(Array.prototype.map)return Array.prototype.map.call(e,t);for(i=0;i<e.length;i++)n.push(t(e[i]));return n}function E(e){for(var i=Math.max(n(e[0]),n(e[1])),t=r(e,function(e){var t=i-n(e);return r((e+=new Array(1+t).join(".0")).split("."),function(e){return new Array(20-e.length).join("0")+e}).reverse()});0<=--i;){if(t[0][i]>t[1][i])return 1;if(t[0][i]!==t[1][i])return-1;if(0===i)return 0}}function o(e,t,i){var n=a;"string"==typeof t&&(i=t,t=void 0),void 0===t&&(t=!1),i&&(n=s(i));var r=""+n.version;for(var o in e)if(e.hasOwnProperty(o)&&n[o]){if("string"!=typeof e[o])throw new Error("Browser version in the minVersion map should be a string: "+o+": "+String(e));return E([r,e[o]])<0}return t}return a.test=function(e){for(var t=0;t<e.length;++t){var i=e[t];if("string"==typeof i&&i in a)return!0}return!1},a.isUnsupportedBrowser=o,a.compareVersions=E,a.check=function(e,t,i){return!o(e,t,i)},a._detect=s,a.detect=s,a},void 0!==t&&t.exports?t.exports=r():"function"==typeof define&&define.amd?define("bowser",r):n.bowser=r()},{}],8:[function(e,t,i){var n=e("./default"),r=e("./parser");e("./util");function h(e){return null==e}function o(e){(e=e||{}).whiteList=e.whiteList||n.whiteList,e.onAttr=e.onAttr||n.onAttr,e.onIgnoreAttr=e.onIgnoreAttr||n.onIgnoreAttr,this.options=e}o.prototype.process=function(e){if(!(e=(e=e||"").toString()))return"";var t=this.options,d=t.whiteList,c=t.onAttr,u=t.onIgnoreAttr;return r(e,function(e,t,i,n,r){var o=d[i],s=!1;!0===o?s=o:"function"==typeof o?s=o(n):o instanceof RegExp&&(s=o.test(n)),!0!==s&&(s=!1);var a,l={position:t,sourcePosition:e,source:r,isWhite:s};return s?h(a=c(i,n,l))?i+":"+n:a:h(a=u(i,n,l))?void 0:a})},t.exports=o},{"./default":9,"./parser":11,"./util":12}],9:[function(e,t,i){function n(){var e={"align-content":!1,"align-items":!1,"align-self":!1,"alignment-adjust":!1,"alignment-baseline":!1,all:!1,"anchor-point":!1,animation:!1,"animation-delay":!1,"animation-direction":!1,"animation-duration":!1,"animation-fill-mode":!1,"animation-iteration-count":!1,"animation-name":!1,"animation-play-state":!1,"animation-timing-function":!1,azimuth:!1,"backface-visibility":!1,background:!0,"background-attachment":!0,"background-clip":!0,"background-color":!0,"background-image":!0,"background-origin":!0,"background-position":!0,"background-repeat":!0,"background-size":!0,"baseline-shift":!1,binding:!1,bleed:!1,"bookmark-label":!1,"bookmark-level":!1,"bookmark-state":!1,border:!0,"border-bottom":!0,"border-bottom-color":!0,"border-bottom-left-radius":!0,"border-bottom-right-radius":!0,"border-bottom-style":!0,"border-bottom-width":!0,"border-collapse":!0,"border-color":!0,"border-image":!0,"border-image-outset":!0,"border-image-repeat":!0,"border-image-slice":!0,"border-image-source":!0,"border-image-width":!0,"border-left":!0,"border-left-color":!0,"border-left-style":!0,"border-left-width":!0,"border-radius":!0,"border-right":!0,"border-right-color":!0,"border-right-style":!0,"border-right-width":!0,"border-spacing":!0,"border-style":!0,"border-top":!0,"border-top-color":!0,"border-top-left-radius":!0,"border-top-right-radius":!0,"border-top-style":!0,"border-top-width":!0,"border-width":!0,bottom:!1,"box-decoration-break":!0,"box-shadow":!0,"box-sizing":!0,"box-snap":!0,"box-suppress":!0,"break-after":!0,"break-before":!0,"break-inside":!0,"caption-side":!1,chains:!1,clear:!0,clip:!1,"clip-path":!1,"clip-rule":!1,color:!0,"color-interpolation-filters":!0,"column-count":!1,"column-fill":!1,"column-gap":!1,"column-rule":!1,"column-rule-color":!1,"column-rule-style":!1,"column-rule-width":!1,"column-span":!1,"column-width":!1,columns:!1,contain:!1,content:!1,"counter-increment":!1,"counter-reset":!1,"counter-set":!1,crop:!1,cue:!1,"cue-after":!1,"cue-before":!1,cursor:!1,direction:!1,display:!0,"display-inside":!0,"display-list":!0,"display-outside":!0,"dominant-baseline":!1,elevation:!1,"empty-cells":!1,filter:!1,flex:!1,"flex-basis":!1,"flex-direction":!1,"flex-flow":!1,"flex-grow":!1,"flex-shrink":!1,"flex-wrap":!1,float:!1,"float-offset":!1,"flood-color":!1,"flood-opacity":!1,"flow-from":!1,"flow-into":!1,font:!0,"font-family":!0,"font-feature-settings":!0,"font-kerning":!0,"font-language-override":!0,"font-size":!0,"font-size-adjust":!0,"font-stretch":!0,"font-style":!0,"font-synthesis":!0,"font-variant":!0,"font-variant-alternates":!0,"font-variant-caps":!0,"font-variant-east-asian":!0,"font-variant-ligatures":!0,"font-variant-numeric":!0,"font-variant-position":!0,"font-weight":!0,grid:!1,"grid-area":!1,"grid-auto-columns":!1,"grid-auto-flow":!1,"grid-auto-rows":!1,"grid-column":!1,"grid-column-end":!1,"grid-column-start":!1,"grid-row":!1,"grid-row-end":!1,"grid-row-start":!1,"grid-template":!1,"grid-template-areas":!1,"grid-template-columns":!1,"grid-template-rows":!1,"hanging-punctuation":!1,height:!0,hyphens:!1,icon:!1,"image-orientation":!1,"image-resolution":!1,"ime-mode":!1,"initial-letters":!1,"inline-box-align":!1,"justify-content":!1,"justify-items":!1,"justify-self":!1,left:!1,"letter-spacing":!0,"lighting-color":!0,"line-box-contain":!1,"line-break":!1,"line-grid":!1,"line-height":!1,"line-snap":!1,"line-stacking":!1,"line-stacking-ruby":!1,"line-stacking-shift":!1,"line-stacking-strategy":!1,"list-style":!0,"list-style-image":!0,"list-style-position":!0,"list-style-type":!0,margin:!0,"margin-bottom":!0,"margin-left":!0,"margin-right":!0,"margin-top":!0,"marker-offset":!1,"marker-side":!1,marks:!1,mask:!1,"mask-box":!1,"mask-box-outset":!1,"mask-box-repeat":!1,"mask-box-slice":!1,"mask-box-source":!1,"mask-box-width":!1,"mask-clip":!1,"mask-image":!1,"mask-origin":!1,"mask-position":!1,"mask-repeat":!1,"mask-size":!1,"mask-source-type":!1,"mask-type":!1,"max-height":!0,"max-lines":!1,"max-width":!0,"min-height":!0,"min-width":!0,"move-to":!1,"nav-down":!1,"nav-index":!1,"nav-left":!1,"nav-right":!1,"nav-up":!1,"object-fit":!1,"object-position":!1,opacity:!1,order:!1,orphans:!1,outline:!1,"outline-color":!1,"outline-offset":!1,"outline-style":!1,"outline-width":!1,overflow:!1,"overflow-wrap":!1,"overflow-x":!1,"overflow-y":!1,padding:!0,"padding-bottom":!0,"padding-left":!0,"padding-right":!0,"padding-top":!0,page:!1,"page-break-after":!1,"page-break-before":!1,"page-break-inside":!1,"page-policy":!1,pause:!1,"pause-after":!1,"pause-before":!1,perspective:!1,"perspective-origin":!1,pitch:!1,"pitch-range":!1,"play-during":!1,position:!1,"presentation-level":!1,quotes:!1,"region-fragment":!1,resize:!1,rest:!1,"rest-after":!1,"rest-before":!1,richness:!1,right:!1,rotation:!1,"rotation-point":!1,"ruby-align":!1,"ruby-merge":!1,"ruby-position":!1,"shape-image-threshold":!1,"shape-outside":!1,"shape-margin":!1,size:!1,speak:!1,"speak-as":!1,"speak-header":!1,"speak-numeral":!1,"speak-punctuation":!1,"speech-rate":!1,stress:!1,"string-set":!1,"tab-size":!1,"table-layout":!1,"text-align":!0,"text-align-last":!0,"text-combine-upright":!0,"text-decoration":!0,"text-decoration-color":!0,"text-decoration-line":!0,"text-decoration-skip":!0,"text-decoration-style":!0,"text-emphasis":!0,"text-emphasis-color":!0,"text-emphasis-position":!0,"text-emphasis-style":!0,"text-height":!0,"text-indent":!0,"text-justify":!0,"text-orientation":!0,"text-overflow":!0,"text-shadow":!0,"text-space-collapse":!0,"text-transform":!0,"text-underline-position":!0,"text-wrap":!0,top:!1,transform:!1,"transform-origin":!1,"transform-style":!1,transition:!1,"transition-delay":!1,"transition-duration":!1,"transition-property":!1,"transition-timing-function":!1,"unicode-bidi":!1,"vertical-align":!1,visibility:!1,"voice-balance":!1,"voice-duration":!1,"voice-family":!1,"voice-pitch":!1,"voice-range":!1,"voice-rate":!1,"voice-stress":!1,"voice-volume":!1,volume:!1,"white-space":!1,widows:!1,width:!0,"will-change":!1,"word-break":!0,"word-spacing":!0,"word-wrap":!0,"wrap-flow":!1,"wrap-through":!1,"writing-mode":!1,"z-index":!1};return e}i.whiteList=n(),i.getDefaultWhiteList=n,i.onAttr=function(e,t,i){},i.onIgnoreAttr=function(e,t,i){}},{}],10:[function(e,t,i){var n=e("./default"),r=e("./css");for(var o in(i=t.exports=function(e,t){return new r(t).process(e)}).FilterCSS=r,n)i[o]=n[o];"undefined"!=typeof window&&(window.filterCSS=t.exports)},{"./css":8,"./default":9}],11:[function(e,t,i){var u=e("./util");t.exports=function(o,s){";"!==(o=u.trimRight(o))[o.length-1]&&(o+=";");var e=o.length,a=!1,l=0,d=0,c="";function t(){if(!a){var e=u.trim(o.slice(l,d)),t=e.indexOf(":");if(-1!==t){var i=u.trim(e.slice(0,t)),n=u.trim(e.slice(t+1));if(i){var r=s(l,c.length,i,n,e);r&&(c+=r+"; ")}}}l=d+1}for(;d<e;d++){var i=o[d];if("/"===i&&"*"===o[d+1]){var n=o.indexOf("*/",d+2);if(-1===n)break;l=(d=n+1)+1,a=!1}else"("===i?a=!0:")"===i?a=!1:";"===i?a||t():"\n"===i&&t()}return u.trim(c)}},{"./util":12}],12:[function(e,t,i){t.exports={indexOf:function(e,t){var i,n;if(Array.prototype.indexOf)return e.indexOf(t);for(i=0,n=e.length;i<n;i++)if(e[i]===t)return i;return-1},forEach:function(e,t,i){var n,r;if(Array.prototype.forEach)return e.forEach(t,i);for(n=0,r=e.length;n<r;n++)t.call(i,e[n],n,e)},trim:function(e){return String.prototype.trim?e.trim():e.replace(/(^\s*)|(\s*$)/g,"")},trimRight:function(e){return String.prototype.trimRight?e.trimRight():e.replace(/(\s*$)/g,"")}}},{}],13:[function(e,t,i){var n,r;n=this,r=function(){var e={},i="undefined"!=typeof window&&window,t="undefined"!=typeof document&&document,n=t&&t.documentElement,r=i.matchMedia||i.msMatchMedia,o=r?function(e){return!!r.call(i,e).matches}:function(){return!1},s=e.viewportW=function(){var e=n.clientWidth,t=i.innerWidth;return e<t?t:e},a=e.viewportH=function(){var e=n.clientHeight,t=i.innerHeight;return e<t?t:e};function l(){return{width:s(),height:a()}}function d(e,t){return!(!(e=e&&!e.nodeType?e[0]:e)||1!==e.nodeType)&&function(e,t){var i={};return t=+t||0,i.width=(i.right=e.right+t)-(i.left=e.left-t),i.height=(i.bottom=e.bottom+t)-(i.top=e.top-t),i}(e.getBoundingClientRect(),t)}return e.mq=o,e.matchMedia=r?function(){return r.apply(i,arguments)}:function(){return{}},e.viewport=l,e.scrollX=function(){return i.pageXOffset||n.scrollLeft},e.scrollY=function(){return i.pageYOffset||n.scrollTop},e.rectangle=d,e.aspect=function(e){var t=(e=null==e?l():1===e.nodeType?d(e):e).height,i=e.width;return t="function"==typeof t?t.call(e):t,(i="function"==typeof i?i.call(e):i)/t},e.inX=function(e,t){var i=d(e,t);return!!i&&0<=i.right&&i.left<=s()},e.inY=function(e,t){var i=d(e,t);return!!i&&0<=i.bottom&&i.top<=a()},e.inViewport=function(e,t){var i=d(e,t);return!!i&&0<=i.bottom&&0<=i.right&&i.top<=a()&&i.left<=s()},e},void 0!==t&&t.exports?t.exports=r():n.verge=r()},{}],14:[function(e,t,i){(i={THEME_RTD:"sphinx_rtd_theme",THEME_ALABASTER:"alabaster",THEME_MKDOCS_RTD:"readthedocs",THEME_CELERY:"sphinx_celery",THEME_BABEL:"babel",THEME_CLICK:"click",THEME_FLASK_SQLALCHEMY:"flask-sqlalchemy",THEME_FLASK:"flask",THEME_JINJA:"jinja",THEME_PLATTER:"platter",THEME_POCOO:"pocoo",THEME_WERKZEUG:"werkzeug",DEFAULT_PROMO_PRIORITY:5,MINIMUM_PROMO_PRIORITY:10,MAXIMUM_PROMO_PRIORITY:1,LOW_PROMO_PRIORITY:10}).ALABASTER_LIKE_THEMES=[i.THEME_ALABASTER,i.THEME_CELERY,i.THEME_BABEL,i.THEME_CLICK,i.THEME_FLASK_SQLALCHEMY,i.THEME_FLASK,i.THEME_JINJA,i.THEME_PLATTER,i.THEME_POCOO,i.THEME_WERKZEUG],i.PROMO_TYPES={LEFTNAV:"doc",FOOTER:"site-footer",FIXED_FOOTER:"fixed-footer"},t.exports=i},{}],15:[function(e,t,i){var n=e("./rtd-data"),r=e("./version-compare");function o(){$.ajaxSetup({beforeSend:function(e,t){!function(e){return/^(GET|HEAD|OPTIONS|TRACE)$/.test(e)}(t.type)&&e.setRequestHeader("X-CSRFToken",$("a.bookmark[token]").attr("token"))}})}t.exports={init:function(){var e=n.get(),t={project:e.project,version:e.version,page:e.page,theme:e.get_theme_name(),format:"jsonp"};"docroot"in e&&(t.docroot=e.docroot),"source_suffix"in e&&(t.source_suffix=e.source_suffix),0===window.location.pathname.indexOf("/projects/")&&(t.subproject=!0),$.ajax({url:e.proxied_api_host+"/api/v2/footer_html/",crossDomain:!0,xhrFields:{withCredentials:!0},dataType:"jsonp",data:t,success:function(e){e.show_version_warning&&r.init(e.version_compare),function(e){var t=n.get();t.is_sphinx_builder()&&t.is_rtd_like_theme()?$("div.rst-other-versions").html(e.html):$("body").append(e.html),e.version_active?e.version_supported:$(".rst-current-version").addClass("rst-out-of-date")}(e),o()},error:function(){console.error("Error loading Read the Docs footer")}})}}},{"./rtd-data":16,"./version-compare":20}],16:[function(e,t,i){var n=e("./constants"),r={is_rtd_like_theme:function(){return 1===$("div.rst-other-versions").length||(this.theme===n.THEME_RTD||this.theme===n.THEME_MKDOCS_RTD)},is_alabaster_like_theme:function(){return-1<n.ALABASTER_LIKE_THEMES.indexOf(this.get_theme_name())},is_sphinx_builder:function(){return!("builder"in this)||"mkdocs"!==this.builder},is_mkdocs_builder:function(){return"builder"in this&&"mkdocs"===this.builder},get_theme_name:function(){return this.theme},show_promo:function(){return"https://readthedocs.org"===this.api_host||"http://community.dev.readthedocs.io"===this.api_host||"http://127.0.0.1:8000"===this.api_host}};t.exports={get:function(){var e=Object.create(r);return $.extend(e,{api_host:"https://readthedocs.org",ad_free:!1},window.READTHEDOCS_DATA),e.proxied_api_host="/_",e}}},{"./constants":14}],17:[function(e,t,i){var n=e("./rtd-data"),O=e("./../../../../../../bower_components/xss/lib/index"),R=3,C=100;function M(t,i,n){try{t.append($u.template(i,n))}catch(e){t.append($u.template(i)(n))}}t.exports={init:function(){!function(t){var S=t.project,i=t.version,r=t.language||"en";if("undefined"!=typeof Search&&S&&i&&(!t.features||!t.features.docsearch_disabled)){var e=Search.query;Search.query_fallback=e,Search.query=function(A){var n=$.Deferred(),e=document.createElement("a");e.href=t.proxied_api_host+"/api/v2/docsearch/",e.search="?q="+$.urlencode(A)+"&project="+S+"&version="+i+"&language="+r,n.then(function(e){var t=e.results||[];e.count;if(t.length)for(var i=0;i<t.length;i+=1){var n=t[i],r=n.highlight,o=n.inner_hits||[],s=$('<li style="display: none;"></li>'),a=n.title;r&&r.title&&(a=O(r.title[0]));var l=n.link+"?highlight="+$.urlencode(A),d=$("<a>",{href:l});if(d.html(a),d.find("span").addClass("highlighted"),s.append(d),n.project!==S){var c=" (from project "+n.project+")",u=$("<span>",{text:c});s.append(u)}for(var h=0;h<o.length;h+=1){var p=$('<div class="context">'),f="",g="",m="",v="",w="",b="",y="",x="",k="",T="";if("sections"===o[h].type){if(g=(f=o[h])._source.title,m=l+"#"+f._source.id,v=[f._source.content.substr(0,C)+" ..."],f.highlight&&(f.highlight["sections.title"]&&(g=O(f.highlight["sections.title"][0])),f.highlight["sections.content"])){w=f.highlight["sections.content"],v=[];for(var E=0;E<w.length&&E<R;E+=1)v.push("... "+O(w[E])+" ...")}M(p,'<div><a href="<%= section_subtitle_link %>"><%= section_subtitle %></a></div><% for (var i = 0; i < section_content.length; ++i) { %><div><%= section_content[i] %></div><% } %>',{section_subtitle_link:m,section_subtitle:g,section_content:v})}"domains"===o[h].type&&(y=(b=o[h])._source.role_name,x=l+"#"+b._source.anchor,k=b._source.name,(T="")!==b._source.docstrings&&(T=b._source.docstrings.substr(0,C)+" ..."),b.highlight&&(b.highlight["domains.docstrings"]&&(T="... "+O(b.highlight["domains.docstrings"][0])+" ..."),b.highlight["domains.name"]&&(k=O(b.highlight["domains.name"][0]))),M(p,'<div><a href="<%= domain_subtitle_link %>"><%= domain_subtitle %></a></div><div><%= domain_content %></div>',{domain_subtitle_link:x,domain_subtitle:"["+y+"]: "+k,domain_content:T})),p.find("span").addClass("highlighted"),s.append(p),h!==o.length-1&&s.append($("<div class='rtd_search_hits_spacing'></div>"))}Search.output.append(s),s.slideDown(5)}t.length?Search.status.text(_("Search finished, found %s page(s) matching the search query.").replace("%s",t.length)):(Search.query_fallback(A),console.log("Read the Docs search failed. Falling back to Sphinx search."))}).fail(function(e){Search.query_fallback(A)}).always(function(){$("#search-progress").empty(),Search.stopPulse(),Search.title.text(_("Search Results")),Search.status.fadeIn(500)}),$.ajax({url:e.href,crossDomain:!0,xhrFields:{withCredentials:!0},complete:function(e,t){return"success"!==t||void 0===e.responseJSON||0===e.responseJSON.count?n.reject():n.resolve(e.responseJSON)}}).fail(function(e,t,i){return n.reject()})}}$(document).ready(function(){"undefined"!=typeof Search&&Search.init()})}(n.get())}}},{"./../../../../../../bower_components/xss/lib/index":3,"./rtd-data":16}],18:[function(r,e,t){var o=r("./rtd-data");e.exports={init:function(){var e=o.get();if($(document).on("click","[data-toggle='rst-current-version']",function(){var e=$("[data-toggle='rst-versions']").hasClass("shift-up")?"was_open":"was_closed";"undefined"!=typeof ga?ga("rtfd.send","event","Flyout","Click",e):"undefined"!=typeof _gaq&&_gaq.push(["rtfd._setAccount","UA-17997319-1"],["rtfd._trackEvent","Flyout","Click",e])}),void 0===window.SphinxRtdTheme){var t=r("./../../../../../../bower_components/sphinx-rtd-theme/js/theme.js").ThemeNav;if($(document).ready(function(){setTimeout(function(){t.navBar||t.enable()},1e3)}),e.is_rtd_like_theme())if(!$("div.wy-side-scroll:first").length){console.log("Applying theme sidebar fix...");var i=$("nav.wy-nav-side:first"),n=$("<div />").addClass("wy-side-scroll");i.children().detach().appendTo(n),n.prependTo(i),t.navBar=n}}}}},{"./../../../../../../bower_components/sphinx-rtd-theme/js/theme.js":1,"./rtd-data":16}],19:[function(e,t,i){var l,d=e("./constants"),c=e("./rtd-data"),n=e("bowser"),u="#ethical-ad-placement";function h(){var e,t,i="rtd-"+(Math.random()+1).toString(36).substring(4),n=d.PROMO_TYPES.LEFTNAV,r=d.DEFAULT_PROMO_PRIORITY,o=null;return l.is_mkdocs_builder()&&l.is_rtd_like_theme()?(o="nav.wy-nav-side",e="ethical-rtd ethical-dark-theme"):l.is_rtd_like_theme()?(o="nav.wy-nav-side > div.wy-side-scroll",e="ethical-rtd ethical-dark-theme"):l.is_alabaster_like_theme()&&(o="div.sphinxsidebar > div.sphinxsidebarwrapper",e="ethical-alabaster"),o?($("<div />").attr("id",i).addClass(e).appendTo(o),(!(t=$("#"+i).offset())||t.top>$(window).height())&&(r=d.LOW_PROMO_PRIORITY),{div_id:i,display_type:n,priority:r}):null}function p(){var e,t,i="rtd-"+(Math.random()+1).toString(36).substring(4),n=d.PROMO_TYPES.FOOTER,r=d.DEFAULT_PROMO_PRIORITY,o=null;return l.is_rtd_like_theme()?(o=$("<div />").insertAfter("footer hr"),e="ethical-rtd"):l.is_alabaster_like_theme()&&(o="div.bodywrapper .body",e="ethical-alabaster"),o?($("<div />").attr("id",i).addClass(e).appendTo(o),(!(t=$("#"+i).offset())||t.top<$(window).height())&&(r=d.LOW_PROMO_PRIORITY),{div_id:i,display_type:n,priority:r}):null}function f(){var e="rtd-"+(Math.random()+1).toString(36).substring(4),t=d.PROMO_TYPES.FIXED_FOOTER,i=d.DEFAULT_PROMO_PRIORITY;return n&&n.mobile&&(i=d.MAXIMUM_PROMO_PRIORITY),$("<div />").attr("id",e).appendTo("body"),{div_id:e,display_type:t,priority:i}}function g(e){this.id=e.id,this.div_id=e.div_id||"",this.html=e.html||"",this.display_type=e.display_type||"",this.view_tracking_url=e.view_url,this.click_handler=function(){"undefined"!=typeof ga?ga("rtfd.send","event","Promo","Click",e.id):"undefined"!=typeof _gaq&&_gaq.push(["rtfd._setAccount","UA-17997319-1"],["rtfd._trackEvent","Promo","Click",e.id])}}g.prototype.display=function(){var e="#"+this.div_id,t=this.view_tracking_url;$(e).html(this.html),$(e).find('a[href*="/sustainability/click/"]').on("click",this.click_handler);function i(){$.inViewport($(e),-3)&&($("<img />").attr("src",t).css("display","none").appendTo(e),$(window).off(".rtdinview"),$(".wy-side-scroll").off(".rtdinview"))}$(window).on("DOMContentLoaded.rtdinview load.rtdinview scroll.rtdinview resize.rtdinview",i),$(".wy-side-scroll").on("scroll.rtdinview",i),$(".ethical-close").on("click",function(){return $(e).hide(),!1}),this.post_promo_display()},g.prototype.disable=function(){$("#"+this.div_id).hide()},g.prototype.post_promo_display=function(){this.display_type===d.PROMO_TYPES.FOOTER&&($("<hr />").insertAfter("#"+this.div_id),$("<hr />").insertBefore("#"+this.div_id+".ethical-alabaster .ethical-footer"))},t.exports={Promo:g,init:function(){var e,t,i={format:"jsonp"},n=[],r=[],o=[],s=[p,h,f];if(l=c.get(),t=function(){var e,t="rtd-"+(Math.random()+1).toString(36).substring(4),i=d.PROMO_TYPES.LEFTNAV;return e=l.is_rtd_like_theme()?"ethical-rtd ethical-dark-theme":"ethical-alabaster",0<$(u).length?($("<div />").attr("id",t).addClass(e).appendTo(u),{div_id:t,display_type:i}):null}())n.push(t.div_id),r.push(t.display_type),o.push(t.priority||d.DEFAULT_PROMO_PRIORITY),!0;else{if(!l.show_promo())return;for(var a=0;a<s.length;a+=1)(t=s[a]())&&(n.push(t.div_id),r.push(t.display_type),o.push(t.priority||d.DEFAULT_PROMO_PRIORITY))}i.div_ids=n.join("|"),i.display_types=r.join("|"),i.priorities=o.join("|"),i.project=l.project,i.theme=l.get_theme_name(),"undefined"!=typeof URL&&"undefined"!=typeof URLSearchParams&&((e=new URL(window.location).searchParams).get("force_promo")&&(i.force_promo=e.get("force_promo")),e.get("force_campaign")&&(i.force_campaign=e.get("force_campaign"))),$.ajax({url:l.api_host+"/api/v2/sustainability/",crossDomain:!0,xhrFields:{withCredentials:!0},dataType:"jsonp",data:i,success:function(e){e&&e.div_id&&e.html&&new g(e).display()},error:function(){console.error("Error loading Read the Docs promo"),!l.ad_free&&"https://readthedocs.org"===l.api_host&&function(){var e=!1;return $("<div />").attr("id","rtd-detection").attr("class","ethical-rtd").html("&nbsp;").appendTo("body"),0===$("#rtd-detection").height()&&(e=!0),$("#rtd-detection").remove(),e}()&&(console.log("---------------------------------------------------------------------------------------"),console.log("Read the Docs hosts documentation for tens of thousands of open source projects."),console.log("We fund our development (we are open source) and operations through advertising."),console.log("We promise to:"),console.log(" - never let advertisers run 3rd party JavaScript"),console.log(" - never sell user data to advertisers or other 3rd parties"),console.log(" - only show advertisements of interest to developers"),console.log("Read more about our approach to advertising here: https://docs.readthedocs.io/en/latest/advertising/ethical-advertising.html"),console.log("%cPlease allow our Ethical Ads or go ad-free:","font-size: 2em"),console.log("https://docs.readthedocs.io/en/latest/advertising/ad-blocking.html"),console.log("--------------------------------------------------------------------------------------"),function(){var e=h(),t=null;e&&e.div_id&&(t=$("#"+e.div_id).attr("class","keep-us-sustainable"),$("<p />").text("Support Read the Docs!").appendTo(t),$("<p />").html('Please help keep us sustainable by <a href="https://docs.readthedocs.io/en/latest/advertising/ad-blocking.html#allowing-ethical-ads">allowing our Ethical Ads in your ad blocker</a> or <a href="https://readthedocs.org/sustainability/">go ad-free</a> by subscribing.').appendTo(t),$("<p />").text("Thank you! ❤️").appendTo(t))}())}})}}},{"./constants":14,"./rtd-data":16,bowser:7}],20:[function(e,t,i){var o=e("./rtd-data");t.exports={init:function(e){var t=o.get();if(!e.is_highest){var i=window.location.pathname.replace(t.version,e.slug),n=$('<div class="admonition warning"> <p class="first admonition-title">Note</p> <p class="last"> You are not reading the most recent version of this documentation. <a href="#"></a> is the latest version available.</p></div>');n.find("a").attr("href",i).text(e.slug);var r=$("div.body");r.length||(r=$("div.document")),r.prepend(n)}}}},{"./rtd-data":16}],21:[function(e,t,i){var n=e("./doc-embed/sponsorship"),r=e("./doc-embed/footer.js"),o=(e("./doc-embed/rtd-data"),e("./doc-embed/sphinx")),s=e("./doc-embed/search");$.extend(e("verge")),$(document).ready(function(){r.init(),o.init(),s.init(),n.init()})},{"./doc-embed/footer.js":15,"./doc-embed/rtd-data":16,"./doc-embed/search":17,"./doc-embed/sphinx":18,"./doc-embed/sponsorship":19,verge:13}]},{},[21]);
\ No newline at end of file
diff --git a/readthedocs/search/api.py b/readthedocs/search/api.py
index d5e123d2863..e7155df61e2 100644
--- a/readthedocs/search/api.py
+++ b/readthedocs/search/api.py
@@ -9,6 +9,7 @@
 
 from readthedocs.api.v2.permissions import IsAuthorizedToViewVersion
 from readthedocs.builds.models import Version
+from readthedocs.projects.constants import MKDOCS, SPHINX_HTMLDIR
 from readthedocs.projects.models import HTMLFile, Project
 from readthedocs.search import tasks, utils
 from readthedocs.search.faceted_search import PageSearch
@@ -27,15 +28,28 @@ class PageSearchSerializer(serializers.Serializer):
     version = serializers.CharField()
     title = serializers.CharField()
     path = serializers.CharField()
+    full_path = serializers.CharField()
     link = serializers.SerializerMethodField()
     highlight = serializers.SerializerMethodField()
     inner_hits = serializers.SerializerMethodField()
 
     def get_link(self, obj):
-        projects_url = self.context.get('projects_url')
-        if projects_url:
-            docs_url = projects_url[obj.project]
-            return docs_url + obj.path
+        project_data = self.context['projects_data'].get(obj.project)
+        if not project_data:
+            return None
+
+        docs_url, doctype = project_data
+        path = obj.full_path
+
+        # Generate an appropriate link for the doctype,
+        # And always end it with / so it goes directly to proxito.
+        if (
+            doctype in {SPHINX_HTMLDIR, MKDOCS} and
+            path == 'index.html' or path.endswith('/index.html')
+        ):
+            path = path[:-len('index.html')].rstrip('/') + '/'
+
+        return docs_url + path
 
     def get_highlight(self, obj):
         highlight = getattr(obj.meta, 'highlight', None)
@@ -155,7 +169,7 @@ def validate_query_params(self):
 
     def get_serializer_context(self):
         context = super().get_serializer_context()
-        context['projects_url'] = self.get_all_projects_url()
+        context['projects_data'] = self.get_all_projects_data()
         return context
 
     def get_all_projects(self):
@@ -183,19 +197,17 @@ def get_all_projects(self):
                 all_projects.append(version.project)
         return all_projects
 
-    def get_all_projects_url(self):
+    def get_all_projects_data(self):
         """
-        Return a dict containing the project slug and its version URL.
-
-        The dictionary contains the project and its subprojects . Each project's
-        slug is used as a key and the documentation URL for that project and
-        version as the value.
+        Return a dict containing the project slug and its version URL and version's doctype.
 
-        Example:
+        The dictionary contains the project and its subprojects. Each project's
+        slug is used as a key and a tuple with the documentation URL and doctype
+        from the version. Example:
 
         {
-            "requests": "https://requests.readthedocs.io/en/latest/",
-            "requests-oauth": "https://requests-oauth.readthedocs.io/en/latest/",
+            "requests": ("https://requests.readthedocs.io/en/latest/", "sphinx"),
+            "requests-oauth": ("https://requests-oauth.readthedocs.io/en/latest/", "sphinx_htmldir"),
         }
 
         :rtype: dict
@@ -205,7 +217,17 @@ def get_all_projects_url(self):
         projects_url = {}
         for project in all_projects:
             projects_url[project.slug] = project.get_docs_url(version_slug=version_slug)
-        return projects_url
+
+        versions_doctype = (
+            Version.objects
+            .filter(project__slug__in=projects_url.keys(), slug=version_slug)
+            .values_list('project__slug', 'documentation_type')
+        )
+        projects_data = {
+            project_slug: (projects_url[project_slug], doctype)
+            for project_slug, doctype in versions_doctype
+        }
+        return projects_data
 
     def list(self, request, *args, **kwargs):
         """Overriding ``list`` method to record query in database."""

From 6f2ce2cbc34974a196c58c98e264c33fd18194f9 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Tue, 12 May 2020 18:24:14 -0500
Subject: [PATCH 34/72] Use regex

---
 readthedocs/search/api.py | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/readthedocs/search/api.py b/readthedocs/search/api.py
index e6ca62a3b78..bacd39f9b88 100644
--- a/readthedocs/search/api.py
+++ b/readthedocs/search/api.py
@@ -1,5 +1,6 @@
 import itertools
 import logging
+import re
 
 from django.shortcuts import get_object_or_404
 from django.utils import timezone
@@ -43,11 +44,9 @@ def get_link(self, obj):
 
         # Generate an appropriate link for the doctype,
         # And always end it with / so it goes directly to proxito.
-        if (
-            doctype in {SPHINX_HTMLDIR, MKDOCS} and
-            path == 'index.html' or path.endswith('/index.html')
-        ):
-            path = path[:-len('index.html')].rstrip('/') + '/'
+        if doctype in {SPHINX_HTMLDIR, MKDOCS}:
+            new_path = re.sub('(^|/)index.html$', '', path)
+            path = path.rstrip('/') + '/'
 
         return docs_url + path
 
@@ -208,8 +207,14 @@ def get_all_projects_data(self):
         from the version. Example:
 
         {
-            "requests": ("https://requests.readthedocs.io/en/latest/", "sphinx"),
-            "requests-oauth": ("https://requests-oauth.readthedocs.io/en/latest/", "sphinx_htmldir"),
+            "requests": (
+                "https://requests.readthedocs.io/en/latest/",
+                "sphinx",
+            ),
+            "requests-oauth": (
+                "https://requests-oauth.readthedocs.io/en/latest/",
+                "sphinx_htmldir",
+            ),
         }
 
         :rtype: dict

From 247cf60e9e960b8c8c158ea49cd14f66570f175b Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Tue, 12 May 2020 18:25:14 -0500
Subject: [PATCH 35/72] Better wording

---
 readthedocs/search/api.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/readthedocs/search/api.py b/readthedocs/search/api.py
index bacd39f9b88..ffb2a054607 100644
--- a/readthedocs/search/api.py
+++ b/readthedocs/search/api.py
@@ -42,8 +42,8 @@ def get_link(self, obj):
         docs_url, doctype = project_data
         path = obj.full_path
 
-        # Generate an appropriate link for the doctype,
-        # And always end it with / so it goes directly to proxito.
+        # Generate an appropriate link for the doctypes that use htmldir,
+        # and always end it with / so it goes directly to proxito.
         if doctype in {SPHINX_HTMLDIR, MKDOCS}:
             new_path = re.sub('(^|/)index.html$', '', path)
             path = path.rstrip('/') + '/'

From 75623f1224315b0bc223f32685f65f97ea89c583 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Tue, 12 May 2020 18:29:41 -0500
Subject: [PATCH 36/72] Sphinx Search: don't skip indexing if one file fails

Changed the var names to make them more clear
---
 readthedocs/projects/models.py | 26 ++++++++++++--------------
 1 file changed, 12 insertions(+), 14 deletions(-)

diff --git a/readthedocs/projects/models.py b/readthedocs/projects/models.py
index d20cd8048f1..5dd705c70b0 100644
--- a/readthedocs/projects/models.py
+++ b/readthedocs/projects/models.py
@@ -1242,9 +1242,6 @@ def get_processed_json_sphinx(self):
         Both lead to `foo/index.html`
         https://github.com/rtfd/readthedocs.org/issues/5368
         """
-        file_path = None
-        storage = get_storage_class(settings.RTD_BUILD_MEDIA_STORAGE)()
-
         fjson_paths = []
         basename = os.path.splitext(self.path)[0]
         fjson_paths.append(basename + '.fjson')
@@ -1252,22 +1249,23 @@ def get_processed_json_sphinx(self):
             new_basename = re.sub(r'\/index$', '', basename)
             fjson_paths.append(new_basename + '.fjson')
 
+        storage = get_storage_class(settings.RTD_BUILD_MEDIA_STORAGE)()
         storage_path = self.project.get_storage_path(
             type_='json', version_slug=self.version.slug, include_file=False
         )
-        try:
-            for fjson_path in fjson_paths:
-                file_path = storage.join(storage_path, fjson_path)
-                if storage.exists(file_path):
-                    return process_file(file_path)
-        except Exception:
-            log.warning(
-                'Unhandled exception during search processing file: %s',
-                file_path,
-            )
+        for fjson_path in fjson_paths:
+            try:
+                fjson_storage_path = storage.join(storage_path, fjson_path)
+                if storage.exists(fjson_storage_path):
+                    return process_file(fjson_storage_path)
+            except Exception:
+                log.warning(
+                    'Unhandled exception during search processing file: %s',
+                    fjson_path,
+                )
 
         return {
-            'path': file_path,
+            'path': self.path,
             'title': '',
             'sections': [],
             'domain_data': {},

From b144d494a2f6a26fa728fb949e8bd49fc24e0e27 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Tue, 12 May 2020 18:34:03 -0500
Subject: [PATCH 37/72] Replace map with generator expression

---
 readthedocs/search/parse_json.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/readthedocs/search/parse_json.py b/readthedocs/search/parse_json.py
index 3c356785da6..c71bce1549f 100644
--- a/readthedocs/search/parse_json.py
+++ b/readthedocs/search/parse_json.py
@@ -205,7 +205,7 @@ def parse_content(content, remove_first_line=False):
     if remove_first_line and len(content) > 1:
         content = content[1:]
 
-    content = map(lambda x: x.strip(), content)
+    content = (text.strip() for text in content)
     content = ' '.join(text for text in content if text)
     return content
 

From 88ad2d10968a006546a54670044dcebea14d6484 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Tue, 12 May 2020 18:36:49 -0500
Subject: [PATCH 38/72] Add comment

---
 readthedocs/search/parse_json.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/readthedocs/search/parse_json.py b/readthedocs/search/parse_json.py
index c71bce1549f..051ac19a2e8 100644
--- a/readthedocs/search/parse_json.py
+++ b/readthedocs/search/parse_json.py
@@ -199,12 +199,13 @@ def _get_text_for_domain_data(desc):
 def parse_content(content, remove_first_line=False):
     """Removes new line characters and ¶."""
     content = content.replace('¶', '').strip()
+    content = content.split('\n')
 
     # removing the starting text of each
-    content = content.split('\n')
     if remove_first_line and len(content) > 1:
         content = content[1:]
 
+    # Convert all new lines to " "
     content = (text.strip() for text in content)
     content = ' '.join(text for text in content if text)
     return content

From 774054246f5669b1b213f7b915d3ad0d9ab03880 Mon Sep 17 00:00:00 2001
From: David Fischer <david@readthedocs.org>
Date: Wed, 13 May 2020 10:22:01 -0700
Subject: [PATCH 39/72] Canonical/HTTPS redirect fix

- Only canonicalize domain when HTTPS and canonical
- On RTD for Business there was an infinite redirect issue here
  as the resolver won't use a custom domain without HTTPS.
---
 readthedocs/proxito/middleware.py            | 5 ++++-
 readthedocs/proxito/tests/test_middleware.py | 5 +++--
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/readthedocs/proxito/middleware.py b/readthedocs/proxito/middleware.py
index 5493de7f33d..d95eba84df5 100644
--- a/readthedocs/proxito/middleware.py
+++ b/readthedocs/proxito/middleware.py
@@ -56,7 +56,10 @@ def map_host_to_project_slug(request):  # pylint: disable=too-many-return-statem
             project_slug = host_parts[0]
             request.subdomain = True
             log.debug('Proxito Public Domain: host=%s', host)
-            if Domain.objects.filter(project__slug=project_slug).filter(canonical=True).exists():
+            if Domain.objects.filter(project__slug=project_slug).filter(
+                canonical=True,
+                https=True,
+            ).exists():
                 log.debug('Proxito Public Domain -> Canonical Domain Redirect: host=%s', host)
                 request.canonicalize = 'canonical-cname'
             return project_slug
diff --git a/readthedocs/proxito/tests/test_middleware.py b/readthedocs/proxito/tests/test_middleware.py
index a7296ab7bfb..a71d404cce0 100644
--- a/readthedocs/proxito/tests/test_middleware.py
+++ b/readthedocs/proxito/tests/test_middleware.py
@@ -50,7 +50,7 @@ def test_proper_cname_https_upgrade(self):
             self.assertEqual(request.canonicalize, 'https')
 
     def test_canonical_cname_redirect(self):
-        """Requests to the public domain URL should redirect to the custom domain only if the domain is canonical."""
+        """Requests to the public domain URL should redirect to the custom domain if the domain is canonical/https."""
         cname = 'docs.random.com'
         domain = get(Domain, project=self.pip, domain=cname, canonical=False, https=False)
 
@@ -59,8 +59,9 @@ def test_canonical_cname_redirect(self):
         self.assertIsNone(res)
         self.assertFalse(hasattr(request, 'canonicalize'))
 
-        # Make the domain canonical and make sure we redirect
+        # Make the domain canonical/https and make sure we redirect
         domain.canonical = True
+        domain.https = True
         domain.save()
         for url in (self.url, '/subdir/'):
             request = self.request(url, HTTP_HOST='pip.dev.readthedocs.io')

From 12e6c076f5528bab3bb50d82758053d2b00cc7d1 Mon Sep 17 00:00:00 2001
From: santos22 <santosjavier22@gmail.com>
Date: Sun, 10 May 2020 22:05:45 -0700
Subject: [PATCH 40/72] Hide unbuilt versions in footer flyout

---
 readthedocs/builds/querysets.py            |  5 +-
 readthedocs/projects/models.py             |  1 +
 readthedocs/rtd_tests/tests/test_footer.py | 59 +++++++++++++++++++++-
 3 files changed, 63 insertions(+), 2 deletions(-)

diff --git a/readthedocs/builds/querysets.py b/readthedocs/builds/querysets.py
index 79f2362b6b3..ecaadd64d0e 100644
--- a/readthedocs/builds/querysets.py
+++ b/readthedocs/builds/querysets.py
@@ -24,7 +24,8 @@ def _add_user_repos(self, queryset, user):
             queryset = user_queryset | queryset
         return queryset
 
-    def public(self, user=None, project=None, only_active=True, include_hidden=True):
+    def public(self, user=None, project=None, only_active=True,
+               include_hidden=True, only_built=False):
         queryset = self.filter(privacy_level=constants.PUBLIC)
         if user:
             queryset = self._add_user_repos(queryset, user)
@@ -32,6 +33,8 @@ def public(self, user=None, project=None, only_active=True, include_hidden=True)
             queryset = queryset.filter(project=project)
         if only_active:
             queryset = queryset.filter(active=True)
+        if only_built:
+            queryset = queryset.filter(built=True)
         if not include_hidden:
             queryset = queryset.filter(hidden=False)
         return queryset.distinct()
diff --git a/readthedocs/projects/models.py b/readthedocs/projects/models.py
index 5dd705c70b0..0006ccdd914 100644
--- a/readthedocs/projects/models.py
+++ b/readthedocs/projects/models.py
@@ -881,6 +881,7 @@ def ordered_active_versions(self, **kwargs):
             {
                 'project': self,
                 'only_active': True,
+                'only_built': True,
             },
         )
         versions = (
diff --git a/readthedocs/rtd_tests/tests/test_footer.py b/readthedocs/rtd_tests/tests/test_footer.py
index a77d4cbb1f0..568d89adeae 100644
--- a/readthedocs/rtd_tests/tests/test_footer.py
+++ b/readthedocs/rtd_tests/tests/test_footer.py
@@ -27,7 +27,7 @@ def setUp(self):
             privacy_level=PUBLIC,
             main_language_project=None,
         )
-        self.pip.versions.update(privacy_level=PUBLIC)
+        self.pip.versions.update(privacy_level=PUBLIC, built=True)
 
         self.latest = self.pip.versions.get(slug=LATEST)
         self.url = (
@@ -224,6 +224,62 @@ def test_hidden_versions(self):
         self.assertIn('/en/latest/', response.data['html'])
         self.assertNotIn('/en/2.0/', response.data['html'])
 
+    def test_built_versions(self):
+        built_version = get(
+            Version,
+            slug='2.0',
+            active=True,
+            built=True,
+            privacy_level=PUBLIC,
+            project=self.pip,
+        )
+
+        # The built versions appears on the footer
+        self.url = (
+            reverse('footer_html') +
+            f'?project={self.pip.slug}&version={self.latest.slug}&page=index&docroot=/'
+        )
+        response = self.render()
+        self.assertIn('/en/latest/', response.data['html'])
+        self.assertIn('/en/2.0/', response.data['html'])
+
+        # We can access the built version, and it appears on the footer
+        self.url = (
+            reverse('footer_html') +
+            f'?project={self.pip.slug}&version={built_version.slug}&page=index&docroot=/'
+        )
+        response = self.render()
+        self.assertIn('/en/latest/', response.data['html'])
+        self.assertIn('/en/2.0/', response.data['html'])
+
+    def test_not_built_versions(self):
+        not_built_version = get(
+            Version,
+            slug='2.0',
+            active=True,
+            built=False,
+            privacy_level=PUBLIC,
+            project=self.pip,
+        )
+
+        # The un-built version doesn't appear on the footer
+        self.url = (
+            reverse('footer_html') +
+            f'?project={self.pip.slug}&version={self.latest.slug}&page=index&docroot=/'
+        )
+        response = self.render()
+        self.assertIn('/en/latest/', response.data['html'])
+        self.assertNotIn('/en/2.0/', response.data['html'])
+
+        # We can access the unbuilt version, but it doesn't appear on the footer
+        self.url = (
+            reverse('footer_html') +
+            f'?project={self.pip.slug}&version={not_built_version.slug}&page=index&docroot=/'
+        )
+        response = self.render()
+        self.assertIn('/en/latest/', response.data['html'])
+        self.assertNotIn('/en/2.0/', response.data['html'])
+
 
 class TestFooterHTML(BaseTestFooterHTML, TestCase):
 
@@ -389,6 +445,7 @@ def test_version_queries(self):
                 identifier=identifier,
                 type=TAG,
                 active=True,
+                built=True,
             )
 
         with self.assertNumQueries(self.EXPECTED_QUERIES):

From 19960dc2cf9b1b40245e9236c76336335c8fade0 Mon Sep 17 00:00:00 2001
From: santos22 <santosjavier22@gmail.com>
Date: Sun, 10 May 2020 22:06:39 -0700
Subject: [PATCH 41/72] Fix test version class name

---
 readthedocs/api/v3/tests/test_versions.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/readthedocs/api/v3/tests/test_versions.py b/readthedocs/api/v3/tests/test_versions.py
index 3f112724a51..4ee2d95e95b 100644
--- a/readthedocs/api/v3/tests/test_versions.py
+++ b/readthedocs/api/v3/tests/test_versions.py
@@ -8,7 +8,7 @@
 from readthedocs.projects.models import Project
 
 
-class VerionsEndpointTests(APIEndpointMixin):
+class VersionsEndpointTests(APIEndpointMixin):
 
     def test_projects_versions_list(self):
         self.client.credentials(HTTP_AUTHORIZATION=f'Token {self.token.key}')

From 1fdea4b6c7327f0ab9b30370bdcc0f9369aed1f9 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Wed, 13 May 2020 16:46:13 -0500
Subject: [PATCH 42/72] Search: Little refactor

Looks like user and filter_by_user are still
needed in .com for filtering results in the dashboard (#6341).
But it can be removed from tests.
---
 readthedocs/search/api.py                       | 17 ++++++++++-------
 readthedocs/search/tests/test_faceted_search.py |  4 ++--
 readthedocs/search/tests/test_xss.py            |  2 +-
 3 files changed, 13 insertions(+), 10 deletions(-)

diff --git a/readthedocs/search/api.py b/readthedocs/search/api.py
index d6fedbf8779..4df2c5466ae 100644
--- a/readthedocs/search/api.py
+++ b/readthedocs/search/api.py
@@ -117,21 +117,24 @@ def get_queryset(self):
         # Validate all the required params are there
         self.validate_query_params()
         query = self.request.query_params.get('q', '')
-        kwargs = {'filter_by_user': False, 'filters': {}}
-        kwargs['filters']['project'] = [p.slug for p in self.get_all_projects()]
-        kwargs['filters']['version'] = self._get_version().slug
+        filters = {}
+        filters['project'] = [p.slug for p in self.get_all_projects()]
+        filters['version'] = self._get_version().slug
 
         # Check to avoid searching all projects in case these filters are empty.
-        if not kwargs['filters']['project']:
+        if not filters['project']:
             log.info("Unable to find a project to search")
             return HTMLFile.objects.none()
-        if not kwargs['filters']['version']:
+        if not filters['version']:
             log.info("Unable to find a version to search")
             return HTMLFile.objects.none()
 
-        user = self.request.user
         queryset = PageSearch(
-            query=query, user=user, **kwargs
+            query=query,
+            filters=filters,
+            user=self.request.user,
+            # We use a permission class to control authorization
+            filter_by_user=False,
         )
         return queryset
 
diff --git a/readthedocs/search/tests/test_faceted_search.py b/readthedocs/search/tests/test_faceted_search.py
index d62a6903300..79a9c43b900 100644
--- a/readthedocs/search/tests/test_faceted_search.py
+++ b/readthedocs/search/tests/test_faceted_search.py
@@ -21,7 +21,7 @@ def test_search_exact_match(self, client, project, case):
         cased_query = getattr(query_text, case)
         query = cased_query()
 
-        page_search = PageSearch(query=query, user='')
+        page_search = PageSearch(query=query)
         results = page_search.execute()
 
         assert len(results) == 1
@@ -37,7 +37,7 @@ def test_search_combined_result(self, client, project):
         - Where `Foo` or `Bar` is present
         """
         query = 'Elasticsearch Query'
-        page_search = PageSearch(query=query, user='')
+        page_search = PageSearch(query=query)
         results = page_search.execute()
         assert len(results) == 3
 
diff --git a/readthedocs/search/tests/test_xss.py b/readthedocs/search/tests/test_xss.py
index 31353061e0d..e2ca97d9b80 100644
--- a/readthedocs/search/tests/test_xss.py
+++ b/readthedocs/search/tests/test_xss.py
@@ -9,7 +9,7 @@ class TestXSS:
 
     def test_facted_page_xss(self, client, project):
         query = 'XSS'
-        page_search = PageSearch(query=query, user='')
+        page_search = PageSearch(query=query)
         results = page_search.execute()
         expected = """
         &lt;h3&gt;<span>XSS</span> exploit&lt;&#x2F;h3&gt;

From 6b9fb1a009025f93c006260c7607edfb5e405b9e Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Wed, 13 May 2020 18:05:34 -0500
Subject: [PATCH 43/72] Add tests

---
 readthedocs/search/api.py                     |  15 ++-
 readthedocs/search/tests/conftest.py          |   8 +-
 .../search/tests/data/docs/guides/index.json  |  13 +++
 readthedocs/search/tests/data/docs/index.json |  13 +++
 readthedocs/search/tests/dummy_data.py        |   2 +-
 readthedocs/search/tests/test_api.py          | 105 +++++++++++++++++-
 6 files changed, 147 insertions(+), 9 deletions(-)
 create mode 100644 readthedocs/search/tests/data/docs/guides/index.json
 create mode 100644 readthedocs/search/tests/data/docs/index.json

diff --git a/readthedocs/search/api.py b/readthedocs/search/api.py
index ffb2a054607..cdf6fc14448 100644
--- a/readthedocs/search/api.py
+++ b/readthedocs/search/api.py
@@ -45,8 +45,10 @@ def get_link(self, obj):
         # Generate an appropriate link for the doctypes that use htmldir,
         # and always end it with / so it goes directly to proxito.
         if doctype in {SPHINX_HTMLDIR, MKDOCS}:
-            new_path = re.sub('(^|/)index.html$', '', path)
-            path = path.rstrip('/') + '/'
+            new_path = re.sub('(^|/)index.html$', '/', path)
+            # docs_url already ends with /,
+            # make sure to not include it twice.
+            path = new_path.lstrip('/')
 
         return docs_url + path
 
@@ -221,17 +223,18 @@ def get_all_projects_data(self):
         """
         all_projects = self.get_all_projects()
         version_slug = self._get_version().slug
-        projects_url = {}
+        project_urls = {}
         for project in all_projects:
-            projects_url[project.slug] = project.get_docs_url(version_slug=version_slug)
+            project_urls[project.slug] = project.get_docs_url(version_slug=version_slug)
 
         versions_doctype = (
             Version.objects
-            .filter(project__slug__in=projects_url.keys(), slug=version_slug)
+            .filter(project__slug__in=project_urls.keys(), slug=version_slug)
             .values_list('project__slug', 'documentation_type')
         )
+
         projects_data = {
-            project_slug: (projects_url[project_slug], doctype)
+            project_slug: (project_urls[project_slug], doctype)
             for project_slug, doctype in versions_doctype
         }
         return projects_data
diff --git a/readthedocs/search/tests/conftest.py b/readthedocs/search/tests/conftest.py
index 1705118b380..ff8caeda745 100644
--- a/readthedocs/search/tests/conftest.py
+++ b/readthedocs/search/tests/conftest.py
@@ -41,7 +41,13 @@ def all_projects(es_index, mock_processed_json, db, settings):
             # file_basename in config are without extension so add html extension
             file_name = file_basename + '.html'
             version = project.versions.all()[0]
-            html_file = G(HTMLFile, project=project, version=version, name=file_name)
+            html_file = G(
+                HTMLFile,
+                project=project,
+                version=version,
+                name=file_name,
+                path=file_name,
+            )
 
             # creating sphinx domain test objects
             file_path = get_json_file_path(project.slug, file_basename)
diff --git a/readthedocs/search/tests/data/docs/guides/index.json b/readthedocs/search/tests/data/docs/guides/index.json
new file mode 100644
index 00000000000..baffc4d0f7e
--- /dev/null
+++ b/readthedocs/search/tests/data/docs/guides/index.json
@@ -0,0 +1,13 @@
+{
+    "path": "guides/index",
+    "title": "Guides",
+    "sections": [
+        {
+            "id": "guides",
+            "title": "Guides",
+            "content": "Content from guides"
+        }
+    ],
+    "domains": [],
+    "domain_data": {}
+}
diff --git a/readthedocs/search/tests/data/docs/index.json b/readthedocs/search/tests/data/docs/index.json
new file mode 100644
index 00000000000..c85846aa5bb
--- /dev/null
+++ b/readthedocs/search/tests/data/docs/index.json
@@ -0,0 +1,13 @@
+{
+    "path": "index",
+    "title": "Index",
+    "sections": [
+        {
+            "id": "title",
+            "title": "Title",
+            "content": "Some content from index"
+        }
+    ],
+    "domains": [],
+    "domain_data": {}
+}
diff --git a/readthedocs/search/tests/dummy_data.py b/readthedocs/search/tests/dummy_data.py
index 8c1cc9e5951..3b998c17474 100644
--- a/readthedocs/search/tests/dummy_data.py
+++ b/readthedocs/search/tests/dummy_data.py
@@ -1,7 +1,7 @@
 PROJECT_DATA_FILES = {
     'pipeline': ['installation', 'signals'],
     'kuma': ['documentation', 'docker'],
-    'docs': ['support', 'wiping'],
+    'docs': ['support', 'wiping', 'index', 'guides/index'],
 }
 
 ALL_PROJECTS = PROJECT_DATA_FILES.keys()
diff --git a/readthedocs/search/tests/test_api.py b/readthedocs/search/tests/test_api.py
index 72d9b403edc..94dc37eeb6b 100644
--- a/readthedocs/search/tests/test_api.py
+++ b/readthedocs/search/tests/test_api.py
@@ -6,7 +6,14 @@
 from django_dynamic_fixture import G
 
 from readthedocs.builds.models import Version
-from readthedocs.projects.constants import PUBLIC
+from readthedocs.projects.constants import (
+    MKDOCS,
+    MKDOCS_HTML,
+    PUBLIC,
+    SPHINX,
+    SPHINX_HTMLDIR,
+    SPHINX_SINGLEHTML,
+)
 from readthedocs.projects.models import HTMLFile, Project
 from readthedocs.search.api import PageSearchAPIView
 from readthedocs.search.documents import PageDocument
@@ -324,6 +331,102 @@ def test_doc_search_hidden_versions(self, api_client, all_projects):
         first_result = data[0]
         assert first_result['project'] == subproject.slug
 
+    @pytest.mark.parametrize('doctype', [SPHINX, SPHINX_SINGLEHTML, MKDOCS_HTML])
+    def test_search_correct_link_html_projects(self, api_client, doctype):
+        project = Project.objects.get(slug='docs')
+        project.versions.update(documentation_type=doctype)
+        version = project.versions.all().first()
+
+        # Check for a normal page.
+        search_params = {
+            'project': project.slug,
+            'version': version.slug,
+            'q': 'Support',
+        }
+        resp = self.get_search(api_client, search_params)
+        assert resp.status_code == 200
+
+        result = resp.data['results'][0]
+
+        assert result['project'] == project.slug
+        assert result['link'].endswith('en/latest/support.html')
+
+        # Check the main index page.
+        search_params = {
+            'project': project.slug,
+            'version': version.slug,
+            'q': 'Some content from index',
+        }
+        resp = self.get_search(api_client, search_params)
+        assert resp.status_code == 200
+
+        result = resp.data['results'][0]
+
+        assert result['project'] == project.slug
+        assert result['link'].endswith('en/latest/index.html')
+
+        # Check the index page of a subdirectory.
+        search_params = {
+            'project': project.slug,
+            'version': version.slug,
+            'q': 'Some content from guides/index',
+        }
+        resp = self.get_search(api_client, search_params)
+        assert resp.status_code == 200
+
+        result = resp.data['results'][0]
+
+        assert result['project'] == project.slug
+        assert result['link'].endswith('en/latest/guides/index.html')
+
+    @pytest.mark.parametrize('doctype', [SPHINX_HTMLDIR, MKDOCS])
+    def test_search_correct_link_htmldir_projects(self, api_client, doctype):
+        project = Project.objects.get(slug='docs')
+        project.versions.update(documentation_type=doctype)
+        version = project.versions.all().first()
+
+        # Check for a normal page.
+        search_params = {
+            'project': project.slug,
+            'version': version.slug,
+            'q': 'Support',
+        }
+        resp = self.get_search(api_client, search_params)
+        assert resp.status_code == 200
+
+        result = resp.data['results'][0]
+
+        assert result['project'] == project.slug
+        assert result['link'].endswith('en/latest/support.html')
+
+        # Check the main index page.
+        search_params = {
+            'project': project.slug,
+            'version': version.slug,
+            'q': 'Some content from index',
+        }
+        resp = self.get_search(api_client, search_params)
+        assert resp.status_code == 200
+
+        result = resp.data['results'][0]
+
+        assert result['project'] == project.slug
+        assert result['link'].endswith('en/latest/')
+
+        # Check the index page of a subdirectory.
+        search_params = {
+            'project': project.slug,
+            'version': version.slug,
+            'q': 'Some content from guides/index',
+        }
+        resp = self.get_search(api_client, search_params)
+        assert resp.status_code == 200
+
+        result = resp.data['results'][0]
+
+        assert result['project'] == project.slug
+        assert result['link'].endswith('en/latest/guides/')
+
 
 class TestDocumentSearch(BaseTestDocumentSearch):
 

From 1f01d2c7d79323e54e3c5c168eab6e2796dc6d89 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Wed, 13 May 2020 18:09:27 -0500
Subject: [PATCH 44/72] Update data

---
 readthedocs/search/tests/data/docs/guides/index.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/readthedocs/search/tests/data/docs/guides/index.json b/readthedocs/search/tests/data/docs/guides/index.json
index baffc4d0f7e..5ca9b20764a 100644
--- a/readthedocs/search/tests/data/docs/guides/index.json
+++ b/readthedocs/search/tests/data/docs/guides/index.json
@@ -5,7 +5,7 @@
         {
             "id": "guides",
             "title": "Guides",
-            "content": "Content from guides"
+            "content": "Content from guides/index"
         }
     ],
     "domains": [],

From dca39bca49d6d7bbfcf03a2be161eb5bf3e50dd8 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Thu, 14 May 2020 10:28:17 -0500
Subject: [PATCH 45/72] Suggestions from review

---
 readthedocs/search/api.py            |  2 +-
 readthedocs/search/tests/conftest.py |  8 +++---
 readthedocs/search/tests/test_api.py | 40 ++++++++++++++++++----------
 3 files changed, 31 insertions(+), 19 deletions(-)

diff --git a/readthedocs/search/api.py b/readthedocs/search/api.py
index cdf6fc14448..fdcf40761e1 100644
--- a/readthedocs/search/api.py
+++ b/readthedocs/search/api.py
@@ -47,7 +47,7 @@ def get_link(self, obj):
         if doctype in {SPHINX_HTMLDIR, MKDOCS}:
             new_path = re.sub('(^|/)index.html$', '/', path)
             # docs_url already ends with /,
-            # make sure to not include it twice.
+            # so path doesn't need to start with /.
             path = new_path.lstrip('/')
 
         return docs_url + path
diff --git a/readthedocs/search/tests/conftest.py b/readthedocs/search/tests/conftest.py
index ff8caeda745..97bba15dc45 100644
--- a/readthedocs/search/tests/conftest.py
+++ b/readthedocs/search/tests/conftest.py
@@ -4,7 +4,7 @@
 
 import pytest
 from django.core.management import call_command
-from django_dynamic_fixture import G
+from django_dynamic_fixture import get
 
 from readthedocs.projects.constants import PUBLIC
 from readthedocs.projects.models import HTMLFile, Project
@@ -28,7 +28,7 @@ def all_projects(es_index, mock_processed_json, db, settings):
     settings.ELASTICSEARCH_DSL_AUTOSYNC = True
     projects_list = []
     for project_slug in ALL_PROJECTS:
-        project = G(
+        project = get(
             Project,
             slug=project_slug,
             name=project_slug,
@@ -41,7 +41,7 @@ def all_projects(es_index, mock_processed_json, db, settings):
             # file_basename in config are without extension so add html extension
             file_name = file_basename + '.html'
             version = project.versions.all()[0]
-            html_file = G(
+            html_file = get(
                 HTMLFile,
                 project=project,
                 version=version,
@@ -60,7 +60,7 @@ def all_projects(es_index, mock_processed_json, db, settings):
                         domain_role_name = domain_data.pop('role_name')
                         domain, type_ = domain_role_name.split(':')
 
-                        G(
+                        get(
                             SphinxDomain,
                             project=project,
                             version=version,
diff --git a/readthedocs/search/tests/test_api.py b/readthedocs/search/tests/test_api.py
index 94dc37eeb6b..73025856f37 100644
--- a/readthedocs/search/tests/test_api.py
+++ b/readthedocs/search/tests/test_api.py
@@ -332,12 +332,11 @@ def test_doc_search_hidden_versions(self, api_client, all_projects):
         assert first_result['project'] == subproject.slug
 
     @pytest.mark.parametrize('doctype', [SPHINX, SPHINX_SINGLEHTML, MKDOCS_HTML])
-    def test_search_correct_link_html_projects(self, api_client, doctype):
+    def test_search_correct_link_for_normal_page_html_projects(self, api_client, doctype):
         project = Project.objects.get(slug='docs')
         project.versions.update(documentation_type=doctype)
         version = project.versions.all().first()
 
-        # Check for a normal page.
         search_params = {
             'project': project.slug,
             'version': version.slug,
@@ -347,11 +346,15 @@ def test_search_correct_link_html_projects(self, api_client, doctype):
         assert resp.status_code == 200
 
         result = resp.data['results'][0]
-
         assert result['project'] == project.slug
         assert result['link'].endswith('en/latest/support.html')
 
-        # Check the main index page.
+    @pytest.mark.parametrize('doctype', [SPHINX, SPHINX_SINGLEHTML, MKDOCS_HTML])
+    def test_search_correct_link_for_index_page_html_projects(self, api_client, doctype):
+        project = Project.objects.get(slug='docs')
+        project.versions.update(documentation_type=doctype)
+        version = project.versions.all().first()
+
         search_params = {
             'project': project.slug,
             'version': version.slug,
@@ -361,11 +364,15 @@ def test_search_correct_link_html_projects(self, api_client, doctype):
         assert resp.status_code == 200
 
         result = resp.data['results'][0]
-
         assert result['project'] == project.slug
         assert result['link'].endswith('en/latest/index.html')
 
-        # Check the index page of a subdirectory.
+    @pytest.mark.parametrize('doctype', [SPHINX, SPHINX_SINGLEHTML, MKDOCS_HTML])
+    def test_search_correct_link_for_index_page_subdirectory_html_projects(self, api_client, doctype):
+        project = Project.objects.get(slug='docs')
+        project.versions.update(documentation_type=doctype)
+        version = project.versions.all().first()
+
         search_params = {
             'project': project.slug,
             'version': version.slug,
@@ -375,17 +382,15 @@ def test_search_correct_link_html_projects(self, api_client, doctype):
         assert resp.status_code == 200
 
         result = resp.data['results'][0]
-
         assert result['project'] == project.slug
         assert result['link'].endswith('en/latest/guides/index.html')
 
     @pytest.mark.parametrize('doctype', [SPHINX_HTMLDIR, MKDOCS])
-    def test_search_correct_link_htmldir_projects(self, api_client, doctype):
+    def test_search_correct_link_for_normal_page_htmldir_projects(self, api_client, doctype):
         project = Project.objects.get(slug='docs')
         project.versions.update(documentation_type=doctype)
         version = project.versions.all().first()
 
-        # Check for a normal page.
         search_params = {
             'project': project.slug,
             'version': version.slug,
@@ -395,11 +400,15 @@ def test_search_correct_link_htmldir_projects(self, api_client, doctype):
         assert resp.status_code == 200
 
         result = resp.data['results'][0]
-
         assert result['project'] == project.slug
         assert result['link'].endswith('en/latest/support.html')
 
-        # Check the main index page.
+    @pytest.mark.parametrize('doctype', [SPHINX_HTMLDIR, MKDOCS])
+    def test_search_correct_link_for_index_page_htmldir_projects(self, api_client, doctype):
+        project = Project.objects.get(slug='docs')
+        project.versions.update(documentation_type=doctype)
+        version = project.versions.all().first()
+
         search_params = {
             'project': project.slug,
             'version': version.slug,
@@ -409,11 +418,15 @@ def test_search_correct_link_htmldir_projects(self, api_client, doctype):
         assert resp.status_code == 200
 
         result = resp.data['results'][0]
-
         assert result['project'] == project.slug
         assert result['link'].endswith('en/latest/')
 
-        # Check the index page of a subdirectory.
+    @pytest.mark.parametrize('doctype', [SPHINX_HTMLDIR, MKDOCS])
+    def test_search_correct_link_for_index_page_subdirectory_htmldir_projects(self, api_client, doctype):
+        project = Project.objects.get(slug='docs')
+        project.versions.update(documentation_type=doctype)
+        version = project.versions.all().first()
+
         search_params = {
             'project': project.slug,
             'version': version.slug,
@@ -423,7 +436,6 @@ def test_search_correct_link_htmldir_projects(self, api_client, doctype):
         assert resp.status_code == 200
 
         result = resp.data['results'][0]
-
         assert result['project'] == project.slug
         assert result['link'].endswith('en/latest/guides/')
 

From 2237fbfffbc0dbfe870c3300adab4ab03f80be42 Mon Sep 17 00:00:00 2001
From: Manuel Kaufmann <humitos@gmail.com>
Date: Thu, 14 May 2020 19:28:25 +0200
Subject: [PATCH 46/72] Proxy /api/v2/embed/ URL to be used on custom domains

---
 readthedocs/api/v2/proxied_urls.py | 6 ++++++
 readthedocs/proxito/urls.py        | 1 +
 2 files changed, 7 insertions(+)

diff --git a/readthedocs/api/v2/proxied_urls.py b/readthedocs/api/v2/proxied_urls.py
index 4a01e23a581..5ec02bb73fd 100644
--- a/readthedocs/api/v2/proxied_urls.py
+++ b/readthedocs/api/v2/proxied_urls.py
@@ -5,6 +5,7 @@
 so they can make use of features that require to have access to their cookies.
 """
 
+from django.conf import settings
 from django.conf.urls import include, url
 
 from .views.proxied import ProxiedFooterHTML
@@ -16,3 +17,8 @@
 ]
 
 urlpatterns = api_footer_urls
+
+if 'readthedocsext.embed' in settings.INSTALLED_APPS:
+    urlpatterns += [
+        url(r'embed/', include('readthedocsext.embed.urls'))
+    ]
diff --git a/readthedocs/proxito/urls.py b/readthedocs/proxito/urls.py
index 413731268d5..e657edc0e7b 100644
--- a/readthedocs/proxito/urls.py
+++ b/readthedocs/proxito/urls.py
@@ -82,6 +82,7 @@
     ),
 
     # Serve proxied API
+    # /_/api/v2/
     url(
         r'^{DOC_PATH_PREFIX}api/v2/'.format(
             DOC_PATH_PREFIX=DOC_PATH_PREFIX,

From e7fdce15918beb4736681233b9c6454acd137d9c Mon Sep 17 00:00:00 2001
From: Manuel Kaufmann <humitos@gmail.com>
Date: Thu, 14 May 2020 19:28:50 +0200
Subject: [PATCH 47/72] Small logging string fix

---
 readthedocs/core/unresolver.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/readthedocs/core/unresolver.py b/readthedocs/core/unresolver.py
index e2b35502001..cc848586f68 100644
--- a/readthedocs/core/unresolver.py
+++ b/readthedocs/core/unresolver.py
@@ -56,8 +56,8 @@ def unresolve(self, url):
         )
 
         log.info(
-            'Unresolver parsed:'
-            'url=%s, project=%s lang_slug=%s version_slug=%s filename=%s',
+            'Unresolver parsed: '
+            'url=%s project=%s lang_slug=%s version_slug=%s filename=%s',
             url, final_project.slug, lang_slug, version_slug, filename
         )
         return UnresolvedObject(final_project, lang_slug, version_slug, filename, parsed.fragment)

From 20b5412f0063f5a47d450fa671416e4615bc118e Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Thu, 14 May 2020 12:43:06 -0500
Subject: [PATCH 48/72] Search: track total results

Closes https://github.com/readthedocs/readthedocs.org/issues/7047
---
 readthedocs/projects/views/private.py          |  6 +++---
 .../migrations/0002_add_total_results_field.py | 18 ++++++++++++++++++
 readthedocs/search/models.py                   |  6 ++++++
 readthedocs/search/tasks.py                    | 16 ++++++++--------
 4 files changed, 35 insertions(+), 11 deletions(-)
 create mode 100644 readthedocs/search/migrations/0002_add_total_results_field.py

diff --git a/readthedocs/projects/views/private.py b/readthedocs/projects/views/private.py
index 34e59e30c7f..54dfd3f40b1 100644
--- a/readthedocs/projects/views/private.py
+++ b/readthedocs/projects/views/private.py
@@ -1040,7 +1040,7 @@ def _search_analytics_csv_data(self):
                 created__date__lte=now,
             )
             .order_by('-created')
-            .values_list('created', 'query')
+            .values_list('created', 'query', 'total_results')
         )
 
         file_name = '{project_slug}_from_{start}_to_{end}.csv'.format(
@@ -1052,8 +1052,8 @@ def _search_analytics_csv_data(self):
         file_name = '-'.join([text for text in file_name.split() if text])
 
         csv_data = (
-            [timezone.datetime.strftime(time, '%Y-%m-%d %H:%M:%S'), query]
-            for time, query in data
+            [timezone.datetime.strftime(time, '%Y-%m-%d %H:%M:%S'), query, total_results]
+            for time, query, total_results in data
         )
         pseudo_buffer = Echo()
         writer = csv.writer(pseudo_buffer)
diff --git a/readthedocs/search/migrations/0002_add_total_results_field.py b/readthedocs/search/migrations/0002_add_total_results_field.py
new file mode 100644
index 00000000000..12704622569
--- /dev/null
+++ b/readthedocs/search/migrations/0002_add_total_results_field.py
@@ -0,0 +1,18 @@
+# Generated by Django 2.2.12 on 2020-05-14 17:29
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('search', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='searchquery',
+            name='total_results',
+            field=models.IntegerField(default=0, null=True, verbose_name='Total results'),
+        ),
+    ]
diff --git a/readthedocs/search/models.py b/readthedocs/search/models.py
index 53fedecaf96..33efb613dbf 100644
--- a/readthedocs/search/models.py
+++ b/readthedocs/search/models.py
@@ -32,6 +32,12 @@ class SearchQuery(TimeStampedModel):
         _('Query'),
         max_length=4092,
     )
+    total_results = models.IntegerField(
+        _('Total results'),
+        default=0,
+        # TODO: to avoid downtime, remove later.
+        null=True,
+    )
     objects = RelatedProjectQuerySet.as_manager()
 
     class Meta:
diff --git a/readthedocs/search/tasks.py b/readthedocs/search/tasks.py
index 98687f33fff..c5432110c7e 100644
--- a/readthedocs/search/tasks.py
+++ b/readthedocs/search/tasks.py
@@ -144,7 +144,7 @@ def delete_old_search_queries_from_db():
 
 @app.task(queue='web')
 def record_search_query(project_slug, version_slug, query, total_results, time_string):
-    """Record/update search query in database."""
+    """Record/update a search query for analytics."""
     if not project_slug or not version_slug or not query:
         log.debug(
             'Not recording the search query. Passed arguments: '
@@ -162,11 +162,12 @@ def record_search_query(project_slug, version_slug, query, total_results, time_s
         modified__gte=before_10_sec,
     ).order_by('-modified')
 
-    # check if partial query exists,
-    # if yes, then just update the object.
+    # If a partial query exists,
+    # then just update that object.
     for partial_query in partial_query_qs.iterator():
         if query.startswith(partial_query.query):
             partial_query.query = query
+            partial_query.total_results = total_results
             partial_query.save()
             return
 
@@ -190,9 +191,9 @@ def record_search_query(project_slug, version_slug, query, total_results, time_s
         )
         return
 
-    version_qs = Version.objects.filter(project=project, slug=version_slug)
+    version = Version.objects.filter(project=project, slug=version_slug).first()
 
-    if not version_qs.exists():
+    if not version:
         log.debug(
             'Not recording the search query because version does not exist. '
             'project_slug: %s, version_slug: %s' % (
@@ -201,11 +202,10 @@ def record_search_query(project_slug, version_slug, query, total_results, time_s
         )
         return
 
-    version = version_qs.first()
-
-    # make a new SearchQuery object.
+    # Create a new SearchQuery object.
     SearchQuery.objects.create(
         project=project,
         version=version,
         query=query,
+        total_results=total_results,
     )

From c8b9f09a9a09c9c9994515ef8ceb4bcd06b14ea9 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Thu, 14 May 2020 13:40:21 -0500
Subject: [PATCH 49/72] Show number of results in the UI

---
 readthedocs/projects/views/private.py                         | 2 +-
 readthedocs/templates/projects/projects_search_analytics.html | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/readthedocs/projects/views/private.py b/readthedocs/projects/views/private.py
index 54dfd3f40b1..c27d0ec7cae 100644
--- a/readthedocs/projects/views/private.py
+++ b/readthedocs/projects/views/private.py
@@ -1013,7 +1013,7 @@ def get_context_data(self, **kwargs):
                 qs.values('query')
                 .annotate(count=Count('id'))
                 .order_by('-count', 'query')
-                .values_list('query', 'count')
+                .values_list('query', 'count', 'total_results')
             )
 
             # only show top 100 queries
diff --git a/readthedocs/templates/projects/projects_search_analytics.html b/readthedocs/templates/projects/projects_search_analytics.html
index 93fa412f4ad..335d0fb971e 100644
--- a/readthedocs/templates/projects/projects_search_analytics.html
+++ b/readthedocs/templates/projects/projects_search_analytics.html
@@ -16,9 +16,10 @@ <h3>{% trans "Top queries" %}</h3>
   <div class="module-list">
     <div class="module-list-wrapper">
       <ul class="long-list-overflow">
-        {% for query, count in queries %}
+        {% for query, count, total_results in queries %}
           <li class="module-item">
             {{ query }}
+            ({{ total_results }} result{{ total_results|pluralize:"s" }})
             <span class="right quiet">
               {{ count }} search{{ count|pluralize:"es" }}
             </span>

From 1782380abc107f4148b09dfb7fb7c6ff3d6549e2 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Thu, 14 May 2020 14:01:35 -0500
Subject: [PATCH 50/72] Update tests

---
 readthedocs/rtd_tests/tests/test_views.py | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/readthedocs/rtd_tests/tests/test_views.py b/readthedocs/rtd_tests/tests/test_views.py
index 188147866c3..f9fbb5e8159 100644
--- a/readthedocs/rtd_tests/tests/test_views.py
+++ b/readthedocs/rtd_tests/tests/test_views.py
@@ -286,15 +286,15 @@ def test_top_queries(self):
             test_time.return_value = self.test_time
 
             expected_result = [
-                ('hello world', 5),
-                ('documentation', 4),
-                ('read the docs', 4),
-                ('advertising', 3),
-                ('elasticsearch', 2),
-                ('sphinx', 2),
-                ('github', 1),
-                ('hello', 1),
-                ('search', 1),
+                ('hello world', 5, 0),
+                ('documentation', 4, 0),
+                ('read the docs', 4, 0),
+                ('advertising', 3, 0),
+                ('elasticsearch', 2, 0),
+                ('sphinx', 2, 0),
+                ('github', 1, 0),
+                ('hello', 1, 0),
+                ('search', 1, 0),
             ]
 
             resp = self.client.get(self.analyics_page)

From c36b39707c35ff300444313e2fe224cfc9f3bf08 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Thu, 14 May 2020 15:49:54 -0500
Subject: [PATCH 51/72] Search: record queries with 0 results

Now that we are saving the number of results,
this is useful to see what content is missing from the docs.
---
 readthedocs/search/tasks.py | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/readthedocs/search/tasks.py b/readthedocs/search/tasks.py
index c5432110c7e..cd82f8fe25e 100644
--- a/readthedocs/search/tasks.py
+++ b/readthedocs/search/tasks.py
@@ -171,16 +171,6 @@ def record_search_query(project_slug, version_slug, query, total_results, time_s
             partial_query.save()
             return
 
-    # don't record query with zero results.
-    if not total_results:
-        log.debug(
-            'Not recording search query because of zero results. Passed arguments: '
-            'project_slug: %s, version_slug: %s, query: %s, total_results: %s, time: %s' % (
-                project_slug, version_slug, query, total_results, time
-            )
-        )
-        return
-
     project = Project.objects.filter(slug=project_slug).first()
     if not project:
         log.debug(

From 1f8ad94b29f921858d3b730dd5c1338f935ce4b2 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Thu, 14 May 2020 16:16:20 -0500
Subject: [PATCH 52/72] Update tests

---
 readthedocs/search/tests/test_search_tasks.py | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/readthedocs/search/tests/test_search_tasks.py b/readthedocs/search/tests/test_search_tasks.py
index 92501dfd367..8cc9c9cb757 100644
--- a/readthedocs/search/tests/test_search_tasks.py
+++ b/readthedocs/search/tests/test_search_tasks.py
@@ -87,8 +87,8 @@ def test_partial_queries_are_not_recorded(self, api_client):
             SearchQuery.objects.all().first().query == 'stack overflow'
         ), 'one SearchQuery should be there because partial queries gets updated'
 
-    def test_search_query_not_recorded_when_results_are_zero(self, api_client):
-        """Test that search queries are not recorded when they have zero results."""
+    def test_search_query_recorded_when_results_are_zero(self, api_client):
+        """Test that search queries are recorded when they have zero results."""
 
         assert (
             SearchQuery.objects.all().count() == 0
@@ -102,10 +102,8 @@ def test_search_query_not_recorded_when_results_are_zero(self, api_client):
         }
         resp = api_client.get(self.url, search_params)
 
-        assert (resp.data['count'] == 0)
-        assert (
-            SearchQuery.objects.all().count() == 0
-        ), 'there should be 0 obj since there were no results.'
+        assert resp.data['count'] == 0
+        assert SearchQuery.objects.all().count() == 1
 
     def test_delete_old_search_queries_from_db(self, project):
         """Test that the old search queries are being deleted."""

From 33181893a5410f58c19654aa1dcbcfaf5985dec8 Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Thu, 14 May 2020 15:13:48 -0700
Subject: [PATCH 53/72] Fix headers

---
 docs/choosing-a-site.rst    | 12 +++++++-----
 readthedocs/api/v2/utils.py |  3 ++-
 2 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/docs/choosing-a-site.rst b/docs/choosing-a-site.rst
index 5376e27939b..67ca8713ae2 100644
--- a/docs/choosing-a-site.rst
+++ b/docs/choosing-a-site.rst
@@ -8,8 +8,8 @@ which should help you choose which is a better fit for your organization.
 The features available on both platforms are the same.
 The primary difference is the audience and use cases that are supported.
 
-|org_brand|
---------------------
+Read the Docs Community
+-----------------------
 
 |org_brand| is meant for open source projects to use for documentation hosting.
 This is great for user and developer documentation for your project.
@@ -22,8 +22,10 @@ Important points:
 * Less build time and fewer build resources (memory & CPU)
 * Documentation is organized by projects
 
-|com_brand|
--------------------
+You can sign up for an account at https://readthedocs.org.
+
+Read the Docs for Business
+--------------------------
 
 |com_brand| is meant for companies and users who have private documentation.
 It works well for product documentation as well as internal docs for your developers.
@@ -36,10 +38,10 @@ Important points:
 * More build time and more build resources (memory & CPU)
 * Documentation is organized by organization, giving more control over permissions
 
+You can sign up for an account at https://readthedocs.com.
 
 Questions?
 ----------
 
 If you have a question about which platform would be best,
 you can email us at support@readthedocs.org.
-
diff --git a/readthedocs/api/v2/utils.py b/readthedocs/api/v2/utils.py
index a9fcffea6d8..e9f216cec44 100644
--- a/readthedocs/api/v2/utils.py
+++ b/readthedocs/api/v2/utils.py
@@ -153,7 +153,8 @@ def delete_versions(project, version_data):
 
     if to_delete_qs.count():
         ret_val = {obj.slug for obj in to_delete_qs}
-        log.info('(Sync Versions) Deleted Versions: [%s]', ' '.join(ret_val))
+        log.info('(Sync Versions) Deleted Versions: project=%s, versions=[%s]',
+                 project.slug, ' '.join(ret_val))
         to_delete_qs.delete()
         return ret_val
     return set()

From 57fd9c61e4d3dfd156885b27c7ed7668a04a10dd Mon Sep 17 00:00:00 2001
From: Eric Holscher <25510+ericholscher@users.noreply.github.com>
Date: Thu, 14 May 2020 15:14:08 -0700
Subject: [PATCH 54/72] Update docs/index.rst

Co-authored-by: David Fischer <david@readthedocs.org>
---
 docs/index.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/index.rst b/docs/index.rst
index c8057acc7df..9cd46b86cbf 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -44,7 +44,7 @@ to help you create fantastic documentation for your project.
 * **Getting started**:
   :doc:`With Sphinx </intro/getting-started-with-sphinx>` |
   :doc:`With MkDocs </intro/getting-started-with-mkdocs>` |
-  :doc:`Feature Overview </features>`
+  :doc:`Feature Overview </features>` |
   :doc:`/choosing-a-site`
 
 * **Importing your existing documentation**:

From fe65e51a2a1d768cb8e128246f6b3a13db978b23 Mon Sep 17 00:00:00 2001
From: David Fischer <david@readthedocs.org>
Date: Thu, 14 May 2020 15:38:55 -0700
Subject: [PATCH 55/72] Document HSTS support

---
 docs/custom_domains.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/custom_domains.rst b/docs/custom_domains.rst
index 07966961632..42d075fd824 100644
--- a/docs/custom_domains.rst
+++ b/docs/custom_domains.rst
@@ -99,6 +99,19 @@ You can also host your documentation from your own domain.
 
          .. _Amazon CAA guide: https://docs.aws.amazon.com/acm/latest/userguide/setup-caa.html
 
+Strict Transport Security
++++++++++++++++++++++++++
+
+By default, we do not return a `Strict Transport Security header`_ (HSTS) for user custom domains.
+This is a conscious decision as it can be misconfigured in a not easily reversible way.
+For both |org_brand| and |com_brand|, HSTS for custom domains can be set upon request.
+
+We always return the HSTS header with a max-age of at least one year
+for our own domains including ``*.readthedocs.io``, ``*.readthedocs-hosted.com``, ``readthedocs.org`` and ``readthedocs.com``.
+
+.. _Strict Transport Security header: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security
+
+
 Proxy SSL
 ---------
 

From 7d973319eb4528fb1fa4eb7d96abcce3f2f16dc6 Mon Sep 17 00:00:00 2001
From: Manuel Kaufmann <humitos@gmail.com>
Date: Mon, 18 May 2020 17:25:22 +0200
Subject: [PATCH 56/72] Guide for Embed API

Document two different use cases for the Embed API.
---
 docs/guides/embedding-content.rst     |  96 ++++++++++++++++++++++++++
 docs/img/sphinx-hoverxref-example.png | Bin 0 -> 64483 bytes
 2 files changed, 96 insertions(+)
 create mode 100644 docs/guides/embedding-content.rst
 create mode 100644 docs/img/sphinx-hoverxref-example.png

diff --git a/docs/guides/embedding-content.rst b/docs/guides/embedding-content.rst
new file mode 100644
index 00000000000..7f4a2386532
--- /dev/null
+++ b/docs/guides/embedding-content.rst
@@ -0,0 +1,96 @@
+Embedding Content In Your Documentation
+=======================================
+
+
+Read the Docs allow you to embed content from any of the projects we host.
+This allows to re-use the content across sites, making sure the content is always up to date.
+
+There are many uses of our Embed API we can think about.
+However, we are sure there are even more and that's why we are exposing it publicly,
+so you can build your own idea on top of it.
+
+These guide will show you two of our favorites ones:
+
+* inline help on application website
+* contextualized tooltips on documentation pages
+
+
+Inline help on application website
+----------------------------------
+
+This allows us to keep the official documentation as the single source of truth,
+while having great inline help in our application website as well:
+on a "Automation Rules" admin page we could embed the content of our :doc:`automation-rules` documentation
+page and be sure it will be always up to date.
+
+.. note::
+
+   We recommend you point at tagged releases instead of latest.
+   Tags don't change over time, so you don't have to worry about the content you are embedding disappearing.
+
+
+The following example will fetch the section "Creating an automation rule" in page ``automation-rules.html``
+from our own docs and will populate the content of it into the ``#help-container`` div element.
+
+.. code-block:: html
+
+    <script type="text/javascript">
+    var params = {
+      'project': 'docs',
+      'version': 'stable',
+      'doc': 'automation-rules',
+      'section': 'creating-an-automation-rule',
+    };
+    var url = 'https://readthedocs.org/api/v2/embed/?' + $.param(params);
+    $.get(url, function(data) {
+      $('#help-container').content(data['content']);
+    });
+    </script>
+
+    <div id="help-container"></div>
+
+
+You can modify this example to subscribe to ``.onclick`` Javascript event,
+and show a modal when the user clicks in a "Help" link.
+
+
+Contextualized tooltips on documentation pages
+----------------------------------------------
+
+Tooltips on your own documentation are really useful to add more context to the current page the user is reading.
+For example, embed terms definitions, Python functions or classes definitions, configurations of your application,
+or the content of any other reference.
+
+We built a Sphinx extension called ``sphinx-hoverxref`` on top of our Embed API
+that authors can just install in their project and get the most of it without the need of coding anything.
+
+Here is an example showing a tooltip when you hover with the mouse a reference:
+
+.. figure:: sphinx-hoverxref-example.png
+
+   Tooltip shown when hovering on a reference using ``sphinx-hoverxref``.
+
+You can find more information about this extension, how to install and configure it in `its own documentation here`_.
+
+.. _its own documentation here: https://sphinx-hoverxref.readthedocs.io/en/latest/
+
+
+Calling the Embed API
+---------------------
+
+
+Embed API lives under ``https://readthedocs.org/api/v2/embed/`` URL and accept two different ways of using it:
+by passing the exact URL of the section you want to embed or sending all the attributes in a separate way.
+
+The following links return exactly the same response, however the first one pass the ``url`` attribute
+and the second example sends ``project``, ``version``, ``doc``, ``section`` and ``path`` as different attributes.
+You can use the one that works best for your use case.
+
+* https://readthedocs.org/api/v2/embed/?url=https://docs.readthedocs.io/en/latest/features.html%23automatic-documentation-deployment
+* https://readthedocs.org/api/v2/embed/?project=docs&version=latest&doc=features&section=automatic-documentation-deployment&path=features.html
+
+You can click on these links and check the response directly in the browser.
+
+.. note::
+
+   All relative links to pages contained in the remote content will continue to point at the remote page.
diff --git a/docs/img/sphinx-hoverxref-example.png b/docs/img/sphinx-hoverxref-example.png
new file mode 100644
index 0000000000000000000000000000000000000000..4394c44cf62b8af8fa9903db5bf9556091bdb06a
GIT binary patch
literal 64483
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

literal 0
HcmV?d00001


From e552f8ccc9c0300e46f28697f34bdeaa0fcfeff7 Mon Sep 17 00:00:00 2001
From: Manuel Kaufmann <humitos@gmail.com>
Date: Mon, 18 May 2020 17:38:23 +0200
Subject: [PATCH 57/72] Image path fixed

---
 .../images/guides}/sphinx-hoverxref-example.png     | Bin
 docs/guides/embedding-content.rst                   |   4 ++--
 2 files changed, 2 insertions(+), 2 deletions(-)
 rename docs/{img => _static/images/guides}/sphinx-hoverxref-example.png (100%)

diff --git a/docs/img/sphinx-hoverxref-example.png b/docs/_static/images/guides/sphinx-hoverxref-example.png
similarity index 100%
rename from docs/img/sphinx-hoverxref-example.png
rename to docs/_static/images/guides/sphinx-hoverxref-example.png
diff --git a/docs/guides/embedding-content.rst b/docs/guides/embedding-content.rst
index 7f4a2386532..a8e21ec4fb4 100644
--- a/docs/guides/embedding-content.rst
+++ b/docs/guides/embedding-content.rst
@@ -66,13 +66,13 @@ that authors can just install in their project and get the most of it without th
 
 Here is an example showing a tooltip when you hover with the mouse a reference:
 
-.. figure:: sphinx-hoverxref-example.png
+.. figure:: /_static/images/guides/sphinx-hoverxref-example.png
 
    Tooltip shown when hovering on a reference using ``sphinx-hoverxref``.
 
 You can find more information about this extension, how to install and configure it in `its own documentation here`_.
 
-.. _its own documentation here: https://sphinx-hoverxref.readthedocs.io/en/latest/
+.. _its own documentation here: https://sphinx-hoverxref.readthedocs.io/
 
 
 Calling the Embed API

From b3d9578c77d999d88548af111af98dcd948d0e53 Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Mon, 18 May 2020 10:08:32 -0700
Subject: [PATCH 58/72] Update embed guide a bit

---
 docs/guides/embedding-content.rst | 82 +++++++++++++++----------------
 1 file changed, 41 insertions(+), 41 deletions(-)

diff --git a/docs/guides/embedding-content.rst b/docs/guides/embedding-content.rst
index a8e21ec4fb4..3c21c16d396 100644
--- a/docs/guides/embedding-content.rst
+++ b/docs/guides/embedding-content.rst
@@ -1,26 +1,49 @@
-Embedding Content In Your Documentation
-=======================================
+Embedding Content From Your Documentation
+=========================================
 
+Read the Docs allows you to embed content from any of the projects we host.
+This allows reuse of content across sites, making sure the content is always up to date.
 
-Read the Docs allow you to embed content from any of the projects we host.
-This allows to re-use the content across sites, making sure the content is always up to date.
+There are a number of uses cases for embedding content,
+so we've built our integration in a way that enables users to build on top of it.
+This guide will show you some of our favorite integrations:
 
-There are many uses of our Embed API we can think about.
-However, we are sure there are even more and that's why we are exposing it publicly,
-so you can build your own idea on top of it.
+.. contents::
+   :local:
 
-These guide will show you two of our favorites ones:
 
-* inline help on application website
-* contextualized tooltips on documentation pages
+Contextualized tooltips on documentation pages
+----------------------------------------------
+
+Tooltips on your own documentation are really useful to add more context to the current page the user is reading.
+You can embed any content that is available via reference in Sphinx, including:
+
+* Python object references
+* Full documentation pages
+* Sphinx references
+* Term definitions
+
+We built a Sphinx extension called ``sphinx-hoverxref`` on top of our Embed API
+you can install in your project with minimal configuration.
+
+Here is an example showing a tooltip when you hover with the mouse a reference:
+
+.. figure:: /_static/images/guides/sphinx-hoverxref-example.png
+   :width: 60%
+
+   Tooltip shown when hovering on a reference using ``sphinx-hoverxref``.
+
+You can find more information about this extension, how to install and configure it in the `hoverxref documentation`_.
+
+.. _hoverxref documentation: https://sphinx-hoverxref.readthedocs.io/
 
 
 Inline help on application website
 ----------------------------------
 
 This allows us to keep the official documentation as the single source of truth,
-while having great inline help in our application website as well:
-on a "Automation Rules" admin page we could embed the content of our :doc:`automation-rules` documentation
+while having great inline help in our application website as well.
+On the "Automation Rules" admin page we could embed the content of our :doc:`automation-rules` documentation
 page and be sure it will be always up to date.
 
 .. note::
@@ -28,7 +51,6 @@ page and be sure it will be always up to date.
    We recommend you point at tagged releases instead of latest.
    Tags don't change over time, so you don't have to worry about the content you are embedding disappearing.
 
-
 The following example will fetch the section "Creating an automation rule" in page ``automation-rules.html``
 from our own docs and will populate the content of it into the ``#help-container`` div element.
 
@@ -49,40 +71,18 @@ from our own docs and will populate the content of it into the ``#help-container
 
     <div id="help-container"></div>
 
-
 You can modify this example to subscribe to ``.onclick`` Javascript event,
 and show a modal when the user clicks in a "Help" link.
 
-
-Contextualized tooltips on documentation pages
-----------------------------------------------
-
-Tooltips on your own documentation are really useful to add more context to the current page the user is reading.
-For example, embed terms definitions, Python functions or classes definitions, configurations of your application,
-or the content of any other reference.
-
-We built a Sphinx extension called ``sphinx-hoverxref`` on top of our Embed API
-that authors can just install in their project and get the most of it without the need of coding anything.
-
-Here is an example showing a tooltip when you hover with the mouse a reference:
-
-.. figure:: /_static/images/guides/sphinx-hoverxref-example.png
-
-   Tooltip shown when hovering on a reference using ``sphinx-hoverxref``.
-
-You can find more information about this extension, how to install and configure it in `its own documentation here`_.
-
-.. _its own documentation here: https://sphinx-hoverxref.readthedocs.io/
-
-
-Calling the Embed API
----------------------
-
+Calling the Embed API directly
+------------------------------
 
 Embed API lives under ``https://readthedocs.org/api/v2/embed/`` URL and accept two different ways of using it:
-by passing the exact URL of the section you want to embed or sending all the attributes in a separate way.
 
-The following links return exactly the same response, however the first one pass the ``url`` attribute
+* passing the exact URL of the section you want to embed
+* sending all the attributes required as GET arguments
+
+The following links return exactly the same response, however the first one passes the ``url`` attribute
 and the second example sends ``project``, ``version``, ``doc``, ``section`` and ``path`` as different attributes.
 You can use the one that works best for your use case.
 

From 1840e23fa449176f3f20ad14caf1ee7a64a926f9 Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Mon, 18 May 2020 10:14:53 -0700
Subject: [PATCH 59/72] Fix a few small things

---
 docs/guides/embedding-content.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/docs/guides/embedding-content.rst b/docs/guides/embedding-content.rst
index 3c21c16d396..b05798defe9 100644
--- a/docs/guides/embedding-content.rst
+++ b/docs/guides/embedding-content.rst
@@ -11,7 +11,6 @@ This guide will show you some of our favorite integrations:
 .. contents::
    :local:
 
-
 Contextualized tooltips on documentation pages
 ----------------------------------------------
 
@@ -29,7 +28,7 @@ you can install in your project with minimal configuration.
 Here is an example showing a tooltip when you hover with the mouse a reference:
 
 .. figure:: /_static/images/guides/sphinx-hoverxref-example.png
-   :width: 60%
+   :width: 80%
 
    Tooltip shown when hovering on a reference using ``sphinx-hoverxref``.
 
@@ -37,13 +36,12 @@ You can find more information about this extension, how to install and configure
 
 .. _hoverxref documentation: https://sphinx-hoverxref.readthedocs.io/
 
-
 Inline help on application website
 ----------------------------------
 
 This allows us to keep the official documentation as the single source of truth,
 while having great inline help in our application website as well.
-On the "Automation Rules" admin page we could embed the content of our :doc:`automation-rules` documentation
+On the "Automation Rules" admin page we could embed the content of our :doc:`/automation-rules` documentation
 page and be sure it will be always up to date.
 
 .. note::

From b75c140254119c98bee87d10a0fb346558789506 Mon Sep 17 00:00:00 2001
From: Manuel Kaufmann <humitos@gmail.com>
Date: Mon, 18 May 2020 19:51:42 +0200
Subject: [PATCH 60/72] Change example image and center it

---
 .../guides/sphinx-hoverxref-example.png       | Bin 64483 -> 141239 bytes
 docs/guides/embedding-content.rst             |   1 +
 2 files changed, 1 insertion(+)

diff --git a/docs/_static/images/guides/sphinx-hoverxref-example.png b/docs/_static/images/guides/sphinx-hoverxref-example.png
index 4394c44cf62b8af8fa9903db5bf9556091bdb06a..fb9a90511db63194d34be017a2b8edd314f2077e 100644
GIT binary patch
literal 141239
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
I$b#bk1sJ~L`v3p{

literal 64483
zcmd4&WmuJK*fszX5+W@P(kYEdNP_~>C4wL!-Q6v%ARw)TqzXt#cY~CqbP3Yk4Rf*I
z_xpa#%)goAnBj+eZCLAhp8LM9IOAI3DoQd~7-Sd-2nbluWuK}cARu)hARv~bBf)Q6
zG;(ke5D4WxHME@74Be>h9qmjltWBt$J?u@WP24R^5fI!bQ$JZaE>$@O-xv|<A?3Ce
zQ(%Up?=<zCxP8lWbi0`NTdbir(<A>@9NP?m@KWshD%fu^|AVMxx#*-d`~C~FRFAzk
zZRwo#vzNxcmn#G2dnYg79b8=b1P?b1JI~uuSzma>@6ScuT#Nni!_@Gb5!q_=+r4n7
zydha#sVG@Rty4N06F(SxuOV>BxjntST5>&hakPQDGls8IIVoK^VA~^@@Uh;UjdO0M
zyT5;-^E9=4K1JjFq{g?iQT6bBt(z%<U*BpiFEQ=oSkY6TOC9ku!m~ySPBJYjT((HU
z>*}~9Khe{xYh|8pcnYPCouXaEBKzV?lj7r|M+c1zjF)!FX9-7%;$!C<FRm~4)YUNj
zQfIx~>Q?4RUH(W1ROk~Pd+n`_dBj<;&qc4T2zk3*dBom$k7-@k@y)LJm^61NU-aCh
zx<sVkAU8Uj4`2kgZuFn@m$ddToD?Zv_bwGx{^^sO*Xv-pB6qvGX>7eYYCHKL88<R;
z<m1y<_jBmuFmYDqjX)$@_5l;ql5*J1*^9=7;+>R2>l<BiOU1pHhdn1hRIL6i-dobo
zua%a6QXPOU!epwFG$@N{$U<)w@#$6WjHjH)n3`pU@PX1x9}`W_G>e>A$3+{P>aiH<
z<HLob_=xnwo9pZJ2H(Dw71~1O#)KlPvVp5%+M6v}CAQ1V0I!8SHTA3*{*$Q3D|QVQ
z-jC|K4(J-(EWR9|95Wqbc(dv5xz>+$khi`(NWR>9v9n%(KE3VG|M|ykYR@Yh<<IO9
zwVI?R`g!3b^?%gnI8!S_PDmxb$LugKF1vc2kdlrme|IWe=OwtS(EmA9&wIAsbgI7Z
zQNAcr?@*PVI++>Mi}k8djF*W!=1*5#r^b4Il+RdH#0EQVb8Nj<`kmt5@z}~|iC+eZ
zquc(&4^bVTg9!A3+{Zq|pMUrHu#48QZWS-;1}l*{B`p8(F-3~|ZQ;B=aY?=-Dp^l!
z5!Lo1ZDy{|z{TQ^nwL|1ZR?hi&SRY)o_RSJ+fJnXo>?D0&mO02l(jZG==Hz<+_u=B
zB=g{aosq9o!SDs`>16(r%8!e)i4~<v2Z|7ZQum2Sr}N#)u=ARN)zpt0X=@+Kls9|!
z1IF|=8*EMF%=&pOTHT%(FQhDIr7Q=VUC=6;J^RX)c_h1baxO=u`McXAq|I@x%4@}4
zuWVFU-L}BMlQev_S2rb|*QX34&|T>I+&EK%7)yPb@r_}5yW+Y+C}yCmuQZF<@m98f
zafDPfyUjw`fdxZ<sitYnS1y_BcrUvdqFnAGxq@fWu~TXC4>8Wn46lEa{EHI6n{PnN
zk(GGaeZoFF)cO^#QfYK_Ual!HxTD;4R+F()!%b+5M<iW6Y&uONFA9alx{&GdQt@aF
z>N71n?7o87t@oK0p$gVwdyXz|I`*>vxhd+DFZbodx(c|cB}`Av?<q+$#hbF9Dn>@f
zFYwPT+D0B?F|_Wa$`$+(u8-#yP{TeCBX!^6KhHcTmZ#>vbFt|fxu7R>p0Tnr^{;@$
zT&B4p<(&7UL<vI{&t;$EToM|(gnEkioQ+kbL9f~1#6$K>JuhMYsN8p}{^Nb^)7x6J
zoXv8b-5W+kY6JJ0+|wAJ3WiSo8hFzCvoD9%EpsT1-DJSjmVB2x>x4OBJZTddr%CwB
z(h&hMI@U<}fMQc~ytAXc5h98|VvYX?s;4r$e-b?Q+Y#_pdS!<<1S^n2Y|wZuF@0D)
zTuwC|3sJeg^ysS!_QtJI)!0#xEPW3}4A#~|+4+VcJ^s03oN|9U_2+)gcm2kO@D^Hi
zkz|s#u;rRn+~rQY=<B1=;PyMeIM*#GsRotok)%3fCmlF*G*{zLs$A|6Ss=t?)zR!G
z%Bpl$*X!MRIgP3E0F4oG$ZovFL9C!yLXR3{f;#2jJA#3`8kg)jGgx>Dp8ez=>~{9(
zk@EFSl21`d(VI+PTZSR+uT1OY+M~JorK_OW`v;)6)v>=5ENUr5&BmG<<#<tsuKY!t
zg|n~cTyU2^$-XHCHJ8Jbl6+nYISO@MEsfX1`3=L_z0ti29eN?d0-c3m6%r2o2Xb?-
zMB9i@Q>Qd(HHt=-75r!Y&$OKKvhW}L`xQWdpO5i1@cY`w{F*tD@CdvhUfHQH%zwE*
zY4p)VBR{YC=JJtwy!(ryQb@=?7O@6uvGAivU6z3CJ4nP6eSf#R(M+WZD(0)CD()I=
zsu*sXP52b`d3d?AjPbk982Pgo>#~+sda3Zg*fRJP+dck*cAW2H&=YTy!Fij{PjVU}
z6fkiG1yEh~S<J(jG6piX-%V8UGBDsY>O0>#Mat{lb|%72KH<@@pBZ5&e=j;&+CPzW
zPC-p8j`nymE9YAw`s&068nfs#0g0sp+bKo)BpdNha(BP^(2vrV<bM9JUv84R%yO0c
z=*7<KeM|k1QdDl9xUw!e%#u}iKYX&hK(P4M#Am|dN<)uhVt)Ju374t-_bDE=I2&^f
zah2^-0=5MKFWy0J`4Hy(^rq}bwTf>k9rn~F+h!`63x6B5b?KuXB<MS|m|@l@akxbE
z_Hy3;XK<|g@+~z=`A)*)hM~;2=t(uZgG0vTuTaFiH+x^{hIH<4p%Zog;KAkp_g*$S
z7*z*Bvr<$;S||Qu-CzB#)wjpebe1a_TdUZJN}&(Zi=SXJPUn;{nngQ|qu8K_eHmBD
z7hn7?ve>c{#L}!O`83M&Ye>_&u5#$Tj(a#0FRZh#!@|j_h7uK0Df{DSgm>IytUkHD
z>qjsmGbdfL`uUwXQM*&ta9}9xnYhpJS?h;?$~)q{xr&JTaY4QTs~Qam1f-Ky=h5Zc
zY=#7y;^%+4l)m(ZsIOI{vr@A7yWb78E>n-2LlRdX`jRK8|Gu?7=9<o0TB2fb-=A8j
zbd%S+`JTA)fIDNfyvb8;%_{RIG$nLCpFrzZI8`%yM@)C|*(3!#>nS9<Cu1a5`6Hx^
z%9vBqn4LA>T8dKz`s5|*>`Of#jO(>4QYuDsVwksUP=1We>K=SWlh=H2z@!L;D7T`T
zl>T0-wY>~$t|5z!c<l%O28Fys;tXekN9$jnK4vJ@5|}DKNoJX#=eJr#O@2Ebs?{X_
z3y*C5uo8J!e201**TRTJ(D{yBc^4OM_cIbM_4k!3=HJnjSn>$I=KV|6{-H&qfk^sV
zX)RNJuw{&em}k>0^W?8u73TMkDiZjz=INDpAGw8JW!8~P-W$N)ZKc$8E8+NzeJ84r
zo-B0^w@VM}ZmZ)Q0)J#8`S&Czo`=DkEt&450x?7xH`))?N{3RNneXuGmD1(e9h&N`
zzIux!(-J>FtNJWbvALX2yuV!nXIfN_PBTxNo}2m^?q%km1IyhJKF(e897G46=Q1~>
zPhzCsCC*Byl^H)!m&&-iJ0LA@ijfn<wjEUSz#Cgr;njQ8ptMIrubxEn{SrW6euO2n
z$Zgl;w;;fwzWO=Y;3>jxsKR)#ccb?c_b**Ji1=6nUNnPmuGypsrv%kH-MA*DgTK+T
zleATspQlP#3+jh5BcfpvP44_)?+y8;`s3#i34{Lbr1U~?hhu_E#NGJ!xhQ!tpFh_7
zJ6cV!xW`r?4Gn6WWBZ3Gt+(JX21qhxo<0uBHx%7yxwo>Ft{WN}%4R9e#!&2SqI<uJ
z{me<ewZNZX!z}$?--AIqx~7++G-0fE#TdWJ8J35&zhPJtK7L*`5QRY1%z5^-d&9+Q
zvY1XrVEwbWtT6+(X547#R;+=6Tg}%QV!oNz3%Dt5hmH>)?G1GqwVXYzy{Gk1pb^i2
zj+sZf_<@%T4tu~B1*d#0r6-|hhveHQ)h^57pZl=Ycy=`y(q^M`A7zb?#&xY3sKwMZ
zN&0AE?n=_BWH8`zE>JVNQLj>CyU~OpkFX0OzbEtwn(bcYC5sEOCJ_Isr}`*tJup%d
zv5JjPGy1$!-H=wLV1VpgRPKPrWd`k$rPk9sjA~vsdG`~wN--wwsl!f{LSo`xPBo)x
zaZd~>(gpZeZ4jqcA$;YsF*;6MMzf()!v7*JfmD2_+)3;y%RTBRWUoFOE6F&t@y+6;
zhbf77dm7{(F6NJQVS0vs)S;)nkLZ4YF@WNr@${=Mk7RNAhlmcG2=W{uiF>7_WsigB
zZ9{3j6<eYurvfn;_0X*?S(q@ea}>2t{S`VZi^Q3XJQd1=mBi0p-qmBS!8j;G)XO$|
zG-I%?g{zo{oYFQ^{&9Xb)Je6>|9SQwQ5^(AjyHs<ICaI$HXm{4`-=rP=07B+A^LT-
z=gjk<yd8Ep!zEa48zObIkGju;OHJuHPn?2Utl31M6SkT)&Rx=rS2S5Hd|$1e*hj|p
z5m(?Jl^J~p@gx*eiHVl;Q}feUEi0`E(F$i3TH0k=sx(h!ffGBcXhwDMe|2=b@4l}c
z{i=RSEF<^EAS=eA$=#Xl$iX<+RgPMljqa|44ca^|_1#?~y`brwaw*%p(RsZubsPx0
zk_^l^f;xM)zL_*7hOlVa%H$w9<5Cs(O*(o6yY>WOy9He%KVGwb`rwVBkL&<FpZ`ME
zRW>G))V<X-#jY>>51&MDnCopdQVZ~-XwM_kx^byT(#lw7oulo>*>6VXN=%5<7|HV+
z)eahmdu1I6888$QkS<<SBfm(R!m$(gHc1+I-?SYbVjD|Ve$AC7C5=*jM0x!n9FvJ_
zCzmjSH2Q#9qWB$B%Tl3I=6AxaX2fSrg>Rf#OS+Ykd*rgYV^Zy1oN-Cc-{7747Q4mz
zQajP;b=Jx;vVJ-EX|iSA^tUdEy5vitZM%J&!|M?K9);4kctkVLl@}A<^GV~s{oKyI
zj)01r<Gdj0t+9Yj@pt3f$KU365$U_ms1Ke^OFEzrcOl<MlyHgI1yg2Xg+H-heM1l+
zciQHOViHaMjgj}UpajpC^s5kE`$!F)*LckVPk5IQH8x+FoV$jxg#IjV{5!c$y+=@O
zRfHQN#fSSz4apbV`fF#Is?6QRf8Qb^zK=;^RmJinlgM$Zl4`M^?zapg<F@w)n*2j{
zBmH*#EYkr;r!a=LU5AN@;R`3`^S_o}v*r9duWNawMB^}|F7y#Z0-m^aMsp%@tMWNd
z2K91{2pRF=ItZ)_7W`z4yQ)78mz5hpbgsbN+3Y`{8&>K4`v=P$c?+kuw9G7Q&2#=T
zz_0(|fN`7*gSyuJRpcM;swFQ_w;9d}hmo;S1vw{)vr%25tI!_&dCvFZ-6cv29eURj
z!_zx@Uy_8lA82HZ614wKdVAI)CuzK_5;~1>UY+}nK2x5>@at(=jwF7V`Id?zy|Her
z{f`afORr(|V3G<xa;9~Hjd#Y}uRMMnVbCF2J8KRSWf&tE^HA*Pqm9mqtCPlSFPs}=
zwZ7cZdh%0E_Uf%@6HirY@0$_ZZ0#>pDz!|gNPN}We=6`~Gw+B#B-_F(j%-87zfegt
zpZ#3M^xjh55k0b$!5y8@7UAJ@YMncT)E%TRY;nRLhF~TAV+zj;rl|{7c%LSXpl@pP
zE0hD{&PBB3gPgZh2Eii_F>+c4R77k>km-l-OLAn8@MJEHbju##?$O;v6#I!;MrAIa
zB}|6=La1bK$g@iMpQMCu2u%^HjZuFms`KEox{z7){wm*}iOvJV9Q6nFXC%8)bn;r&
zm^2l4bnZ7Py2~FaiD_E@i7{yLqg$&zltjT=$i~9yMfi|$#Eqq@tW};Eu@ukS9}w-w
zp&0WIH<jKfm>^^j;|Ym`LeWc+k*l%LMah+BtI5>VT65$zj9?aBn>O9^a6VIm0b5<<
zzv@V+-t6z*mcD5*ZaQWrc&b2WrDYd~+Gg6|Rjqxc^pR0%$5LobkzOD+{eBj+n`arC
zV$i@#aXjte9YT(p6=@q&o*FY7$Kg>~>Ukw)s?HFlvRYKqj)%<U$q(Bw(|IyZ8HbmI
zzId3oW0n~fgzM&HYd1;Aa8}F6UdmZX;32d{i^{L#35Qa$Vv02O2=pV|Xfl&-gk)q9
zHcd#o;T`90NrkX)JR7x32}_L%WbVuoV?lVcJ4K>hH;ZX9D5fTGCn)U)V?glv(=_Ty
z*6mn33eHV(b(2BQasOpME$te%v3ny!{)ooU(6AH`orwcX^5R+Xm<dgW%Pj0rEd06F
z<aJ(=K1weWJGAWiXj;rqK^&1Q*+VTJM&l%LK7UFn|5iHY;?#+ZgYL49&88%)if_CF
zpAv)ACULIm-<|dBJO;zWpZsBUiv1P}Z_9L^;idGnBrC9d^scg}@H7)diQSWZhA%JU
z@#+;GX7BWqLEbJ=#Ay6_nipu4;+7~hy0fFcYpNZ1Uz(ULCDzrH%ifyVWR>!Ir_7v{
z29Gq#<W82v_9LEsr5CtsK*YmSjMDzTg@QLB?Qr?Nie;QMhgNQ+@zZh|*QMHYB5ejo
z@+SWvq?1$8L(P|3;%MjOh7L=Msc-A3o_`zthC@wwKkUkXiV>x5iL|`WC;}VlLAbKl
zK09)-oQ`eh@e)N6qMV@w0tv=I5m{Flp;^Fn)}rI<<g|<{jc0j!-o$k>q&ZF-dAkft
z0R`IhvB4Ee8|vn3G?^^MEWhPD9B7_-wMnyZY}w6oG@th6QHcs}AU+FvFQu%yNv)IM
z$46_bN?7b!t^18I-czMJ8*2rf7r}nqK8dgYxlqe*Pcr;Ayj2XXVML1&A0`s&Wz`Y`
zO9WH7Pb?If?@HFc-Eek3pE18TYZ3YzJyfmz{afw##v6F_AMMShWR(9k;dEE1HZq&h
zYy8*`(=<SpdiL}auJ6MUl>y|B%mXr0bLej$3edmUj-dG+BEk6t`6Ke&z!`NT4gY`)
za(Fk_Xf_5?_QW75E*eT;62f>meU5!j`uv+IEdo>7qcsPbEa?%qvEO{tj?X$LZP4=#
z{1RMI^ERRgqDP<S5+Y_?&4z@gc&4BVa`V`}J>&CrtsnhH#apv$j<U&%J>ahp+crmV
zlFOP|Ryr@^ABA9mUZbHCx&D0axz}v2@6rdJ{pMgFDL>VtvgfgSWA_IGC_R!8LjD9Y
zsTLedT`(zR2osq~VpLJg-E%lWaC{~bBAv^5brr*i$UTGE=u-UXMMT%off^fe!Y7?Q
zp022<{k{DklX~~gg&1rG4Lrk{CPPQlW&B8^Ll(r7U8y~}ksgPj$9!3xY{@C>A4wn@
z-+v{J(KRk(6G=3VBVainm_dSzsd6eEPqU2e%|tV+G&RX9^Mm$V*}ZV2tXxv`+B@XJ
z*N8?=-&M-)*?4~29ckviWFql?T*X-TR|3>kWGBhz8tCZgQ-77`5fG>mo<Eh)aG%^v
z^$;GJB0udX>EfuB(~x7ysb?Ny$apsMGmiEduT7zsy4+`#MCLKF2?l<P48`}j6LNB@
z_&*;fSP!<b`TBV`H1=Ehc0_P1&TL<a>@<pQIHfuLJ`he{ar%AMi)+qHb}Q^6Ae{2u
z`EvJvUb#}|{P)5iM_dl^zgJZLasTr!Q3Mv0|9<0*pmr+}!{-pP3I2Prizv(T--~(V
zXi$yerwQ%<*B5HONoTb)H60xu4z$^su6DXQKQaIT8y<~ZIF}$4hl+!ldEP!CK0dy_
z{z_TT!@|Ns_<z<uuQTtkASEFYAWMHe#Y%Pmz7%at6Z-8(=coQU#J!no@L^<R96!*K
zm+$H5KoujTpwNBs;>hm%O&A{C|9ztmd$51gjkG{^PEL7Q+3q3+2F6Y1|88YN)6G(H
zXB3qg7s*rFk{>_%T3V3A3iI>jX=C_or^BcQ$Hv^;++@(}y-qj;1<%^w6Q`!8IyyR%
zk&%s#jxKga$)LZkac1G+!LQYmm$%v&{h_L=N=Qg3DJhxM)ZN|v>({SJySaDo-jR`$
z+f7wq^|)+qZmzGd7n8$v;PEd`_l%yT7JmP}wz?X2*G$IC%gfr@T2D_;MkX{OqBrx|
zdutmTnMg8}<^PU;bKXymhM76c4z62PUQQDv{ej|pUfx4`dS1hpp!IdjAlw+)xR@9T
zbP@O6`NOs0(=B73WCcbs-^<gH@9L#y{R#2$gv7)<+uPFU^?o<AfBwYF<<JIsdU@H+
zH7GL1>eqYz85;}5UEkP{my^RMAegRkVU;xRP2!G>jC6kTfQA4c|LyBQ+=mYz=6(By
zj)nC?MTJD;Mmb${Yo@mH`}ez3HWn7o<>gs9IIuA=K1N3)yuS@ze~G`XJ8H(Jrer)Z
z(b4`7664}7FLoM<IrSoNGY8G@5p%?S{HXTwW#?~CcXtDM?k7S*c#=ayLk$fLu%Fo2
z*yBgz^Fc8&gGU=<?QLzik|H7^Qx!I~?t2S%jaMOeSvWZOczNrb*FIKO@>l5cK7L%@
z*hoe5Z)wS8b%17*2M-TVOsw(r^pucQ(}1C)y}cw~$=;qTLAgM`aki(YXJmwcW@KQ%
z{%qfbi}*Ia3_4G)zOy0)*ze9uym;~ANviMuzpnh3MY&(U(gnc@5pn2-y?*4h+?y)o
zwmnnpcDy+OTau8Fpr)pVPBV%^nk5~{!_WUxLqoUPF{hw_&DFj?O=N$6{~i%rlBmxU
z$#41j8^d3f-PguDy5m_PE~TR=>+R-5VYxvnnwms`%?2;3N=py+7CX^1EQWKpAaVY-
z1pog1dtqS#J)@;X@_!!`jfzp!v_GxyvOP32llDLx4=?6ElhWpFeQkBMAU*vZ8eYHa
z%f8S2i^K|P!XB5Wd(WOdb8v7-7xOdaBB`&hN2ei+?8s1IVPRo&Y3iWImHhbe<G8e&
zTV+ZL#X-BfEe*t$%lgQ|!W)d>p^*_@&%;&3H*@t~p?3?uedBucs1^H7<Ldykhqt?i
zP}~w4Cn+aq*%3iX!2!$AE4O^1riNc(WoH-V$Nm;K@B4QLH#er(uGWVH{rFl@^UpiJ
z%qMq#5pxV?pA<(QG%rIG?E8{M_TR+}cKtj|&CHmBCGqaxZzX;N*>b%8C;t@X`uf_e
zKaCI{zs0pbMKEybeqmwZ`T05IoTjGcj~_qgzPGqD2Cz0ogoUA3lo)q?ggg!O`R|&E
zyMFA?#KoJI`##^lf4^kr!-o&BTZczSu>J=^t`XwYbv_q-)YJ$<JqBE}4L<L2$%I@B
zVqzd_aRZy@g_oL<PZ5yg<=8nnWzg}$pE58ojI#b287Yp0ZR<}LTkI_1l=+{hN88CF
zIK7lKGc&WWVDY86xx}YwGvHE66P}o!W@Bbv-QE^;S=X?#+6W2?Iy^jNQO_;VE|nG+
z7k~At=Esjn1x7Oy6BcG>dL||}XJ>=`HRmTWvc_B_TH04vSD2{CpLv^0?_3)8*91U8
zb+NEmD>3TK&B-xTCqG!}@04aKR#w}?5)>4)vDvDttJ~h*4n)Iw_3G8T_wOMnr>h)V
zdwQ%E+QJREZ=aTn`Oa*}owsk_+RimZ-i#x&E-x?V=H~ic?x9uWscLA%J*6cjCl?YD
zYV<t9prNOx=5pJfR{yF5vGiApY}|pHo7*}_TtcGx&!3}TF?0kNC_+#HC`n1H;h>h6
zO*g~B!enJ-!x9r;nwT)S2FcRfPF3^`4e<yGO|`Zn)6g?B|I$@7H2mAt)O7bgBj)Kr
zsmH-`s;JL7<Osw(m6$JuN|xehJ{zc^Y^b-7j2hgj`Ywt}%<&f!7nHBPBKijJv$rDI
zJ>A{Kbg(}<l7>b`bj-}|H`iCAqneP!OiW*4C*tA=Hb14MQ3|Jvqr14dsed0iK6brC
z50*6KK&N^7b-2U<JEh!e?D+Ut)bsFLQIWEgRBLlHRM)%cG^T>5g#`uH_V)H~-n>y#
zQj(W{UtGM~7JmQe=%|G1+wEf^7^t9o>sRd__(!Q}>F7*NOh}j^!>^l8q~^tR`LXj^
z|9jUw=govFhM(UJl#h8U*~h%RNXW<;jkmROUT81<LC)#n+WiANJtz#~|NHsH#=3<6
znt(r5ho1-g{~!P{%>V!E_y1peA_;S(`9?Y9>NWkmGcAT^tD*=9*DipDE)!Krg_iZd
zI@w6kIa44Y+(^48pMDu$3$f<n=9WO$*3k(K3M!tJ%^Iw*oAccq=bm*IaobJ-bkUga
zb8&G2ng3m5J^CdN3FdMSH1p8{ZFLQeLy<B|E2~GmyuH7FQ|@<v`b36<gTu<oYGkzd
z@87?j8Qmhide8GimWGYR#l_WCbiHm7=;0wDAyJefWZRML?d_W>=kv{h#yk@P16=(4
zCrkw`{L+NJd#i(V5JSIzD~+n-P>B}g=U@2lqXosp#l=CzDbTAwAJg~S+S$38C9JHh
z6m#3A*x-8vRjkr>rp0Y|co+){tG2e*55H(_eH{Y}tGuKHvP}@mFb?a9Ooz8EGbiU9
zG<N7B$Vf=;L@hnc!T$dKQBgRBPo161va+&ZC9dxd>Yvg&{Ia^1FRQ4Ke)jB#PNi*I
z7+y*dCJqi0F8b+x4JbUava9Jf`A{mvu1}5557z*O$jQmk($db=wjCZiJ2>n?QeNE{
z(TLrRWmIfQJ%=hfF)?vkn4SGkx$sh%^2Hk?qv!NPRSt{3;@Z!jKTqU%?da;7CgN2Q
z6m%y*{FL<77kKOF4;|K*g_nXtzj}J|b8?nW=KLVP>#C|wVMS)|&zO`_lAgHa!J;D~
zF#9FlpR=IfX-N@uD&A^n5Dkj1si{dw7##?{ixCnUdQ+BmBLZ2vvJYUZyDOGyvG&P-
zKQ{&YOG`@+9z3AOf3CWRrnogWHm02V<cMi!__`<#JAKioNbY=%7q5Ov?E)Kn!&T06
zeI@8##CHD>no@*r_DQUU95gOB%T1BHbI;IYy8fkC2>I@Rlgt|QHQs<LudS_-l8{_#
zL^k=5T<&>aotIZt-IkhZ;g-`LWx@lfl{z{)iJbb^k%QM>KXMGXNTBNiwAFa{LPy67
zz(8hZCOQp%IIr)e`^%Rvg9f1J6uzznRGFKXXK7-Rlb_%7kX}^u8a7$uq09DkH7^;K
z*s}~3_#CB(=g7>=kG#AZsE5J#h~IoYzqlv@qyf+xY8_N%h+B2_;hscJ85x<mYA3YX
z5CulN*}940VW+{&XYlah;o$(QR{GQJ?CkjY_$o?D?qXnc_w?K+Bz#?N`6q#0r?}SB
z)3c?u70yN>YcN+S^<7k-^=zF-YY3K!iAi;JHJx-s(*`*OMarj7?{Ht$dp?%@1xWx9
zK}<}Ho4e%aPsfpOs#c=~@XFHCk~T&b(gpe@G9xjBN#}<L?{O`ytue8%*jZQ%xkw(F
z_EN{l0*FGVQSk8cx&TZV-DPZIvII#ouh^^r1swWzt=kUdP4O8^3WUM@{QS_68r<sa
zU`0qkAcE}iLmnO;7M8m-#x^#Q`Ydd0-UrKy*e|4S+*Xgyk2bcpw&41(!&?1N-a~?e
zmzI~0kB$^mpZsZVMzj)%$jxPxk?Dj40O<MepD}dL0_PwVQ&Up~1qGlOfS_RsdzJMq
zEiC}RCnsNdczDp!Wkr(n<A=9V&3n}cS05%Y2CovlCE?`crDYurE6^HV-tN6(7ZnwS
z{2R)CzPGoBkB>h%I7qSS_bY9wdg1l!*N|stXJ>%x@-=_7U<Ib?Ulu>)l8J}I(XX=4
z$jz08#yT)C0Bcp*y$N?rS|;bWZ6nP8{=J#e5-n1e!ZHy+Jt5(r$;l@k`~LtemOM;P
zPF`DFY&GDTo|(auL`6llwY3G@@csLD06KkreLsKxgp=Xs=chWHi3{}BT-;e(oA_xW
zudJ*LYx4Ab0>u7-5E~oYFXMfP1z{19*pD9}!;FoMlf0roOK-2Q1Cr?Z{rh@<>3v8@
z2Vk?f`1opWa%i&M-Eu+E85uN0!^Mj`bB$3SJ`{fYMk3<L>ol?;oh%V3jN|b0%a{4_
z5+isb*qGB|3Q1-G0r&1W7W53j*t1m*feMVnYtEZ-fq|_6id?rQkDx~WO?_iy^W*E+
zmDN>Q##kF`>&vSvC~pAYU+e1no-F~Xh?}ak<A3}(@`2DO^z7!hDAR4;y&v=Q@}53@
z>g?k3fP$hJkARAb3K0<z1tl1^QH7ZR>Z|ZWK0dyXprE*f1fXiaQ-#K6XVc2pPzf*o
zb=`+95QNJYU~X(2<Z&OzyNEjhZbBCXH^-q6h>neojgID;e+wZ|TwMIR))nZW#l`U!
zAnO82_$Baxl#~=nDJiIh=j(r1r_-=01a>da4q8KT;B*bo_LpR$DEoSQ+kQ(weM(PH
zKR!9x(a`~%qOzibs1ntcmzVe7%1UT(FbW!)nD^<x#Dun#6dePD$;tLiNl6I`3d(q_
zBNQGuRKKgEmy(h#uw%NfUkg2X!sP=G0LRkW(vq}MYc<9}OiUc4^6J$jKtTmX#f|lK
zI9C@Jm%z7gM~h&8TY{OC)0iJV%+1b*e?NWxEOy$M^27z>Wf9=fr?gNY&d<(JP*J<P
zx`2)x0IIIqzkByC;IqGf{{oB__SiRu%=O2psHnIlMUegh0Rcep3-j_?lmW^_%VtA~
zW&&1%g5m=!|JM}@ApqOixiG)flgJ%kVLQ{kITWZ#O5=Qec~(}&%g<j4iAYXPPDPat
z`9K#0Spxm!cqQErcIkS*hm!y!SX=7Zv-XX#qQyx6mHUq$KZc$JH$6T$fE7ORIp=j1
zhHiYiw+QT@tE&sr8#?xz@)C(PR*%UVH>=XE8f6Y4^BvaWz_N238(Xhe6#Nz26<a=^
zZW`G-yZ`mfj8tTCunQG<76Q>F>QqdXXebM*A^NJ=r!(q&^B|Pu(DZY;59f8|ouI)9
z3BAgQ!6Bfv)3p-|RV6019<`kT*PJ4A3o1~Tp&<Z@ILcN0EHHHwEz(np4TKL$9hAY>
zmA0>)oe!gZ_ZIWvl-IVm8_WkY<r6uoYipxOxZhqF{*$1?51oXf1w?MBsfk)xc>4G6
zZO|kNcmRNAWoF_^rlqCfPzu{SIZ2^Ela`j2k(nAFe=02v-QxfN0-Q#{iDR_bw>=>D
zkY+|e2XAXmE4tHB3EB$0gN}|a*(<t78pwNIVWF#&)4{>P#pPM)*RM>8SmZ=RrpCtE
zg@qr!2Z?Z&h#Oj2k&}^iQ<PU}m<~|)OQq;m+0zhNVpEAmd<RCXy&S>y<cTN5CP10}
z<6}nra5w=er8zDVOioTt=!Jlfp<2yUJFP%<hM;L~ZiY?){ofp}%(F~PL<CiyL$~TS
zUnnUlp#?Nv9g|;ELl@9fRP0+D{tDrfoRtZ<$=_ex*!bT>sTsV96caT+2IrxsjLgbH
z`+Ikx-4tc-&bT-2?+78y7ds+{p#=;N-x3si2_K*O=;&Ka5fs#Ri!tuFimO3GtFahn
zL`DuA%#ztyTl?Ee0<8d=UMTj1PXK0q{@f42B8MXb!Z!y$6BEfFKSED4g3Za!=Czv@
zW@2Kp)zeE&Noi|q(|GY>rSJ3D@NlW^%o7?Kn%A#q;Ic-_ZIJi35=>v8qPDiSnwsNq
zt|F9WNb6Qxes1o+y800giyf~)keQzL2Bro9{!&xZ7nFwR8U{v2jJtOqJaLwN{n`iq
z#=*e>A9ep3g$wb1xH(Y@y8zv;(f8_=o}Q?9%b)z0!9hXO)6*mW{ZLR)?5aa2f`Sgo
zmza>CsiI=<;NY>h03nJZ8Fuh=^UDk97!6Q)p&CL;f#~Aw>>Lpp2`J<3QB_&lA%Hws
zY(zu^h%MFJ*}y&ll{kY+0<`ckKfm9_v5m4ajwG|Nuy^05$2|$`_lb!C=Tw%K);ca>
z<ln<OJpTQ`HQgx7S11$LOVN3$=2%@u#ZPQ~XJ=QCBePNW`Z7ngk!nl8Df7mOSQ7m%
z`oM<RFZa_PcNFgr@5Oz5&}q&N!tq^&f{EEx!<1iyDHB$fNgzFq$q9+u4AsKZrxGLh
zRLDSG)U>*}ig}cHgc03nPkMCXSM779Ly=cnIt++#bkr5f5XENt84<Qf4|%QY77s74
zhNfmkaj}Y;T8n2&ss82sLx9YH7xF+Al#>GmLt9JBK3xryEJk32gPYp{3KfJE0GdBT
zLzBgZ$ox5=%rP)AO-)XMN(f!lwd*4TU@eIE0(E4He+Q<Q=owJLijS!iBkTNbd_kFl
zxK&Q(X>V!C1l07aJTql)fB#M7t7+y|j$a2vOoC6Vp>SB5o10r&f_llJRcrtZ9ze=8
zTSbzXUjsm8z|l$EMu1a*nSz|bq>u#YXkcpUeIvOOH7)I%y@hsoN`OC~K7E2PhGjI*
z$Z2bP41Ckl*DnHr3L1BIwy~}4?;85Ifm*)owP$+wse1GA0I`YrT?@~@&5=)plF{1H
zAq~J*Utb?kta!Yr_o;Z+plNSX^TS(_3Ah6Efwm}xbWu>~>fxcFNjN{b(lKoh3JzwV
zr{8_8sybL$$Pt8VItpE~Rr%=f&_Moq)pyPhps+NsGck2W>NI#9NWXslfKw7UiImhL
zXnqAhB7bBXv0p(`iDgnIf;vQ~r>eTQw<rTR`!XypZp5GF&US6p&z~Qg4T3^K7KW#w
z0q5oAp=Y>kj6Q(CgaDLJVAF2!uCA$hf)f%nRtN}%jt<$YPZE7_%^9Qz&>AH+!iG=k
z?Ax+g-rgU<m89*_MCW|<7X6O2{G%TYnr-$BlCt)1Kg|pLY518)N6aCC9?tei5*=@e
z@GdRw;jw1s!hCx6yH#=@N4JE@Ga-C}Y~vZ?$J(K|_|arJ?%a{o4?}SAKk)@h+ny4I
zs;R1y0_KfA7IXaf%Wh}F@JPU{@wE9x5|`oI4<CNV(8++R_ai^w%G~_d1Z7Bs?51U>
z0T(Q3mqm5^dqF|=FqA)KvqAyMZ*_Gk9+Uxrm!N9QMx;yOI1c~nJ%J`o69hVHPIh*~
zOiI$#Cvp?0t*BW0bCgVITu>#TMQUnjfGBvYYJ<8PC>o_@nAUP17q{u)6;vdo050R+
zovp1Og@t@PJS|ZXlp?P*HILym##4^IsH!R`^mcax;Qk532cipvcrAVh&IHa&qegie
zR#q>76F^lUvH(CqEJ%f7bL;zK?PH#2+^LOGMhe)4EA3=+#mEv669Y!PmKMClGWj^c
zk``80i>4yKzZ^Z#RD1q)IGOIq-?J}OC{aIM$q-o*8UX|qmAxg<b`X$zp{4)&1=Imx
z2=ub^1hoQ?@q2qiT<GezV*RrTwm0r@-wnd8&r%eZM7o;GU_*S)BHejo`T?Ex&CL`p
zuDElBUBFw*^{1p0vn#=GA1+!@<pmLQK0~KLt-p|y)bCOcLO=YVOlQ`&lE~s%e6urF
zdU^DIM*{^wBo0m#)ZK!Dg4NYkK%Wr89E}=eytF0x4^oxB4zEf1cC<USgXA#LwK8!k
zcu373IStS<A>kMr6KHG_E8qQ+csAc&R(5tFl8}%HgK7`@878Wfo*p!Y$R1)E({CD<
zK*W4~eSLgHBBd8imt*AV4BG)@D=TxdvTj^oUHIKxoj?UiPW0PnbJe<x)z^z8;g$p@
z)7NJM?F7ye8Fjmu_!AHoQ~nOVT!m!G43#9}I{*z~^WX<)0Umk~lo)Jgc}dB)aybiB
zhzDF*1sNHG6BB1}2g8}iUn)8D>Q)yQ0dX&`tRzN9H(ma0$<Y6*kPML=z}gRTX`RQT
z0!}*6ejl03zd7=}I)B{wrVTJ&_*2?i4=O;4AiU`7&zbZjlqjV**-ZmFz0as%@DhW`
ziHf1M>FXIO=49x@HUnIlE-q0&>6=PLlGF!CLqA*N*)kg!HWnj_CUAm@Iq4z@q|sG>
zQhNJ*WLW&mxk1HYY0xdx`PbkEnJpnoq({H;wD3g|pUrLS>Q5DdrURQGq)BJ&yJ3Qj
zQh*o!dMoTHgeI*}`hvj_C>gZ);k`w_p}%Vd+OwpaEv^g%O7ZOj+yuVx%a|wp>AUc7
zLCDg|pk_Obkk`>S#{z=>AZ*rqpYaF_3j;O)M4Rr>8B#K#J%|AC$9v`X1AtCI2tfB(
zP8M+Oqh(_&$jj@trdL!{Oc(W8$mKBVh?oEb=I&kvW!KkNw6P7Ft|QYg3?TUbNWRW)
zZjIh&j=+kLO+^R^2$p-3W0R7!UcC4NBpzxf=<}O#g@xO3Eb89g-g5HtVDh+cO_pDr
z>`YBf-ABJ8C|C`Bzq7sF#MG4U@nc|!fFw^255dfl5*Mcy6ik-O8U6F;?ED=2<zEK*
z1ZXav9v&h-=Wz;*!~_IY)zw&nkJ#DSBXMh>O94rBa&mHUDF=oGdOJL{wl=BLujqsX
zV0WwQ>u+A)EdkJk5xlUts17FF-_}r&p%M~^pj&LmgT!EKZ4CyE8rW$zHtYwS$)Jv&
z93KOe{RwALQnCk(0j?{Ia}3m4OG^uo({#O8B~YA#g3aFKN8>WIpeO;f*9TMst{FTD
z@XjxNM}Q6Ck)R?tar_z_1WL;f-V}gIAoCm?zvt%sWRIkOYm5Kzmd`JI3URYt>GePo
z2?=Q*19F`O$CfV0d}nS*ln>nk+iOAL>D;%<e`{lx6nKF*STsB}Pr@;>?k?a*6n-c|
z5xmmBnTs(-47i>Zoh3^Syn3YHQD_EIBIq_%7KJ-2#B*9Gu5UIrHd<R-0U3iV{r=rM
zpq|Cg`AtpxKE)>|PmGU`Pfd9(c3@qi&7t0McQb42h(1vjW-!1$!kQ&sz<+6R(Lvev
z1vLj09EeLGc4J^(L7f3n9yDz5H6WEn^?%G$r}HnGq5W4?W(Nli&CS1oT#%zy`txVV
zi=eVHXF$nt2`XXtCXW(f{_f&?|CRqQ5d4gc6^5-L5FkZ5mA_|aDKDN#!TvsfzSa>*
zJ~J}|%Gt{AR4W@B6Q=B%8c)b=Fb}|CIoX*r^L1LrJpgzK@c^m-IGaGhq1|>yl2^WI
z$H1Oc`#u7gdaOwQ<mkw7?xwUui?R(n(a(AT?!W>8#mFcvD{Bt%3@ymCzN4@2*4%>f
z4fOytu=3K<)`qS&U#pFl;Cpba;8kj>s)B9QsV<8jPS3yqF7Nc8KaXvvtFXxV!a&Fh
z58s+=6a#oeLnHC}b?Q@EEH_ow0P)@9;}7rNJpq%&&Fy4$FbnFNsKpTdZ@0eWM>0?p
zAaHJzu-2`pyu7@qXa`6c$Q$rjfg)=qtTr|_SC^N3AetF8%a)n2|DRcaw}?Mzn3#w`
z#33WA0Um-H$PLZ(%NJ_zzr6gALfh~tAkd16QeGfn;+z9W16GrfkpU3>)|D9PxWeRR
zb#-+Gr3xw{>;@<VlarGGPMR+tLBK+E0B?qhANc#eQRMvkI^fRtGwmNhdNt$&gK`Ow
z!S5vQz_UOCSM-RFluMokt#h%12g%HIOiq`*H)MaKj2;B|x#}y@qraD>5)NngCn35G
z_U?y=%ZwRoH}W!16Ucn~YHqsPCB!xLhCYmJJ8kx)l4mmBkQY!2nn{>ND~|;?K2;nG
zw<{yp)27%;7c{_{EcNm60j)|(iQeyJ<7vmk;`^*LG=soupb*Z^>H$Xp?P#>i7X(Mp
z|KMNnTtR|l*QqejZvTQ8F15wR&JI8oHnqX`3Kn(IN#(aWQ=9mL0l*jNm;f}vnYII9
z3r7HW85%2G0yYSC3M4q7js^UV(fyzIoZM$|CVl~w1^q_YWgYr%9OMMJod<4tQa?S9
z*5Qe6sgabF5s;<1Z<wLfH<1pG2+-vK0VOdKU@U>F3gvwa6t$Nx0e{Jgi~9!$2ZR3=
z8L6nFLoP%E4D&-+*stDRipQ35ptv9O*V~7k!8s-U1u6t?7Bu`#P_UX-1`5)c>F5@>
zwjzC0C23={{2oQ4m9%1`_lg~ZGr>UiOYvst=G4Ct3)$Z<1=0<=gF8sD<F*i#ljT;h
z9ln=QZ?4|oz60DJ|A1TUEGVcAA%D0!2+Iep5OCuBepb|tU4Saayx6@6nCxhJ1cw1}
z2AByl5sc;c#GFv{i0<DHO!y1aAWeQm|M@V!^jv#jn0&V}50Zw<pK>=b|L^RGIKrp@
ztSEmwwEqvMNSeIl1}7&yH%8gL`9(x#1_p|2YcFIhZ+8E-0@!YNe{^y(SLfjbbdbt~
zh?toC=U=c%&}qQ>gfijxofQ02cXxL!=qKc$A2Qt(JAT)A7}(t82K?I2!lLVMRLD(E
zijW(WDc`EE<AbB4rsn2hS6L?rw^|BJIoO@F+3_!f6$8NVGyHt|v^`PE^yrb(FP(8h
zx&LbeHH@FtxNL-2{iPtg>@+enBPJm^rE<dMsCL^)gVGG85LXf;5=hRuB5G(`5WY~M
z_Su3~zLL+SI%w@)2Tntjf|~KF+HpzDoEDlBJ-!7*>?NT*HE!5bT0aw|PrO~7ooG|Q
zVN6|J`5IVRSk8)ENB-ZKDq;nzFjWE}wQwV<K#wmIK_Wqod;MqY4CiB78dM8WC_R3o
z_krN}U2O3KF$b>zKnMgWn4~E8h{E2z+h>fHrN=<uHG7&MOTRB7fFOp-R_wQPs`B#X
z%Em^m%Z8@9x;hBHX-m7C>T_!)zZmMi5`a{6Q{XdT&dZa0DMEj9JZ0yd2=5Uz`%Ph8
z3o{)wK|9w|ES#J>tE+&j-@Ow%>@Qq(_Ec2FI=};U?{C9TWaJdj^^xy4RZOBD``JH!
zu+!2az5fNai`U8a(wPK|^N>(d{w8kkh@$da>Lx6X^<#l1q!0e=2}ce{Esc$Hy}b&$
zx+!Kf!WSbaUTlsVwskYh|Nd!cYlq_k1AmI%-qG=<bFR^k>cInGjNIUM0gq<Wt-=-3
zd-;+W#(ZAAddSGg=XdRmh8C)tC5;u`WxxfMv=HVwW@igCGjFBh{Cwc4JD?w0SX7(z
z5CsjuL%4zzX8*SZWT&&!QxKv6js!)+p@057^#vbS@_(EWVEe=zy40~<AdpnqLTfWL
zGz7x~Dj<j(F81~+>gqypYggA}pibQFX<~l9z;<8`2MQLXB^nx9uO?u!J9q975D-A0
zlE_d288;<0wUL1zEd2i`BWT=88%n3U`zb`P1@9!d4A6WbCvYW!m4RTClam7o$!X<x
zd1YnitMcMvE+AbM6`DX1e*H2BJ*(g^N#gSi6_9p7Y6dyR<C`@!GO({C!J{A}=J+2U
zBxnFSGGtWx=g&RDq<91bhx<!CP{zQ4Hjn|CAABa@?8NM^;?mN5fzZtXt$@A^6$sQ_
zkX_-aZ_!tS_u#<5c%@xBC>5HT3F+xn@pA2$2r^1a*u!5N8^xdzFfim)S8Ho(x`OZn
zBxgK-9j?u9Jq`mQ37<a;y=g;V&h5z4S69#a^2Go|4VaH$KD{}W1#Ao=)AQ$dV`N80
zM`z2eh+P+NKWR6s3!jXMF*GpPow93mFgn=G<|c^%L<D~WumSoZ&kY{VihAIrnB+G&
z25RbgPzu1i1X5a1F*Y*tZ*_HiX6E&)SD#W+BKYZqyqdatdyS8tVt4dPJf|ptg7IlL
zQFz)PZdC`O8w_YcfRaVRJjK%HCiJboi9lKUA&`*abi4jv91+bQuY!{c8yo$Aq`A8b
zj4DE>fsql|w%%}_U`cH#Qox~J7HBoo<k{QqN?-+k9-1J<43(n^f@}ceA4FDg&cKM!
zz8U$Rl?8hJLQ?=TxHjlC597fLEVrKc2@5hJrVw@q{r(*OIDPm)@*DV}%*@})%D}ue
zfVc*$Q$ivG;KHBxf<lW3s907>axi^nYiW5q!~$N*Ta<g_D94wV-q3r1nLsVm-AsOD
z1{(#ck-c(MR8%9#B@olet&EA-lz4a!Fc1|q0Bs6SGU+>Jo?x;97=?Q$C&1S^I62)M
z9GWR}H@)9Ui7!r&PKapln)|^l3R1xQ>Z$-ZQH|H<8(UMAaCvCwQ0P)VlFb4rn=LUy
zYw&_@;p1}!SxrDl2r}q3Oi_TM57EX;wgrg*CkGuGs=tM`wJ?-DFqpn+tRq0C2EY`^
zLl%~`%}p@s`M9}R9zKK-GKg({E-v?rWA;dCA)oWI)YJ#Tk{N^MQ0-te2q>DAT$A%u
zgO5<YEr2n&geQ=~ugd8#@bX$s4Q$=Ffq`&y?quaOVeJZQZ4C|3ZC^Zp-UTFbYjYEz
zd<oI%QlkC`N)eD$uffTI!VD<K_7jJI07z(lO%n3*@?Zvj`}PgO2XO1>q$HT^889yc
zVF{MGIoH?-=pCvhfV|$`g7Wfs=`46IKq_GhjG#s8*EoN#u1=QD0>Dp7N;=c%*9cs@
zprChj6!aHIaczx<e}JoZbmRiB%*gnAyfp>&Y`OX;3>A!wjdjX>9W)0(0Gl{ok)EDj
zUk~N#3f=*=0|Y^U9phtTiAhOSz$ta9mJ91#HWFYn<Ku5_RnYdJIxqbFTLNQ%@B!FO
zqea{TH$zbEY{rWb=U|ZQ4@4jsP|?ZB)gWX8#;f~&8?m2nM|4;<3&K8pu(h)C0@)X0
zNnfAJsTQ_A`Sa(CbNI4~{Ze;4+^k9gC<A^t0Xg}_=ENgg>$Jc!h!L2+;{|~TR6#nr
z*4|!g7^0L)dt-J3gB0WArvM`0nPBwmM`B`PLxZohG-|#Ha1m5Aw8dJA%>dHT4+dtv
z6miDO@Eo9#gZ+nvfdMFxF#j|75g9*!@&FJ3UJNZ*im1k@6B`_F-4~A@l>){a9T}l#
zWQ1YImF49j^Rn%2Si(k@OccC^VM;hn=xA6fn=nxYK?Hq&f#QV#uYgeNe6F)AYHNlX
z90|0Wj*exJU!d@T9Hm=fJpuoNCOZq62OPL$YkFE2E(GrWn~u5B(c>P@Mq@KGrwKQx
zb`TGs#Xe+Z1ur)|GLoH*Eql;>vo0z15w`zpty+i05GX)k*3H&?t*ot81G!?u#UdMb
za&&|f1)2%n0`665Jpu6x!)p0OMK|-!$OT{Ene_dx9`o@f{CQmEybFuq?v!%<WK?fz
zYYUU0dw><e0&zTM!A6YaH~Y71ymx%e$HgW49J&ZI#2z?DFdqVey1lk`7ZbB>%Uk92
za%CALfN}Cb7^8t5f>8k%XJ_F0Ft!UT{qTBmVd1CkObt+Rm}Hyh=i}$s2RR+Gdc5{0
zOxZ!%h-ZBXl4iZ-pFF5QARxn5gM9!H5RXo}n5a(z$+a0IO>Gxg23Qi5{I)4yzI=&^
z!OI^9ybVPOtSp0C*sq@@C4kr{kC!tF3cL?jRX5|HH%CQ54~<GnBC-2%OF|32KpBT-
z4vc~>2#kqCD8K*&th?HQ<v~E~%+#708mj8+i#aVTKo%A_E673z{`A-i-0l!upao!5
zTpaX^!REH4^e-<h)q5N;vawl%g^x~Cw@~*Yp>_Hnpc=okCF0H0rrusQ4h~yj1X8~(
z!MTRou$g+d=Wvg*5(dPMkGD5B{|P^z7#&SWN!k4OFNon9{DLd6&ZDCG!TKt3qr2tv
zxwbH@x3%@+<;z<uJ1(vb{}|D(A3!GX?(xEghHKzjyQPp`&}WkJU<y)dQdr0WS`zdd
zIIs3s2EZ7gk&J)h!Tu^Re)E4_AIM@nNvOd<-d8%P1*ed4I)t-h-@thT>$$o*nFB+#
z#&PK#7+avi>=9A|l!gmFLyx2qYxr-BG&?H`*{hnWOhpqYRaQ|^RI)m7DVPWXjt<uV
z&vA8gGbK4WIVGjw>(>(qa!l<$i7bpz)D>LJP`1?4GptwNf!_n5YHAXPx)Br&p$!#9
z+bZMhS7JOo7_<goI4(8S22`k>*?OR6?Cd`P?B3Gd&-_t64Yl59KcVu~)(Yh^iE6bp
zzejWFKrFsz1)T!oHOUx&AQ}#3o#zn<qjtZVK4d|5<>a`4)KYNd=;Q<@hP9<-w<kj)
zwkS2_&tVF{)z{v{#ECS0*1!Ba=9um+>jKS8vH@>eF-72(graAFL=CP;oyS4Qj5tcV
zI>xj)7du=i0vCp#Pfz#g4)$LGbjAp7@iv0F#=vG6h;BC%fgx__9VJ`0V^kp2LD~SI
zgq}uKX8s$0d<{(Q8pt49n706D2x15nO0$Fs@M`M0=Vf3Hn4OjN;{3>pEsuwZze+1j
z{T<@a?x++xv{D=~5dXlq3dIF>{4OE_f=;i_y#y4HloVY^04XUc*b4~>#A|mjNwz_V
z$|RrFgox1+-FwXneen?F#iXPpIQf|x7kO#vkZKtLe;jHYX5yao5Cs+}MQhG5`8AyU
zSOPshG0})pz+7E9iAw^kRM4d%{y;E<VMSwGUQFRHM%~V?t_!s=1>M~4cnivWPIm*O
zv-&`tDA%J<awxuW+nH5N6HYGYNFg1fbmv;8NhOeh`2%QUgM)jpxqy<OECWyiHjhrT
z{LX-HdVD-AhaixsJI5BC2I9oZ%8E_C>7_D!BMmAq+HK{<UgkH?fs)AorY($StP`|H
zR1}o>xHu3AnZW1={0#aP<TNx1m}PlS#12}`!p|L8+gGL3?t+zQJz?V_2W+cT)_34e
z1c*0H200l}H32pJKqYp4edPty<0B&)&_2B%Mv_ueqy#P(1Z?Xdk@=;wA>$GeC4lx_
zQ9>FE4a?PJPcVmsfHp?JZCm#eC2{64It_RN5|2Wl<N@P>nb$h6lMnoNH<KP)-2y8p
z-5_Vk(tm`}?z|WIyQN@Y2hJYRHL_6ShXcq4vS08ObUqjeh7$%Y=?13b(nY+8bh->-
zrimeG^Yr|Pb)$JlRU5e2Ev%R*4VBJPOyc?r>kj<D<&axnFT&2g1^0r95TGv8(=9r$
zfr)@n4ao-=&CJSD2gD;OiR#_74`mVXKLmI#V2#?^&#zsoN<3VLR-MoNnf+V;5};jx
zi$N#zfx@=b566q7Fcu&E4m2)cO)w7yIm(t}@WQdlGtmw}m4u`uTsy0}+5?7V>+b#?
zm`}kn`ZZL|D`u()Nfo-u1FZ!F$+|jWqyTCT4shTGL3kt~S)HF((a`v}zTWLK=K}z8
zU<{M8&fR|klWg?=m>;5isR88dD@~#Zz>R=kfb;_zG1N%7utOF;KlX2lgY@QG4BCJ)
zD^{@3zyscEk$&T{wKN!pFnJJ&?O`a-OvI_@4MiH-4rC)v9s=6k6qxLWsnNZoqu0>6
z{rl&jnnCh{$Q(&!VQC4ua33ds!9!X~DhrP6>f$6Y?E%O!Ad-T{3ji9RJA4A{RxV>Y
zg-^WSzkW6I@7+<IfC)!1%$_hZF7Gtnz#KELXgoE@lR0W2ZJ32hp!-~3PBb?MC@{v#
zW<x^47TX&I{I3_`!otcbh0fhCRBSX^W&!6T4ABK+1O5cJd~-aM9dZWTdvZSOQ=-pi
zOg13sqi2A*vy9dneOvdz2u7_BE>(B3!<i06;z$Jqns)Zm5C}T1Bq&7%FX4L%Fg{R{
zOI8;H18wo~F0f4PQq!xmmGlBu(&`|oKqsyU8u^vk%cRGE2mlvL9XAvf+JbirWeg^n
z-r;@%&I>F8rglg%J3vXT-l=^a%Lq*p)oqKWK8ai)s2nDoVDzwadRiFf$Y^K+Jk;W)
z45+{q@CUI4{s>VB&A3CcZLy<S(CT+GqG-F1IQghka%*g`nY%Izd|$`P(ozqADS#Sm
z35?sRz8R25Va5PZ2H;!(aKN9i-Bp1bmJ}C*6kP3fVheK^+S(I9Yl@3dVJHK<5J36>
zuq;eXZ^=JQdk00s5O{#NJ0KwdjKFBSB#_WRcK=yg3f{swh=TzBtUF>zA;n;30>&KR
zX8Ze&c6K{}Dt>5{ye%E~_eTIdX4=?W1zhD!`2Nn)5-3sXJjuE$D)Y<Bpjg9MOG!%V
zHTup#z4qw{X8}Pa>GNlDLP8h-1#JoDAy#&F#Kd!<u>(xHxjg6xv<^niOoI=3ZAfLe
zqXG0Fh+)9qx6T3J1X#%XtB*rqut7q9jE#j@Iws{8x(lEI(gK<`^kj{Pk6Bsoi3O92
z!*>FJ;DAHl<edl}N>SrA8B9^d$Ah#GmzW4W*YM4omNTyufVR84yYOj%jbIGG7f28n
zYd{i*<_j$p*c+Tb1uY6cU%%3)w{LGJaq;iphnYIisDVAD#>PJS$AW!qXKf9&+kI^)
z2ci?m9&8Y{($#<F3<jIS$`B>0J8dY@^3ZdrcmNoELCJ=v1Jrr}i&xK8Xcnva4F#&d
zAHE#|aN-oc9t3A2HZ7PcaRv<uI6m~vyxiR7&CTh70e`=P$GZOqif{Mfn1NscWget<
zn4AXb9%K`+*~kv%03Gopr^Lqx=Mao{5<}yGFW@x&KbU*-a4g%mU071?GTk&#G7m+j
zXf$U^GL?joAsHfM&X_VJN%EALh%}q$F+-9$gv^v7%9wdr``z#Tt+l@Qeb+zV_N{IE
zY|r-eJaN14>$=YKIFDmL_I*F1BkD@Kv#qo=G@6icVv(T&0P_jh^M?<?1%8IQZ{EL;
zKVgSHEn<B$HvJ4+DYIxgU3pcNpDcS%@vZQ>K?>Ugu~{Rr`v$anD3AV*3+oO4!MuKN
zaZ4q#E*X!7$>v0PgrKdL#?n8&B2h7#HNn2yeiw93a}$#f`?o;{29O4y8OIb>7&s#l
z0(!I1w;)Z$NpADn0jUE*3&89@)6+P1`f_jR1K~o>h2Ue+7<=j^MPrWU`SU@+!E*}>
ztiY+!|1Z71{R~)D-Q5y6QIQy-`E=%t1<1DYwAn6*+Rn~5-IhmK$$fA0-Bz<lG3$=!
zfUsjK!h~}P3jp`7GnCw9q65Io=<qN}bA${f^uQ?x^mRKgA2-L!1GI(X1AR`_)K(+|
z>1R*(@z>EpBZY?mjmEnxCDAG=F3!#fkD!tQqtyn{1T-*YvS@jrI_75B!EC^ieHRit
zx1Vjup!jf5qhSh?`Q&a}GAwg3FjJ?OT<z^2J$Vvx?;ao`qzXq+v}I-vy+v150gnzm
zK$PWJ&0sN7zU>qd5ji9vP*o46urta{pa-K}Bd3&6aUz1oW@Tj|69<xkV*Y}bR-j~c
z;|3}=WW)(58raxEy~=8Y>_NT+#Ss({d`Ka^Ouus;#sG;z>O;a!tp|Xm>R-N$1{4Ay
zlmfvK2r9SGBzydr0n3ewifSY+qRd~+q7jF|7X6qPXp0UE5Dy$Ewrt_FRm$C7p7^0_
z-^ZX`2LlA+JmxCt_w12EZ%R}1QAh~Q!ZO=}^vC<f#cSDCt<uOag(Y->LZH~4vq<Wh
zj{~3yGK{@_I{2oz4s5HAw|ZQ{!cC2T*K2o)hbtbnx%tS;^UuN3nkjbtgtHQB1(p5Y
zJ$q0I-F!|LL3d1OtLWjk($&{whx`5>mVbP!=LT5G>|Z1$-BI8K(l}U0kCrTufUu`e
zKUUt~NhV9uQwU!vj#S`0twrXU4Dj~Dhtt6FH%oU6&@6R}40xap6F~E3-##dtR1-Dv
z!1u7Q+_1H!U8W!-li7ns43g>Q<mS1x6GT5=veI2Z7_fkY?%&7rVDy(e5209=In7D*
z*kqVVF;GMVkKO;pl9KTdsV724CQY`B?eBm5f2VKt^$|@;&&r~rrv5&nA{u35X^G&x
zDt1)Q$H&Lil=F$o`d$tkjtGk=jw)QhDa<MdyoxjqfEA67K%Dvsv%5h-J4hI-I5)T7
zAEo^vxqvB9*xl6noG!$=7uhSa4D_P`N%Vr?Wp2*vQk;|X2l@vY6B!3UK@AX!pi~qW
zk2WkbD0CVhJ<qJOR5RiDyXO>+9y_a@wC9r$FOaGuaLLG%ZMnTEGR?+T`64Ih7(f4Y
z{JrPe>YM3l`@fLey<a<_TgDC}P)iI}ZsZ*321W;@&c(^;qLx;r`pwb^Wo`$fp>&~<
z$LO~9d#}>0K3_n6wRiV!itXFMDwDl<G5cQvjkR^3M^i1Kle!tE{^;T7u7iJ#-;Au<
zq=;0yTD5P~{@Hh_MFF&aZn-7$+fzG}cUR&li=PsO_5fAJgQ=eYm&eAY*#l+Sk(yI>
zqa2YZyn6Fym`+UHh5c`j;9U##sOfJ&g=cXjDk%8jT>eS`Tv5%swf}iTS)i&5&N{Hm
zj&$Y%S3}#oPfaH4n@oXp52F--43dl_wSq{t_Rn<u1+b(K^75ih_;CNR>p-6IUjz=(
zsA3@h2o?yjK!Wz|i_(5`2@Cpa9_ZkpGLMXo1_uYDSD(3BllfPG;erE14I~Q?Y|v>a
z>#eJ!DvHyyK~@2z8rbyR52W-eNCB)DXm(MMp0pph?d!Wm?w(2tXjABS+8};)8ln~j
zom|>}fXuN4fd+{^!l44^d3}8k=sd6k>KQ30DN|p(;Pktcb|r-9aP#JoW5-f74}lPj
z755WeZ*A?~+#B7furnr3#a5uV{J%65+s*NT5Y}Tr_>GKQ0xE6@tn2k_6(E)<vpYK@
zM;~7OFP#Qm7N~Rng<_v_+Csa?7+y=_Rzrq{2ZaO&Clr)Qc>RA;Hw;y>BI(yv@g-Kw
z?)cvr{$B;4i7Ev93puVgax0vd$Rq{^jBysM%v()<L_i1O2Rv>xM*MJAokx&Dhdwg0
z6TJuEY3?{)wyXo1NBZIg(u~0`!2KTX?n0Nd4@pUR$=*cvfzttr06;sP^XD^ib3a-e
zYHRNy5~soG!5y{93=%`z0wp9E6E9jU(V(eTdV=#D<XZsufN$;)SMX+lanaK0?C)>7
z?p^=ozmdyK-Z|}MrtA;OIFMjKxoGo_G$l+842WEBduewwaEl9037@%<$eR(+AO6c1
zK#l*2I8yTw%kmJ4uSppKH<}Nj)q}@L0<<ADp8qc@lhbNykd98FRs)cAIopz6au3;U
z3pZ6h95^_}aQY(VK%2|DfB$QQ<PzP*#l_X7rAhF&Q3(2AqX4B!J{z8HiL&=wM+aa*
z6bop1p5qPI;{jnBs+L=BZmKcIp~nW%=El;imoE<ir^fy=&%pnqUkL;U01~o0owO??
z?llBN03D>jg_xYQ5lA^CB=kb_5TG2i6J%wdy?OHn$}B9Jt){VPlA(p*>E(q41EnRP
zCdfc*JsZG(;Z=*STFVD{SH^yz95Ec(fq<|uaA+SObO?c{rfE~{eM#^jA0NO+B#%o~
zXU?AwLq_ba2HZkdHxk7oq7RT#BsXHv64;2}r9_5#10tZQDFB8bBO(<o0fZ}5WURYh
z-IESz1*mUcPEOqM8<%Zu-$z7rprXam-w)&%8i6n4PRNE7gZHA7w=q-0hI|&;E@_R}
z(os>(&CCEf`=H|s&<KRs+Kvt#+@{l~Pphjxyc+;X4l-GEm~b3D(>w%}9m0LnUo}XF
z9EqaO@&O8u{`djtkyL!6E(5s0z{rSN-37oV39)UA3l?P9Kid%b!5HAbk&4Psq~MQ1
zRzS54UMI-nsK&#?wTz9Q0WFA*z6^mZ&`|Vg;9ju(rPOV}o<QLMU0b6N0Gf_uKBaXW
z3uMyM?`{Qd1s*28OG$g+*@agqz!7yN9Y?5rWd|Bqw!hrJcdrW~5soC2ryzB*ql;BS
zTBUBHmj4)+9s#%u?AT{xIrYH<RUk(Ga;FI-+8`Pqnna}=TLxkVTKth|y8ij8jr7K^
z8EJa!moG@V0z%uTy0R$ee5j~`(Q^c9ffWR}2>}-^E3lN={jl?Z;nndMl$Krr27)A9
zPR_J^U>XZWm&6qP7kQl!qu~tJIeJVsHj^LjQi2N%0x=#C`X;Ew5OM(1>Ri73Iwb`*
z10v`Gfdq4;j*&>b7ZOs<?@#>F(cy#D{75Yfw-KUwR#xeoLkfP)VCREif?j7C2xqjZ
z0o?-#lbv^4ySfS>JVN6H`T5|xsY`Elp%K38oD?5_1<`lWP~`1~sX6%E=)QO6VzK|X
za4;uQoxOV(upMR4mWE~mRSPOn*5)%Ooy2<^8)@qpPXW!vV$MPX-bM%UE>P*J(EEad
zWjslU8=BkN6bLvwn3$Q33LLKC0wT3Qw%b8P#pMTPK0u$Q(~|%Q`^tP05XAWSf{1_t
zw2<6^FMv`S?Zzhw2~!gjU}wbvA7@|?{eIsUCpzE|AVN(0_Hp1K{U`nF@Br6=-48=U
zAsaxQC6PPvzeDuXBeeAe%77kG{U9UB;3cu7kuZV<ksne1@bvR4vfwBGhT+-2Y7!E0
z^AT`A%#o3m()VRKthEFaQG-rQPFA@_T}{Bw#lEAL!*gdoVoI^`v-aVCWsEb2a^1b}
zH8&ChUWm8K|D<;lNTLXU{iwlDIgWgXz~!(0Q{v#kGq92n7PbRnre2#V^TMPXUW+tf
z?}o?=jRZW@zAs-Y2HOBl2DX3GtvW-1MhO&YctK3}+`N07E8_1X-A*@wBLe9d@Fx<-
zm|i>%J@FnO&bXVv${_C@8w0L3@#&K?Fb(8Wp7-M8RB4;X=Mk0xarhLy8K~C2bV-!y
z0qQu<(`W7M($Ho${|;>Fql7g{wMdjB(b+?R+ZhKN6Xl?sufaMiDK4J;^$S^`Oma44
zxZ-h*g-!u?L+v&5lahu2rGRR(M2~<t85e)TRZ~;5oX-1yLZ}uyBx4pypd_$)P-a2U
z6fi1{&D*_;<fb8&a_G>Z^1h5iyHyb29@Xs_cPhlvel)cYF$D)5^jlb#v(wYft*sJH
zW5mD-kdXE0OjB^OBauKqgPuTvjy?@d2(W2D@<7i~``fUTlVREUAa<b@j%GYasE%2W
zJvFz9u$+utc`7{to$`CG?8={a1{WA}B`Z+q*VjMjJw`!(8f+Qhu3x@nW@rCnsPcj4
zBL5Th)VVybbbgR~(xpcLET=zK<P5|4!pg!THP-e2fJm9G0J*We$E}G}=Eh-7BJ5Qj
zQ@6EYo%rYU`h>(Snnvi_fObcs0)oK_XBg-dI%vE@Fi$DzO^GB#5yC#?5s*_LexR<W
zyH$r&4R`3=IVx{I!?$clO#Sel*w<)sppayu-cFeT<N+sSd6^m<V9@;kP$P%L5UfpB
z8Se)T$LbM6z-2=IK)wAc0>f5?61N!?O6WNk78TXh)Yx^Vn=~^}`sJeO1r8?`#hS97
z9=ag-IuNK8d(GjtTp~&2fxc0HyFftuw#q^Pmu^5v-)0FC5)tfBwR`5Fy~4qba!zd(
z;Zmebb~qHQI1?Ovq@%Pe6fnU>{yitSUFeScHUDK)4?WX{WL6aoqepumKL0mS+vBSi
z+UI~v(BYGInbcKM`iNB)cytdkP;%e$%X+lZ6{k&XxS!|cML6!scMaS^<4@e5JvKFX
z?Cn>y35LKLvgs0C%hLc=%mrx)!l?Gei?}7&`EXW<l;0`=3>9b|JxG{%_+P*7Wnh>c
zZ$0?64rSwGuq$X7ivPu0j`i6zhNNlt&gz<))Yq?n0`UW59;X&)YMpxj8!iJKar4)&
zuv55_ZoFl}*bdAc!~&emu!I51{H%%EkC=OJ5(hg_0)X1U{P5HOfPza3Ch#y42E<Gx
zh#Ks~ld+~xK%Hx8Z`X$K$ubeB0WKXXR8WoKchY&-TUM4VNMXO|7+r*k^9TD?Dh}-Z
z{|d{65@$hL12~1<4<N}Mn;XIw)hN+z`UxC@f`(dJb66C}@u^p0<53eLO#ll>{do&i
zvFL<OYhh<2H9$icW-*><Ugzbxg5PE>1M22~B41~=8sRZjRDh8?f`tjr4+sD#j|<Rn
zl>5}#nUB`#my~nZTfpRS2V-MQ(KZ5O1<4OG0-o?%#59PtI&GBkUZ@+9d*GTOfxtF`
zkhSsk@vNi&CoZ`CG(GK3Bt8EP6Z`E}j-H~ebA}Kcp~G`lRTTvGpXfq+t-65g^E<1@
zgQn=kfGi*>@SsRgo%foqp<#&NFL#`10CqbIB+1AODu$N|{xiLH8*gJC*lP&#{P6vN
zpa?|^1lUwzTOqo_ZVe6!!l4$8qW}%`Q^8Nd!>Lev($FBI6-N1m$Dyf7+?YEJEE@|9
z@<cJ|tA(J*z%Jlx8s}fRGcX4{0YF->UvCDMtUd@HT4E-X?yz*7@AKG|&dz@C9{U9W
zUCpZdoKMU4C-Ghv$XKNC*cw!_?da2&_c+z)iKi7#D@Hr{-5uWPT7Gl2Shr+U?o?Rp
zj_CfyZ3)-xTwTmv>=s?YAqYU)90WROaU>Grm>5zK`|zPUl39?`kt?CjgAk$0Jd1`J
zpUo&VHB`p!bzP`90o_<Sx`b1XFOa!JD59&@3*ZOTee4gQpZ5|}yKIh!*Y2M4D0G#!
zX7v2MAxAiM^5j4}0}Bg&<c5VsU}#(qUV_xiwy#)EM<*5G|Mzd!0|y?s&OBf~A$0h#
zHF85_+IP3p{EU5p^#?o{<>Y03ePoabD?-KBKBDldOh*QdtQD>S*S>!WTjG)xpM<Ka
z2;KU4JOLn0NbL|#erH-!2eNVFj8A*>26h?974{vsVUqg<4ISV%taNlKVgYX;F$%4r
z?ByU5(47Jeh+DcD)dz{xjP@#eVh@6Xx^izYOWQbtRE~_b3urK!?&56TNjnhVb)oCR
zd9KQ<1yT*5ejFnJ6Bk+N!%5+g)QXaDv4NBm;S9VH5s`F9_P)6^c}mFHyUKhvGq2SF
zR^<f*N9xGEXpZ->7Pr}N*Sx|FIVbv;ztN&Ud)5lHlBFAkxRa{9Sw-<&WU_Shg&rp<
z#<-@>2pE)k$0<EOeFK2gSk^#}2?=<5L`L}QtH!>id4^=tLbl`frN7o|%4B|jo!9=?
z4-o(QuE~<KCzF2eHifM6f4tz)U-uRUGLF9lTy8SC|KI+C?|tts>1k0pQ<AQL!y&Ds
z?V^_d&%aO{tvFm*Q2%cEzkZpr0sLeG{dY{5E|QaN-lQNOjNzm5+dVL$dA>3KmYCg@
zF{0IY+Um1)Go~#!x8I)X$a`Hkc6$EsW=<fZQStCFkaTndP|TqL{JF95qXlXcAS&xc
zJfXqCMF?VPIuNEM9KR8rmL?q2us3cKqy_XvT(4~4OhLS#_%i||WM!bG_1o7q51Y=k
zgMq)K2R#qpY#n{SVKEf2Zc&oU##Uu*;_YA}<;7ztRjqw^)5eZ*z_Bs5(O_f!Puf`B
z!iw{+{3GYTJ}sKG@m^kcp!Mb-pL7goncD1@x#XwsGeYMoVRJ2`&fC~+uzRKH@?!mX
z{hqqg7wdmU8dhh9y(cVkipqWkuJh1)Ir<Ftr?tP?*j)YdW7@44IQupViU&}MAmOf9
zMuthdW5+V(Yw&B`fiK04Zf@PT^j)Xa^`LL*aNYJ~RI{X<G*Lbf1s?KjD0`g;E4IPY
zi&5nYO03k>j)``kr9n!+W@KIx2fKgF;=tQYa9=k3VSf_E=gX;Et3v*@@AbsRE-9&$
zGQJ6&>%2q!Mt>wfur8F%PQttRmyCfDb*1}K(dqifOQ(kF$5X$qAKlECj!@tvSZp-3
zQU<qQ&}w+xc4{o#zqd^Ilz@$H`S&eJKN!+p1x3VP`Z;XvFT9bW5y8-9lrNSl_U`Sm
z_iIN2Re3pg<gl(6txnuH%@SUnl{d9gJUV4JJY{#c)Kfwa-4o<M==Qz5_<C#vW_h^y
z)y2Gx+UrQG$7eqazM}Tri*|EQl1TSbY+6S3o$}E+kBrOL)ZV>_{&|oQ44g6mj;PG<
zZ|ZAm8k?IdaWib)y49jS@+P=!dxN38B3ZQf5d$kvq25Dz1o0SrtdOm{yRRVkaGB~8
zRGmgrhLaHB|D=N>^6Ik94X{9p;8;iM@(<^nL)=26hAX@lf)H2^k#y{(jKYS6^XP3-
zSEBaFGpl7l-%`k8XX`#xVopv+LzF5v4KvNo-n^M{=MH(8vXi}idF4X{Yxv&GxfSDV
zL^M5MG>aGG>B7Dc=&LgKdzgsn=@rzyMd$|@bR<d@sheLjcmj|b5anQ9Lz4f3V)giO
zG?EsSsY_lr4_@o`aQ_e+WZ~~98lO=2xvXMzF8i3x$A_JV4!^rcbk~oLo&RpH@9~CQ
z+ber@`yR!uews_K2IJ*ReY6iW8DFB!jS@907w~J&I5&LCz}>?mCOcbF?$ZbJpPH+W
z<VQVgLVL`UB`7$m29F;QA6+f8I<ea_`evvL<5MX)f?mwS{o}=|N3Tk7ZcmF0Kg9Kp
zJ+{*Jy^Ouf#pcM$7c1|FnwFxXevofj5GaDGaYnbwjD}`^fJq>oRN+Dm6}9}r-9NcD
ze^M@_JQXOtZkn`G8Ok-i$E$>kaii(lkV4Ur>B_fbu6-SuFE76OBNMuR$mSkVMZ+V{
z&S-Y1`u#*l&6kN&`nfCW@uJ54ecxSELRRV2WeLCfBQ6-I%D7o_CJ2w&t=1*vjjT^s
zHYCXvhNk^U8{8ly`cc{~PO977_%Sig_v@S3C4K$U0kz%-<D+_S_wMvR#3ipp_$4Fq
z;o8gdqpc?bOvtz7UYjdPPUfUGdA|NuXY+dyQQURGsxj;HwAV1b9HX$Ag_Iy&|B2G1
zSbC9hr>k5#+S;@n^Xm?a&z|`b5|b)cXqbP0{hFSVQv2pos6Cs>S3{QBW%5<u!H)M$
zhB-ek-K6*WC$Bo*=p%>ULl(7?g_?7I%|wg4xa7xAc~Lq#8XJkm^`TdDjvGw(vwY{O
zPCVB6M-0)b*tN{q_Fil3sfVMD;3{Mru$Mc;YhSlM%qlIuqu=OEX!4b^1%}FIc8^}Q
z7%$w$^r;Pz<ChFeD_Arv9vHQ)`8V$3?cB@Q>T`u{we+c4ipo2~6JM<EamXFwTJQDU
z$``zsrZ=7Ay>DYze(gbHhs~|4T74zfJw<ksa$^I&fjm6(UaJS4bULg2@&J+beEZzd
zs?}5K_~79~xeqag16_=NZ>ir@n%8QLL=ls-UVWOSkGA%aj<=;D#OM?KwRLq#t~zf)
zxZ;ABQBDpl6G;A&V2qw2Tr)F^g=s@h4rm>Jil$0i+uIch@ceNG%7`KZ$tloKv_Rzu
zg1YI?GBU!NMj>#8p8;4!H&4bQ!OG3cgH0S75TX7**u<R<!PgPmqVn5YAgP4pm|sw^
z7j6iMLDP-{*o-sdF!V5HQsND_>n*G{6V-@4nFw^zSi~DLJ}?U)tR~@4m4RG-Xru#q
z<*zRXRsejWsJ`6d$wZdvz26&q)LrA3u1|aXFjVA8qa?wJD9u2pLfaUAdV`+8?1A;b
z9|eqsZ{6K7)uuCU#pqPyEuYl=_%e<fFclejKG0uu(`tsnmtR?NXAR9m;Lp#`7s}Jt
z(h>u*4b)#Kq6nN!<VN?Kx&inBz2+A`$iZO(eYKN#T-^`b&h$YXiM<WGXXodu#CVV1
z9I8Uj=F-;#fCrQczO@tL;=rQwphK@2W;tnZjKaw@a|PFgX6OCJL5G65kp_@K_lMTh
zH8rszEkvSQ9dY9Lt)?z(D*w$=fqOD;<~Cf<pVr+db#PTvoxIK(s&huT-=!_1m_M{;
zIK@0JB>#Y)aPe^dT*8iSH_0nE3};5<w|2(zdTtC)I!4$E?&|&g&hMAb)cX&qY*JF|
z`l=#$v)VGRu~?bZsP?M2{d-Qm9qZlIqJ8{8y2;UXp1JvtucZ$5^zW8oFiN^NOea{M
zYkuv?tXuId4n~(>#Wlk-=uJ!4JNp<K?uw|RiF3W#{Z*GW)OF(0`z)=KrI&usIf#V|
zhR_JGhK~Mn{;u$yi#2qS`+0uZFQM&s8-{08&P@o^=c-eQ8(zB9G&~a>Qy|G2T0Qh&
z|E-e?jewB(4{YDOVAy*vbwt!GEnzBSKAUs!F*qa@1}vvyB?ZTJN7VgrC_uHFIM<kP
zPj%4#<N?~i2J@^go2P`4Ge=sYe%pGC&wu><S)6&|9Uos>r0Pgm<qj&jreP|D0~!qK
zqmqYnGx|R7Zh`n=uym>_Xg6>8^7mSOsw}mszIM@~6IC}uLl+YRNw4I++frpFnr2w%
zuy6L9p5BeCTvxw7(DJC9+QEq55k2=da+%M{YTMjsoNIc&v$2n-v$K@++^0bb$JUVX
z@olQSj_T7<H}vhqqUupJ&^j;YWM;zB)(TzsnB#p_VgujPnT-xlScScs3HY{OJiK;(
zR?>dbk~6$k)ocD+Zh!9L6mz7i`RUUs1>+yf`ObrZRl(Uj9>OKH&|f?=sppch{w%Iy
z|Cm8%QWC$(d)mp+g#AoB0*aq{vgm8VrS&?~Y<+mRzpGKL+;}-Be2_DIMtrgWwRwH)
zsVp>6J{a4eQ;H>sTt7Lvs;OxTXuT@$93=SIs8x)tC@3J?2(Km8={VWF)&sc)QQd<Z
zG!^RxTmk_7bU%=II52^ykDvl0IcM0Qsq%uR;0k1Ci5$p8#W+Z5s`w6!X^}4hy~Y>r
z4R{J5Ai#zfUvRsk-aecqI$iK%MIfo)Yt5#7`6X}y@cvinr{2t7tGNJlj#b?0Wlj#1
z81K;g%=g(W9h>st41)m`Hy4+DYAZcSr38GKmq-BryrDr*OiW8(KjwomI3z5RZuaPX
z5)$v<-wFD^P#)|boB*(+0Z;DROd=CKXjj(IfC@bM!Yc~$4>dKA$z>HqF`&3gfw2$K
z!QTE;Q`6>KXEegV@kUWgF9*OLI2A5&NN0wLVego$?9x=s5asa^?@ZDA6yz-(zYZGZ
zB@pF60r>Xw_)q>9gv2eEcJW`2&&&2^;xo0D-p-MHD2+=o?CJ^EZmO%+M@H1nnif5y
z;rM6q_}50$19G3fREfD&STTfg3M#g09<ejKbgzkD`x1}MrP#!Wl?Nw2c&EpQgzT03
zR9pM3IM$cwPBel`#=GL;qrS3)SaA`)3<AgZ-?pDkbBaH`QzG={&p6C8S?irrQKOjv
zYpT_vlgn>~uK9?Fru$0v0gmLC?3JcD0tRDAiKpcWgJsi)c3)WPo6$esub(s9bfbIi
zpC>Ze7x@l-&M%6gJ&=6ZKoo?~Ms?<<_U!SytS@%MnagK#n3yY1@bj73F?awCmt&tN
zhkl@A=BtvTt7rAk)8hmRa_U{4Yiq)-<i2DaVLlXhKC39*JmNK^pzkYdY?5e;JZ0W0
z>Y2yv&M%b#`?~*h?B#ue%W5o3xO3;I@9jG;=pK|AHTUKgRv90q+!pWb@U_Up?)3Bl
zN<F<yk?yUO<CpcU@FtX$y|c4QzOs*|2O9EkuD`svGr(j^_^-#|crYK*O_T)o3NPMz
zBFl~gDkU^6C7b$HVc~c~%%ZOrC0@;}4-t-HvBB(7zP)dFj<%guQ&W$WX9!BSUX1+J
z{d+xo<?9QzzWevT^zJ!+ET`(D5>=D-K--pAq4#eU=L$^}NEr2QWaf29xkwHSB<|2j
z`_3v6&A)U2)d<K&HQm>MMCaQN%0Y__y$8O~1@x6AHB`}h%+M8BdxRfjBv1flU%GY0
z?d8?pHUT;1lk2G6IOGFh|99)wGAb6A<tOy&b+xq+G=PrrxYlfN4ZR2$8sQ4S8bYFr
z<=OPPeDvv?QE|r8ON`Dx8P*E}E_u#;D8YAN{Zc6+aO{{fx?%X)CBpV?{&Y0GAR+aK
zL6U9PT_YpN&kqv_U~0$_kRgM(g|q-)y)?Ip1Pb)-v5C2e1d>b2cAAx*w{Q*xG1+80
zUQrmsM_;iYK5$nvbQ5B<u}c_&+9n=k#7sCJ{Uv>Xg4@b7De7Em?JLh%J|4v|>yhKi
z=URwzq8HfQ!w3otyp~f!dV<FeN5@`1d#f<|e(h?2oONp$fkRzPio?st>ng->Nn$F$
z1U@RirhW26+TdHQS<*AZ+r-ytqtq*%+N5+Y)p7c^aeb$^&qkDmbt)L|btN7(Tz+Ft
z>K;YqUQ6_zCPI1deES{{If*c_o$!uk$-QRs%GUhFB?DDgHWU8Xv)l~g0$sABl69{R
zjJOkI=rv#cQz#CccC9A7(&(d^^R2Hh-&|eKlz5fzr_M=#?*91j+G<d|J5g@Qr^0G2
zlf$5-^x?aght#+^JzqS|bn=qYuRqDkNw0VLRgjQuYSvW04~ruYC5InH<efWjKcz;>
z-VS2h!_A{OyO43x{b)``;;rk=?6+=Nne5xMCway>NI_1b%#fYf){(VJ*ZjePpI_y~
z(e#<y<sD5w7k)*2U2oeg{^PLtK7-u%+53kLc6N)i;sL22hjUvdy0G2kndBl1{4WO@
zL`A=fj(qvgKS%Rv#TdNX3estuTpH(g(uH!dl|A@gDE>4zSB{P<828e`$9eTI*ScX_
zkkj6n6K3}|EJ9|`$%Kt-jSfe6?NShoD9)oxnsAmg4EPdS2YuE8hu2;i>;9Vyu*xAu
zLGFv(u{G&Q>)-()@q}74{07gLdwEcki?>YN4E(W!;tnVh=*?MX0<#5;%rvWuf;_RL
z#E|LeyvWuB{rB<Z5~6<cJPHR3Cx(feRz`Ez<nKd@2=y=cWk?)tI@93@2hEK$<E}$|
zd`Fn5i?i<6nhjm0f+7e6HK4w5_Jct!egvVv&_D{3Ff4s!WI#*N)|sewQ<B_T@qAyC
zY=jt(9FtPIu7HVK%iP;c-M65|O1>Ub{P;5Sb*#C#bnlnXRwKs_9UiNzeVrM@JRP;R
z@bqi0`RmwkqfhI;nmT#6NNE>_Jqcp;7YHV*xH~AYTPBE&3xvsvyNb;RvpRr_>Mk`}
zxi2wM&v3m`Bx1*|8<kJ5%q>7OO?arjLf~+Aj?O;1Jor4t&|60$ltEcd@YQ?s=%`n5
zr`DYsdp6k$IOjTe+S@E2KHQ$#M6o07IcJMJBUgz8-Ity+;S|GW@9|kx&M>0nD(8kr
zfUN8<HjR5WF2U28ekONl51!$<rnmiW_qWeAlzWahpL)&jV5)wLiT6>`BLzmy^G{;L
zI{2J6h%H+0ly6cDX*@F%H5q*mqRv~Y(JbDj&5;w|u8+L^uz&w-1zW?C(u~!fJ$frO
zhb_0pJ%6oIom%rC=kju80&Bdvg5UP83B)07Z9OZ#p%M=&g~f>J{ql)KiSPVUCE111
zR;Eb~zb9LxvbMYG>+S)stK`!zEpda(?z*~u&7~!^zwRsqN0>iSu97Y-qadH$D7h1U
zQ0)8nLyn`gH<@i!*@@DJlYuo@+SpX-SlQZ|i$($R049&fmC*I=+vgt+{yL_E+6GRA
zl~44OEqw~Upih(8#r7}+`F@KsdBTAG$%=}d6y$(<I2u6D0lj&3c^SbCOVG=9yL6s`
zsS}ecpLmvh6?^P&TW_|-YZB5ssi;7Bcwp2EcC?<B*469Rzx7t2Ee^iN2jNFxqoLhQ
z;6R2^RRw}6#ult5CzBA?-<K>zqYxFb*pU4oPmyHR@a!|Yc5S9ejEP#w+WK(3FS>Im
zVSHtY%*??S&+4K!jl2|0!MGVU+eZH3;MHjK63~|B@<VeOCZAOnPioCj&mbD1Q{eXq
zCji)1ePQz`FVJq&@7Czq8TQC~U^Z^bZ}W201JC8-PrJWh2`pt#w@ro<ICgoB{wypm
z{K)C2>9Vm$p5+YR{hra^PRwFukMGatO+8-KUm14HmkbDaeJV`$^;@s=XM}Br9XBro
zQe0r(6n6eJczjZ3;?MinC%jaj7Yo8Cv(`M1K+&0UuBli_ZvZ|he~><WpUJ*myFO$0
zB4B&Nx65;1sx1hKh2jf~CLOwOpZ<P)E#van4JV6^_>69sB}Jv=J&dhI`VNsXGr>Kt
zb<(cW%Qa;l_P*jnx$bkwx9X_dPG&`B=9A{;*D1)|<F%F-Zg@F5QU#d&+@Jl0p-`6H
z(rWM^Z}Fb(JffMqx8K#*ue)wF*wK-7gu3<X(-X(E3tR*lE7K!{-_(6(y368}@jFpH
z>|sR2atO09(*x3dXNlXjE1b)G@VDjlFPGK^ynlT>0B@jaqsQWJ568|=AKje0#2V9J
zZO2$u_5H#0(dtn;re|2u8tYGwcvl2^5Zl^bK7G2srR5Y;Kzn<J&W2lf^^mi&+P&(b
z8{dd|x85{0F`tPOk2-%rZc1pgQE2<}tz&6M9i~hRlBo_8Pd$9z#cD+S)6!{U{sLIr
z%EpF!<b?xlo92~DQ{kz1dIFdiJ?(ZD<mbZ%X}HWn9T_!D1gI;w(;h(QbP2RC>Pm1<
z0QI4=uR0)TntOO94Alns9|=uZeXzS)I)mo-QaM-g4}H&QfxUH|olKSKs5y59DF{WZ
znh1aT1Q2w3+0*l)mg~Ny9tRVqT$IJ&z%|YlO{|W+KanbLE*{9`^)=!~3W1v1EUOF6
zSnvXorvPGru*}?*sww)|1hlE3#(;%`b}rgY1P;hpK|k=_N(uM1oZMWO6OYI_jzXpc
zV;{)&p({e(Lb6UpXD-fecK7U`KO_PcXdU=G=*@r@1dhf91B10**M1YG<HqH;NtV_e
zilb3-@&VLnfjtQe)62QO2NfJhlTe1DVc7BM6TydAjZq=kcPNdq7ePxv%XUWJcstF0
zC#W1C)Pe4%S@ULDFX+-ROMxHlS?<RWAELcOFDJ7;--_-kpg?pUJKpIZ99h_VAni%D
z_3~yTy_kGn;m0H`pZbxxTLI#C*8|ed5L&*see|#`a`8D<R-$(HipATS7gr{o6mQ+o
z=6TM0DaZHWdf?@sGIN(^pXR01ibuQrRu5*A4r#lX^JTsBm#O)f%i1i(PDPjEQJ1SF
z90U&PUG~xAYYSid{B}PVxbmZ8C3Kyp@=<W`;M%rLHgfey%OW46&rQrF{*DVQOl9VO
ze!*+<DpRgyi>ApgFAM#=9_CTItJZJ)iI)pL4+ri!k!C={8&-JlllH~$3v98|m9sIp
zdKHz-2_IG-cdwsk<*VOz(K4UtQBx7f&T74!X$FV(P(i_C0kp>+1bH9l8OSc&e&b%&
z>9adnHcgTfPyb=-x2qr9wOjONg+dXV&O?BMJyPa%FY?3B@4NWAEo~46@rO)({<y3O
z{uXVsub_w-KRp^9(_JsvcH+juvbB8Sv(Yl^YuEU)%;}Waycu_jFK&ClWHP&=ePiIe
z7*jxO?7T%2tAMKKyza!+GZ%E;FAy8MGV1K+KIXsNHO^EaH$wZNjz`>7How<UV%TdP
z`mi>7Ig|dPcgy1oU5>5F+@_-yAbd=I6LbHikr$;3|BK1j?ePiib#u<Y(oAfXDtjJ0
zQWpC-y8ozUGf<>U?+u_uML$x;Qvj|v6|VhWjI6AE-@btbSKu~dY9gjVr_Tp99LW|1
z9ppj#5s=x4-|$k%8qg14DcfAv(9v=I^oRq!b!6~hoxsXXx5OQ$Tmj+XyZYjM3$5H>
z<Ngypbok7H2m`(bPLF-8tU^3I$1Izlp(uvcO`J*!sZHJ9o>NB+(u((`0-_xC_PcdI
z7Lwil)##Uu3|xb~6j|7e7I-f-$Dz$mGFCyqQFBj!B<*>*h%%khpGF*HYjd#KIIp8~
za3i%tM`50|h4%b5Fq56OtsmPto;A?*W^;eO_u82SJJ%TnGlk2F+lGft+4e5XW-|S}
z&OKAVw)Y8012@UiA|eVVM6Pyfd8N~u_;C1PM|rP|r-Iab=<s0+b91m37Yc8tOpQrO
zX34KY3j)<%Ttwido$QSuu7be=bu<6V`*vp|OcWyGUc~A1u~$(%yGwF7{)htz;N5h5
zzugPVq>x<|J4|+MlWr-fmUHTrzAS|H;-i0XL9Ue|Ma=3g94utzdC7I7<}QT&3U_z3
z5Vo!#+ZfBb=J$|}tn^-E2r;h3@+kk46~Xlda<X{?4-birp8Ceo5LW4&q%_}0<hO+t
z*VfG;2kMnF+eS8RB+D5F+B*3C%=@J!i7zWP!qN`M%Wjs}HEdZ59h>!yG^C9z?>@*L
zk95`#2`(s6RS8F?c~&>_50gHc$dS~oEkblJ50R0n!(*ayiNCF(>9I5|dYGm8ja)|*
zr*>^6TdNs7=%-E>wZ4;ze3jw0aAIBmUi-2`WY5mUY0w%Cvy7l;I9>gLOLPlaLR(_^
zytM#1nx~$8)7d-7%12jTH!<S}*l!V~$jG?ItWTw&b6U>0_Dx=X8`-l_>02MihDV9`
zFiWYYjkl1E4RoIr{C974Y<+8i^~AWQ7a1X_Z>D`&%7h%_20n`T%05d=qdT^pjQHBx
za&0<SWKGc|u8%EXQ;~CuZsM-{z6)d5tt#lrZod?g-)S&v^-_rJ_Msaz&L(5ByLa&2
z^Pv&e?5E{>HvG5s`G4-*ieB78W)#eGLgg7lDbJaY%<??9?RI4U=RR-^C7Dr3g4Ca9
z3}j?pd;iO~|6jC;r}xAhyLP9fy<;Z+p7oJ3x^X+Jmr7Y;?dQ&VPVdon=nFPrbG6`d
zzGW@nu<qefex6d+bznRS&FgXzOuD(JXS|pjf=tczN(A8Ql-kX8!M;Lo=U<_94penz
zPA%RN-b>DXbxSoG?QKWzDJ<>VE}J(nv8B8tM1gmzH>bfsr~O8HZ;Z||fy3RaH>p5u
zW#9EKrU?NW8e3BlmHRt$_9QRZ^gl?;^qle3x^eAz@SlZ-H)o%hsOCIjv8m^zovM-P
zEw;@GD_nawp+k9@>H1;i-a_v`UN_Wy#MU3}L(^l`)z12`vZ9e>AaVAlYrJTqMbkoq
zxj4W0{Vz`LQgVkDzS6j+ZsEPG5-+q+yJLosIH8k-ckO$!d$i<J&asvpvGzBId^)b_
ziBNZ!-i&(}^!`<@!>4(^h6A*6mYeY`-*#S@vbHA5U6l-6&X?fwyCkSD>a&ntxR`_Q
z;Gd-z5{$(~Dia1ueww4-+>G>}zhieE?-@t%9Hd=e-DlOCzn>=X09mgu*Z`%r&N;`-
zcJj>5SL^xiN_xn)@uR$jMrQqyy^PR^xxqQ>y6;Dx?}lB%W~R@lW|I?XAKzZi3#%FK
zU7lN6I;-{a=(ip#tp{oivnsFWj7A=^jGN!MdZOoQ@~Z+x(4YbmynC{T8M&_RlG?iU
zm~+VUvbZ?$KH;J14X)M7)W%4blU@MG>U)M3Lagg~KaQW%Nl8vY^RiCm+}?($jG@#&
z{qJ=5+;rPq>pH!!VB6J$s{4O*4@j1OzIm@M@sk#T;}m~RUFP?aPikk~)4l6xxvqu>
zd2<OT$n46rzZr4PwznkWiqR&w;IZ{(Yd_)>C3%9g-n5X;6shMc-VxAEXsUP}Fty1T
zy&$q&TbD=Ru-dop<ae?$TGAHpO}=JU;jJ4&{PMNk!$|8cQRS?vJ=2hAxwnYir`HK;
z-=6RGYtGhle7Y_?f9>~N<`+|Qt=9R0N3J~8ivHW4?76nJ{?FfmVEe3IRZ1y+v799&
zDw@<CRHfZ*do8l4X10Ce_&dXE<|a8@YwXhDD&a7W*&%bls@sQ5di1=?1u(J`OFSO3
z5^6-==A`_%X8W+4pdlKf1k)~V2Jc@}4|5+r^i7-@EGg4WK14{2{`uPWoS>i@Cp{{5
z%R7d9i_gW?>0UNyyLLm<3cgu>(n`=O9Rb5*U_vRyJHIWg*34J7c~Hw&_O|P0Xbdsk
zyM0zB&5%!sKRZ3s#opol+e2pv4MqoYU0QP+Yrl0aOo^nf8S=sE_F2b?Bl~}R|2`cB
zyzbk_OZg9=fsq@l>Z)VC(pPe*u4Su-oncw@(>aw(>bB4PIRZ?Uc!_eJ(rg@6!#8Vp
z?<^Gw2s)>tYkx$cPC4u`gBCN{?fBanxaHP8QYG=`$v?_G!#0*$ut_VWiivU#7hi8y
z)w<eV(a864RkA0@DWB14s`$Jzl5_aSl*+E*DYbd#<@vLPBJ_h#m|cG?2I~l6O2Hou
z8np(V#1GJ!vNf_Ra0V$b2#rks<mKXW{QW&BVEanOU5`}C2fM_cC5j!7@h4utaihR~
z<pg{YjE{2q9nEnj${|y2P(CLp;KpSTsq{QUul~zW($Ci_$AjAqKU5P1pD%qQBb%on
ztrhFzQ!CENd3NPYY0Xhucg?qNPPe*yZe({kQuUV(=H+aoXpkkquJ)y4#2*@JDTB!f
z;dmLFC4vWKs?aV0A@|kR*%Yb>AxGxHTOvbktq-zGit=0wlH*HHS49Q$RQun3_dqyK
zLhR~-fg(>z{HUba2U9V}b24-tF23w;eHC@1>ir0U4>lDnbn-%E*6n|P-;qbprLTW^
z+MiKixv#3;GykfO2IH!QUX<z1zFksjG-R@Q{anST=*gx}m@oyLXuHY;XnwjZzp)hz
z$&yY5nm50?U%pAIxKlUU=oD#X)obU_OkHbxXvVu|Se=VsX&LT>tlt=ao<0{(Zgk)_
z#HSFf158>vKWbIH>k%S#naQdV1$aY`w{UD*GQcUBXvdX&8@T|!{wo8igpLma7`WyL
zuAP9{P+eVcgZbhIx!GkBY<i<7KSOvbC?H_Fuy7jIS}iZBt%&BO!^s1FnwFMhs08Tc
zP`ra)2ww@Ka|I*?Hl)o<h2&(iMqgJSae|h8G<j?oj#xf(UNWHm&Sz{fdWEhcz{r39
zRH_Bcr9F@NbB9A%yBQ<l2AyfYEO@j0$X*8~Kz;Jk6PCXZX$HvjoPMZDh;kN<p83_q
zkWE4!18@R24`N*=Q8R*c8HAA_g+Yc0r2{y;&|c{LoF|LL$5w~n6xah;@=d5yMU3I9
zK`Q>vfQnJy)TE)T%mnLRbaNyQqJeu7yh;cSFim4eD>W4roHW3||A9tO$b$zY7cb(F
zLjhD2uu(_NhfEgLU4<vf!X4sQPz@_Ld!ge4j}8X@^m3$eJubg4%gf(QOf-Rv6YRgh
zHOG^&pjg8;(4oKpjA&dRKpIXzPyr#s)HW~>fMxT@2+6qaTTR3^SYNY2KL%$HfI4VH
zC%uwFU6<GIO`6{Wi&FUGf}mu1bt|kzsHqKLB!;^{F9#hDh)poU1{PS&xHO)cfD{{$
zIt#Shj~_cgR24t@6}c+}9#Bw_95K+;y$mTIx?2&az(c{{L{rGwP<5)Qg@8ss_It0^
z``-`!8jF~WN>R7sH`p9sMVk!hA(BY21@~&bfqV-Hx&)@8fy(Y#vW09Qp{=g;HVDR`
zy6D5P7kucN8uX2Z=D0XHp`r?9kuWzk%|s)MgxqL?<BvOymL`N5J|N)18V+NqOygLa
zLrpp%L$o~l4K$pU;ZPaS)6qtjU24Je1s^n3EoKDcX|CNNB%&?fSL8~^cH%bC9kYGB
zy-Q)c7Wj@dMGF^;jv1)ikpHzo0Roa!Rm39dXVCABGR<nytcIq!V|HfQi{-Hwq{?X3
zgFlPOTSl6ix6|^`14q*V0yQv6Q{ZWi1-n%FfMn*2Au9j;L(3wb4dWKfK{UAz+5jBH
z0K&l-TCdF83&d%RAW}R*a?r=X!UNA9#l<!JaDX}Pw2q`mR6X+kMo4A}6nF5X@n|V2
zDHkU?G*s2$NkUSo;2j}7Xz3MvVPN{ukG4oR|2~B7@J9iU7Y5r5kSEvdGQF-1H5?q+
z%erd8Alww%QFffVY(Iw|ih1ZwFuC)X(^xZX0)e`r7@;#V2TKwhF3cKC&(5AqFN8P>
z+I^xN9AZ$kLA-JZ9-BVZFwleIVW&UHTt%*S5j$3vmN4|?C$@<j6Nv(a+=EvC7F1j?
zsrKHZK!Bl30X7^bX9XPf>MP~3r6I0_k^<8<aX?52KZ3nE?k(0uOjHzyUvY^{vDi4&
zLvVKn$>8HAY1e>`gq1luI=ToKSh&%=18WIl=fA@$0n`i!V|ochdLC|W5EBUqp!_TX
zOA8(qL09;&xx6v+0)wvj_+H`3U^Dh3hGDgC-A;|ohxd1}w;$_O2Z_oc!*rW;3A~qu
z9PjuPLg3k0q_0{~#kM1<NLTVmj=0By&ET3Ho#eh9WX%z0PbL$u(802iC?~L&iUZPY
ztXWKsGZ-|5Zp}a_Z|>)kA|cQy2IdFTk1G25u0*=I?f{1w0tYxH*7Wx$R1RW<kLO~q
zE6ed2Soi>ol8i5hjagN7b$ffem8GSVju0d!=oHt-OLfDV8$;LttFjD*VxlMill!B3
zFHxi=Co3>rVfRBn7yYQY+1a(VH3)dDZEb}vn;i(Og!{j$vNEo;d^9^RuMVSNb93(t
zffwR}T?O3%5FqHXFqt&7YZ607XqZGu;;*i*eLe@xgbAy{Ro@lrfB$}OkRZvR;F`fS
zWWA^K3mMt8-SWXJw(6W=+u@>QQW?;6naYk1W()~WNTZs{R(}^E!XTl<$fUJV=TS3>
zU7MaT`ff*9t*@^~!H6oE8a8ua9VbzNq4@hgx|g7);ChM#SmZ1bLa`(m!+F4(fo27w
zP}FG8Tj16Y2`U|nIB8BPx)+{ppZfc6O4XjF?0xd4<IEj}1$MA#h2Je2HcH6=?9_+o
z&Y9JRy$_sZtUGFIYU#tL(Tsx_4J)L#!~-q*yg6ZK0LnrUhrfM*1TpQ!i-6FPaClza
zkftwjKY!>SG!?;<Gly9PpzNiW+c?mhqzweCnOj^7WPHf7g@rXvrsn28RZks0Aq->?
z0d|KBL#g0pe7m#rq=dw3xHg1JPotuirw8T#x`;l1&K1*u!)Y&p0{`~e92mQ$uHdZm
z{tDX;7TV)8IXLqM`oF9`k^?;tR}WF7wDgtv%$6=_oDu$EZ*dtbPFtJQr-Vw`c{xiO
zdTT(6FJACs4jg#ZbOgd!=DLCB9hiQeJ9`!b&PZhFQRiMv6crR)oa`cT8URvaox?s*
z=IGJgWtKDtPKsck0G5Q|7U(?{GofhDJ`4)N%r%?i5+_c;1v#^ltQ;n6@S(xnSo{?l
z+zUWua6c6Z{s93{O(F*<0R11{7GUo*cXTYy%$z2`IUbB!47>_zFvke89W_auei)1!
z86E8o;x-^5a2>JZhh8}gokKza>m$|+SUvFEg5?5a#6lDA7~Laxoj3j5KF5_f_W`<r
zEXY!^zwf8D<A}!;$APViU{9}wyZ6r=0m6ga0gOvf*y;8kRjwxuBm=MVl*?r2{XK_~
zFaZTNHa3pvki`0e(K@yQt{iT;(2&n_A^<l*QHi)lH6>54$jyNJg=u#=Fs(lxbHms;
z-Fw}Auz?<w5X?j*4PJw13aGFa4blE*_Tc$IDme;L6*lL};#3)q0-<pD%8fyxg+&f<
zc!qu}cJjYC@89u*z*51qEHwT=UVNhFzaz=_bKfD+Ey~6A{Vz`c<zKRfh9v-!fLdb|
zb;2-=7+^tC<RMkqRvGKm8H7zSdPa^C)MiMYK|X`C8GL{uBQL{m!S?#~JBt(KWaTnx
zbR|8W*l-BB*d_rb<fTe~u^zI1ez$^Cq^z-=^4|pRPhJNPOL<xzCH?IRyJZUL&)XF9
zi6nme(#L<aFRkmx9B*#-U7_3*A)zl#7)qOuGd)m?Eb1-h4?ymX!1O^4hsO2hXQ#JP
z(oWiL*&ECQ?*R?8h9<_wsF{yX+SwlE;7G)=3YmCP+Al={^!q2p#OA=#n-U_;oJ^t{
z-!y=117|BPu3|@v#^#fAtD^y;h9kx2(Er2}xX7QwSa3fyG*$D^lB3hcKG0^sc-!pB
z0gdhmb!ETN5)W;g9g~wM059&thl?=z7pgh5n=ons_?!3ds~4(~^3@peb;RMe>`aB=
zw5`3JC({tzsG(}AmQ#|f7^y+EkWV_ssrnasYD}0Gum;MaJ~4`GmT5PuY$^Alhhvyg
zHK(AUl>LA#bTz;+(U*Xqa!~Trj~_fETC{-}FvYv(I@X-{m_Gt)5ZJ6?eN6w61q0|`
zjj{Ar9&#Uv0Uh7UK_@pyIpGUSa+E*wc9IkU@VHY}QNf{-o|iW|;|4JZphqa)_DOr@
zzk0<dcL-)x$RfBIUO{7yIKu>w$P^TiaDqm@iCqkw4_^p!2-l#9ql<#g0+R}ots7J)
zIFc}24-JW$n!svPLrka6$vKAk<^AFjb(n{Xbd)``=A5c30t%!>=(?fPM?ubkP^F|a
z0tJqfIHX%%Fww%5;ITl41$EH)^h0rQJ2=Cj&Kn*WxSbk{KY#u5TKsM3M+`85?h?-m
z_W%-MmZ5l<uD~1e24Vzq2ROXqd)y49jv{8;Ib}fJg~J4`J(K|OEAp9qb#1c0$^N||
z@8`psHI$!2XqMhOlM=Vd$u$7?5QV^aDg|Q!fBZmG6K@6myOY};!Hw@8(g|ts^~Xb5
zd6A5LEyDBw^zFyW$<VbR4$Yi(K50XglVqJjSj28cqPz6IO6090Cq%l_fBs+)`WZsp
zDaViaWbi5DaDqVr6eFJdH3Sh>U`L_A38$EEU0pj)^mcY$PGyz-Hy7ZLWIfztF^&~w
z*e(VJL}cW)K+b34ONHnP8u^?~YNADNb@Vdc6}&54F>I7KKH8A6z~#h`2y2NC{UHp@
z%!he+axeo9*N4$b>AG*x_Ci#JMjU%?O&}pI&QMqPB!n*zrGm2VIVopik|@hQy|~!X
z+)U&RHtEFW!d@6QR50*{g)&}TR#t{-Nq0y>)oFhy)s(p}pyq>+2pwOjfC8F){`_o*
ziOf?WLzR>ZVxpo%Ipn!0g$zqyb;A2kOl;TYO{`-CTK3|fprM1%05ffz5>F!{f=fri
z)+E`8p{BrzgQrwoV+Qk&R16HmqD>k{W0zE<;ox0L`N7tG8c&wLUjMcC&|*`_!ReAm
z(b2eB@V<!0wOzc3R18^xCubNFBjdqBGjws#DucEs9h@TmC*Kl>jS=I_L{G7^8)McZ
z`1eEMKRr9y{ctWA7#P5qi?ip6Aun`|cglKTJ`@H+yS;mdQb3%bXZa(S+KTLoQ9xJ3
z>Ps^A1Bq69CMi%40>OkP%(;FIEz{=4q6}QWa1g@L;YvM62Zui`CBGaPz#W*agBk)E
z`Q~?%=9<$$Z<l<KB7$Jp-VVMMdKvro?Sp_ClR;7FU^$CMy-i8+CxTQ56Trt25eLJR
zp{!b>lfaIIcoAjtPJhnm5m@76O}x5z9fnDmH&)nvG_>Y0ei^h@{v<<VZ25}ChReFT
zsNaY|3SjS{&;NHSZd#gMph@IOY)@zBKPWlywoq#YAHM`b0Mx1&(t%WQ4CCw=_mDOv
zZU~;;l5hw7_z<VD4|n>D!n}c&LlJL{GA&3U30{7XuaB+X_jvEEcWACE@Wjs?Bv4|F
zA-fzm)*sybV}g3(#<K9wi2C<*F|GNxcs`oXoD2Rb$NN0@(%11}XO8e&bZk!Q-@~DY
zMW%=D<MbDFE<~dw!DNBpxFupM_ATxJ5)@97`hD8^mTT3)_T}_(2OXCvSh}5sJGk7-
z{QS<ozS6|RL<GCSLfA{)&!vO|1}yC^{GH$l+Ld@*pW!8BeKUExF_;}CGBQG3+L6GX
zgHVZpiUU3wW+IXHKv(5#!(a47jsQ+sbYx_Dmkl%`#cZ&gQ-lKwQtR5<9h=K1VO0+Q
zsJ+1{&z?1NY{SQ#Nn?dI5tzBXUY|`fpaemVv5^LOMtJRHI(3l3&syssSoNhD7JVGF
zhY=H!e#KTOQEHo-EHZSF1YxF2r3EC`WpMv#YNFeWs2nsiH;3cX0gkHCIcRMab|LD+
zXdN-!O}(ltus~wARsJ5Ea0s^=i=SrQoWP%Z!4!N}e#EPrE?t9MR$`-KE;o!fZ=UyF
zkoyy^bNyohpLgDcZ@1hcf;=Bjv(mKaGrhdXk11R4*pT7E(uRd4WV4$?e6qMs{2<SP
z^3H$XYOpF`2b0x>ppM-OsvB;#lQ_#%z^)1r0px_hcd&k|O@q1^1@@kEihXqF4he|R
zpe@j-(7|V}aN4LNY2KdUZqNo^wY7cd8mj?EMEQgYtZC43*H9FqPK%C;0$qR6H1bM>
z@4ZI=en4ojwf(5kFvPf51Npta{wj)Tmf!b5$0a#|!{r9`R`jDs?6EKaLBw-IevBdU
z?0yIju;;@Z#v)ZoUS4pauY-$=kAzoD7}BQ1DQsT}gIn+G&E4c`tRSD=S%~Jhb?~gq
zN@dF1w>jS$G#@!uT1hE#pVkQe60oNkAM|=`$jdX5K7NZ6CsKJinT!CIEErWJSb>>Y
zqUUxrqGwOf<nS=p!Go?N_4{V@u4Q#41t#G-6lhQF4OZk0=ZG&qjb6{DB2xfnp5iOL
zYZA*Jmkv`D1Hfu<K!tRXhsVEZ6q75<;4WJ^c=Y)3OC-_@t_h0}urrLgQ4q&8*xK1O
z)z%KqxS8exKB^y`i;0egfM_~k3*gn!IovKqoqynscH{`in?L53v2hWeD=zspB9P+1
zsLDQ$>7f-EwJpE35~VemzzBPI8EPg)nf<36xFhP+&YhDd0H=aq?qHq@fV+#@>ziV%
z$ZLV-;HjPA4M*_sFx(Uzr|Z75nGzCrXpKgV`|%%|Ydw<Mm0Y`@t|?PRw#+HGSHKG!
zxi3Bhpa7(DC>@fn@`J{M0wTzD2X-6Grkr%+<PveguxaoVebpG)VDY1-t&OBufX^ZU
zQ~92Qz04c_>iJwmpeH5)kXFoJ_UC;i>Wa5ea%AYf1)_wFiU5W!PF)E*HcS|41;1H?
z)xnVUWj;;-gg<02D6{~$_%)-PK-k?FKDZYd?m*eSx*x2k94Ndz+uD)e`O9#E=nN1A
zLHG!@7(SVZ2u6^eQ&$J!9z_hu)=C5#R>{c9L5v}x<uEfb;V8Wo+cb(+cy!G$z60a9
z{T#_~X)`lJ{sli1fk|6gQh~(F&8?uQh*mW2_+a@)BY5r@vV{K$l#upAQ7IwAgprCP
zO){I%#U@^O1-@!hB|8ja%gQ!^XaE43@z8)Q_R|jsEGDG~OdN%gSy_&%st<r~0e75=
zU-BcG8cK6ryLu)gb9`2-I{lbh;NtY-;h_7U@0+~wh){Ng1qI$v*dV{Tug})lcmRuc
z1vFq1AOw&gQWfTJrh!F<)9uIy037gY#0yCO$76ww4zwq3u0g<Ape!8Cufm8e2+Cw+
zjBpuFlicbUy^9|L#E9IkudfdRb!fHmxIj(s?uO0fTzH^?E6z-1q>rI88{o0w$$t!e
zgcH$MmVIQ#c5|Cwypt+9ne>iIku?T?lSo<i^35S}jm@jBtQ!*>8(Dm1*RMU%-u&7s
zHt5@9)EMDLZRzZM47Zd>s0tO=7^dF?PLqt~xDf>@eIjXf$Ck**JWm4(^H(A3XPTi4
zTo=CkZ@Dh1?^@0{FI?Jx;I<DFNxVCqQqFXCI)VJ(uSSuBum770*Arph$M~(UCo-&v
zQdf#l%M->euggMjym6O3c`3R)`0=W!Wb&amZ|}TD?R(-+>G0jkK~kj;MGin><l7iw
zB8NFea+csFBe9+2s`da}2_g5UIVVmV#2BcFmdX$dNqulD1%)a+ApeAgX2fA6AcIS*
zcE~^iRdAa;+}SQ*totdvOhm*UDhWueiyeM^M(Vh7dFEdkCwGjwu5Kq-MSh!)F>uCT
zj>Jj~1Hz6`sTDJeYzohDrtfdtN;c5lTK6akk5)p$134aG3T!&K=zN8m9946F$9<T1
zadc6@KME(c;wVOS!ZzUw0Flw4>E$&*)@2D%@M(jGGM=87Aj!6h<ko@FVlboJwR<;|
z^gNGA@*ycn$$SIbeqr(urRNu3+4pTB^9*-C_4JN1H>aOMS}?q;oO}Tf;g*0~f`c32
zlq#kYBy0j>0Ad9g7k`OU4M$C@Wi}uO7)`C?CZXv-NCXH0v>3Bw;KnjYNJNx*rIiX#
zvQKb`iYx`09^(bDa}ae9O_5_^#te6~FJ20<7%(?z;gL_ieD%r@s7Vp^z1kSdXzU0S
z?06thl`zH$t9ruH2^|HD2Rf^wGBmdg=#pgk7--4G$7hA73L3M98T9zb?xCOhPdy26
z!N$1)2>~Wjc6aH^rV-m90){mUX^8u`Z~Ta2VF#q4F=KlZa%DGa%ven32JI8RS2VP=
z0pYY{1N!ZCmv*9<f$a;D9i-+KW@aG7wP@h6z?T<>Kp+G)nu)sp`sUw6lHo(f8bG~|
zfu24CUNl%0@WsH{C2{IhSnYSjSkDYV!Z2EmjJ&rQ^W;hO4+mf${Dnb4VQ|5~yV*`T
zRJFA^VSTYEi9zE6UtE}IIAXdXD##_CGTf$3<xjo6QYb|^vM~;9DHKn^kII<I<@+c4
z{UHkz=nX6lha%B~-_@9=Gh9PpE`a%=SY5_Ux&Ipbg?@q%KR@&Z=K+eKjQ%-T3hPh|
zU?I(SBgI&YNcB{b(=JwK3~ma#4tQ#)Lg9{03)_V>2aF}b;)DISudF>lW|UqC;<nwn
zAvMDse)w6O^B|tWJQp*GEP*KDfJ4^{FTq3L@`JM|7A6V~q8uLC{Pgsv#>RLF*Y_Bo
zT^b}5j!lVzn@4U8jR>d`AQWPb>bao+2a7qBa42?Bm`WlQOc=++_Zk!YIC?x-n@R*0
zX-_7Za@e%}8XTNK)muzJS0h36+GprGz~jP~@C$M@D$sSoF^0+$7X<$7-$ou<75jly
z`R&*>eZj|;-Y>8U-I3Y3IVcZz&QM^_eqEK22KwlZn}Q?{&<^r5lx|*lI7?@6PT*da
zr=ky$36>gdpnS>&C>jTmd;>gRBMr7_jF%#rjvzEaEQLDaub2`z8B8TVR#hPZQvTO)
zN+>2#OD5?r!Zdqf0e(4zL~K9wjLJNh8SL7L@~YdbJm>Y=hkpDxhG|rOk077MR>$Z3
zY%GEUsOs%34r_qnXqMnA|2pBIM1p5nPj9cs7fB-g3o*|%Q4_YdFvI=*^JgKV2#k!@
zuy8<#M_G>%MDfyIg;7x?;kd3YQ>o(qkdg1-oxmsqB7}3c6Y^|GyTFu>k@1oCmuva*
zMMYhmH@p_Vi6=}Mjv@%53yX^~FuMR-6F@R5EliUn%E4cNkccpI^5jW)<N`8g_bXI&
zLB0=<3lc;L=R6$5)dmm1a)#dp(uB&&O6Vx@h)F}efA6KGrhc22rlGD5)5zPnYw(ws
z8w2W#>8||{(!6~44%P2(OpZnfOD)<B<Qw+Zz=uwn*E6BA@DwJ2w+9beV2?S81A6I2
z+(NY|C45Ko?@)jbaA|y)SMDpc9-LQOZg`PQS#wH$CyG9_9ML9&+!*od6gqcG&j%Te
z*Hl6)<$>cNp~XEeE-CS6!(3iu;%Lr6ZcYQFA2;a$Z7LLY4dzXeN4S7~V$upwFJLfn
zK7A;{is!a*B*T=ForuU@Wr6x3rHI<i-Ti)Tw}p1F<+=Q*sC}e?O)8$s|Isa3Qwhk*
z$Uuh@wu7zBOY^&EQ4=B%V7WrwfJ`n*6_Ws;0@lGC2sx7b8j?%|c?jBI>Mp>~|K;mf
zz%?JYW}@IgoFB+|21j<-%l##~9^L;ABQ5~MATg|<5xkr|hU+FxUKFuG0Cig*_L4`|
zm=t%~kQerResnjW{K?49-mS$+?rRV4MVyg1HE<;1mxJ>^`1`jkoD0vNr*FE8ARsLU
zgLimM*~tPGz!z8$PaZ%1DY|Wc2>1Y4Bj)hDZGw^$4LUq@JQ_kGmPu!)F3Qq)#?$z?
z%Gf}PiYXdizo>TZ1jPJjaJMWkZiU3jlkg}C*7FBjsMM<n9a;>XtMIPZ@E!*KJzEAg
zCWe+nzt=Px9Q0=6$vKIh8LHc6X9o&)qeRAZo=*)8UJH{^kyIiZ|D(A#4X5&N-@Z>n
zC_<<-C}|XhCW=sLlA%&*5RuX-8bo9k8fY#_Qi(>21|@_BO_FAnsX`?rSxVfW)%Cxp
z?Y`eU&zt92+i$z-YFMpxp5OBr_I*G0L+$vJ`o0xhqyZ}0pa-d`PXR0@CP3Y^mgj}@
zxfNvckYncItFRU)13oORsGn)}&3xa(5)D3IN1MDkmcFY!?m}hK%GOm6su~*<HOmD>
z&^o^-7#C{w?~hF&@?-X&Pr>v+8CY!<GXCbC@r6~5EzAP|haw$VF{;R0vNRM8G9>Rd
zMUCy(rW}txxeAr&<U`+vzd2_A9zwS-i%ZKr=tIJycYn!1v*4`Q5O|VN96P(ThhYs`
zge$o!CRh~m2zGd3>{M1!jq<}aN`4|0zKi;xGne|Su#CEwib`<60U$21IlS&cb|Y<m
z=;r3OuizsD{ig0Ek@oZFV{_lxdbHqIf+|oy#%fILFq73dOR~$J8?a*mgyetmLa)tc
zFIqGssrbVA^YykEj=>!<C6R%DLns=65(ojnKjKzti~n|lDKq43>zluD;e-44BgW`Q
zsN5R5qaaX}x#>{ZVBEweT3U9h>#4jiA~A6pge7JVsR>$?*F4eI))xjZs@Z*ndTOGa
zQh$8~99>bM%Jt*Uurmm|BQiJ)oP?B&W+*^*i(giCpi=pjv`MzA6RUy7IlgpM&^<V-
z_cZZNtv{(KzhnB<!C)ZbTnYom5M5dG&;X<P1&~?GLwAcVb@3iZfnHI}d`Z8b1zwUx
zT4lA4Jlf(t8tykXm#Q&4z(Ya-MVX<H7g{@{eH_@yFxCX`#V*ju<M`2|?<kI7ZExJX
zeTB6Uwzeso8>A;j+;J(7l@k2&w)g~JM>hfNNKFF5$gRW7I<K;!_3z(1DP4Q^Bv@=|
zX@6~8mpW)~b5P-F^J<M*XXngPyEI$6SMZ784wp_I8&bXC($-ne({$#i&QP7H8}8k0
zjoJal?OMTVdrl7-C?VNzxB1(;=!_Dl;pP?=wsoHy>+9DncXRuoZT#oEaor=wY)6`4
zpoIFe30zFzFK@!eaK6OtB{}wq6GCLB&zMn~9l*k-t4n7y5lFScEErp_Bch|bfAF<b
zX9tCt4(;9@&Of5NdFC1;Qk(iV{wT0<HZ!|RqiB%m#OdH@i0}hp<yD$-R&1^XI3?i>
zT#0|#+RBQ229%D`8l(GN`}VCXFE1L|i+wKdm@XjZVRwg32yNLY=Ui#;RjBzPNr*xq
zBjJVH7_fhdkKy3K6tQ%vID_o)S>Aj6mO0cuRI`vVCh+_lZ+zRYXL+?hJ-HA_#R6YT
z+brZDrxpaRwugTec}8~POAVtGmUG4K+t-NDWBxOKi|P#<0TIulIA-qijPKC10B=sp
zL{LSXU=v=sDPg0{RvLLZIouhoeSF61K2eGQU1a?*u9~9NQI!N=1}KRBLLh}Pr;k{T
z#TyewtVbgRQkaH?hl34E3Dku=Ql0mK*BN<MgnCqvJ>fa6FdXmHDLAV{oXxkyEbwez
z@v!Q-)wNG*pH3$94ia^#F2DJT5eTHq?4%-?<8eU+x`itHqQXNXdQ(DnCaM?qZBt1A
z?UFhgn$7qcTsC54uChYj-6)M-I1}PG9VHed3?h>o7@&IbBtI_hu?Bzs_3$3lnACw$
zJw{I1DO4=WV?RcA>yL+sHRzuC=T4qGr=xQF(Ic_J1N1G<eGqfv9&Je1W7BX-<649(
z^r)z+VukPze48<7;S1xEY}56OJD(k^)-s%|@wvq|o`Oc*l*><XiHZ1|l9D`SH@7O#
zc=2{73yZ@sG36i5X!vl7=goVGPKiM)_AHit`UFoe9XH<i*<V*<v8xx~pDK!_MXxC#
zV0I}G@it-%z=w2=k2IpN2H+QuYx9I0*l3O?Xo04(9A1B{k{pF@pGO|i0xkpu9=>b9
zN)23I;who2$gtufov=pUZ7nNI#pN-k_v=bc`$W@Kd}L)j8=<74I)KSMO>cxP=k)67
z>B)rPfX~diDZDQ4&QL*4;#;U7exA1c@q@>Yt*1?!&vGNt{_+#}gD&=tXGF1Zp{~*7
zmZn9S_3>v1>+StHdGYvDy-!b%N<VR<(7e(}vLPfe@_f66UuUj(`lU-${!Q1Wwc1$^
z`(e|*=XQ2OQA+f<_(BF2TC<hMvNoi}&G0Epl>C2u>}YyHDl#f+-t5`z)&!5uWX_+)
zM$m-$!tJBJ>^2bFb;}@<n~J(RW%pgMN0f6=K#~Fj!&ITHGZ^yim=7(4Lt^#)aND_B
zTYH^VJ1fy|Ky8~Km=9{KY5F<IxaH>-E6ar||46tvSqnnEqwS{ngo=P5lO@W+@lVmK
zhZz*9Z`)%nGjz)zNv%DeZQdnc52?rK8oL=RJDTU#I9anzY|7YCT5_9nXm+)?g7qu)
zZCexLORq_79iz|?&2g15ye3){Jzx(XM`TykwBSf=Y(UQV3>-q)7rCz>UthsVi8AS>
z=bJ9EkGXN%jui>Qp4vrQR8@MkehSMwIZJz<*NC*wuP!Xi-_mOCRkS^-D8?}5zR}GB
zqnnrQj@2)?Q2VBEfo<jU{_YK5zJAFZ|9fX@u4~b&xylji<YsFtw~MosM^$pb0!Op{
zm_(DMC_ta?@dCeaF`3Pp4Fe{d$UdY-PPUW~Vc}xmX5}>L?^P#>AVHX^lqn<1ym~06
z)+fc=dZX#NE5)K84_{q<x6{>8X<zSgdtFvOywEnFtf8mZT1i3K^;5>^xvrD;^*x!@
zB_d$(w8U!biw+sVLnRvQIKpL;_SYluKYW8TufNs{Fx@sdJ`^^DFwxBcxN_k27RR1N
z1sT*>fCbE@Gb(vTerSx9I~<F<JB<pA4B1#~!;rWWAJd{woskl9TwP-fwG28<E^sq@
zyt-dm>)6FRW`TZ74#za@?OP$q`c7T%vWAt}H?A!+>t9ptJYeq+ce6m}wd>a3f4e35
zeV2%Jon~wM4|@8<#B9X)*JhP{L+`l6p%QGp@&dy{)ps$S1=fbtgNm|S9C0zOtb67@
zwa}s=`2k;vAc@XwW=Zv{l+xo9LWVECfjPuTM$MwSMS-@HyRt#`;C#tHl)c77J4~1r
zbNqKzy8N97QC+qi%qpC^s$&1aMXye2B<)eK($`+89lrAC-;#pAo%bunecpdSf1QP-
zR^;<i^YyP+Sk1dQzPan#JU#WCA(ew>o&PpdZ?a~V_WkjyLDd=_2PDTW-R@cVv9V=E
z@nGjRZNupwk41_+MVqg?srXx6Vt^hHs?|aB06%a;Ec62BFpetz`7L36p@pV$yUG0~
z^&nCAf4|<K6yi64`zX7jLhAqg^PH}KZ}(GjTB7*PaG#L>zrOMRZ~vhA#JPdytx0f@
z8NSUIr-`d2#4B42Sb2C5sS54%-hz*P9>yFzc$JFsxvN}$p(I}>qP-gr)lA<Z2$N>a
zScG%D5NK{LGecUk;fnYIh@#&&4#0o4w}9d75_Oqq{Cz9FP8iw&Ac;~Gc@8R8-PRs#
z{c&@{71WUxU<os+i0RW|RK>?jFsIz78a?#z1!WHovAcKEkKn0~hNs)~ZZ?iYf2PoR
zZUiCrvDn~$^5hPY7Hm^YOHa?&XH*#`i-igsjCvzl65~xn)SeHK%eR%i?4_kFx5U|b
z&!I#2KCPD!sMJ5M&*1wAfkaT&Y+Yn$2ue7bS*Ddav3wA$PwIdEgxP@B=pX>50W55?
zqR07u$jLv3E||zcWg;g;?AkR@C6b1UU(jQd44Xd%O$;n4KQNf2_u-gOjU-Q2j)?Da
zYBv859~3iSYv@P8+}-{A?tYW>6{H0EP(^k9Kyytxt)=So;63Bx&6eZ{bU#84jSZcV
zAW%F}FMK}?l{+xVoITs9%~Fz+m!!R+y1@z*uK>!M#k~~L{<{_cI29eTtiXB-w&={J
zd9~2m)nnvo8vF|vI*;xo*-#ub$dr>T2nvYc1`odX^l55lrXM4v8vOxI(ik8<*sbR-
z<ij1LZe|=0nV5hskgh~kPMS-i&VeXgqAv(gF4t#-(-Sa*P|m%tl02iv;~@w#3hKL|
zpZ4!}U9sYI(E%(9M#fkHqwzvJVX*YB->eD+nMok6*xtiP;fZho;&*|gV;@0t@ZeW4
zY)he0KnD@KAVm}3(!x8oXJ)gGJC%*|?c&|qbg+evn~?s2V+lgoL>6>@$UfhXc8hgS
z4e=}<L}zUo{q^iCB<PO;B7msb<W1pv4Xh8<ir-f&_Ar%onvQ&W8o<}alFg>wc25&q
zhT;i|F>s&zOZ4&hJ96YL_nFCG7HZQ)B6NkRgk`PSIBwSzm>Yi-tLR`*FjzeEYyKX`
zx#3#^mQnj^t8Hh2EbJR@Rv^$=Kr>S;C#W+N3HZZRh1ejy1FY=!9VFRcr`Uh|%{6={
z3hwtiGtmb}T`Y@eR|Hw1*3DtLz|TJG0zyTnfio$vI;~!;)@dN#Q&i?eXU=bqKFs0c
z4<FhH$XsFUBQ92QkRkE4hIR;>hyV{2xB51!#0eq!Krob3l#3GwsNmuNL?<Jtk6AMx
zF(=@;x5=@ns3&G8nzWQ7QmT^DXQQ?{%l2%LVh!7l+2`-&=cA%6Pl9q@?BHO2%`G5c
zc$s82`tW6}JxjZorQ|T&aKHfRK6y!UF;=X-ZB<;*jBT^7?l&G(T#~Ej)ro6%ULN<U
z`NimMZ>@g)I35an<hdWb!Y0+fNHPKegBp+#%;TiOCngw;9UEzJSN{>U9Sc+ZhI8;_
ztIo~oBpI~C%}q9%wtx#QAy8mLYzcw<4*=@Ae(Bq{TPi*Jj3qQMk|_I1zXDgby0YEl
zYJ_D`+Kn%h!3^-FGI3-_2yIOEqL=F1K%bC~2=A-jBLfIxce1hZ$+P5u@s<30kk(+J
z-X>UhW40j#q67*LmlekW7ENDB-rl~|!|3SuMO$#u@@IUjgHxw}Xv6@OAG+U{LBrt>
zA2tcuKd+gOnF?}$mgngM#=`SXU*}T6Eq-!jw7d|wNDnav6>9@pNbm?M1tKT+2><U0
zKc~QlpWyb}L6wLaoH&qWz(iU-)pm1umy+wACq3?y(j^4IQhxvX7pc&9Bf)KtEA`LE
z;W;O#jQ6F9RO_^i*;+7S-0HeIb&WqTFMq-awhT=<xtJl->(|u<oGL$;mpd<6qG`%n
zu?Ct&x;oAsvS?g$fCRusexB&y!ju9Kjvx@Z0|MHaL<MA)F+-JSwDxT}6b{{x?)+52
z|50RKIU?pNK08n;Fbz-9-Mc_mW4YskFle8)%gEC7m8!by&CLU+d1-v2CA1}5w5gs=
z!pVfmVeB!7q!*4<$9>qHK5UM?{Ze)Dj4?zrtsUN$-_<hkvW8CvAjH<!Y7pXjkS!}V
zZeO1SZ$c*s@P1ulKY$-cl1+7}#`nngqgIeBo^;@Z@%MuSlAwKOcJn;rVbS1iB0{nN
zAjxa|*54b^t%#~0!CHKKEn%1wMAK~IT~7i3fhY~hTJmBt#BAF)u~oRW^;Q@&#tAGw
z$A;AerQ6dB{r;)lHj?=af(p<kBEIiK57Fe;ez<k>%9XB43B@&ha9*e?iC(1%Cn3sN
zLZ73p01YIVV_eM^VxICoNgQ&q^u(ZnFF@Y7rDM**G%v3)Cfg)g3WUO*=vC(V@1c1B
znF5BVb=uT(C8ymoskq!$F`OVtbN;~uh@EgV^BgP&JDLF~?xf(|$*YhSeoNCTe9L}}
zoJ>wTT9@v-oOb)7EsFtQqiNl9?T9Sch2C8X9<CNJk?i{V?p>KI&-F$}0S5d;^$F*6
zM~xmW_U>N!Y=DU?$}b-MS4BlVFd#!W%|mp5AZ#N8G;;11XOQm{7caW(8VMf8_IM%i
zj!Vm*KaDM|7e~}arE{QJeRNxot5`#PWn?5O<r|t8-o3k>F9QeRzb)`8M3+V1RF>3D
z5J0CqW>h-fL+)8xTKedbLK}*YVc%6G?7`2a%YKKlF@s|rX`v;Q5mQ0$8FsR?gqCyk
z?okDr!dusU{`^uyg1&+prO!K+ZC_PAico`pg)>YrWqJperkd<xF2VA6@vphr+M~u0
zufF=CiZeaE+_n0o#6<kz<oisWGG*e{;E4&k?B#));~lq|W^)ZzgiobhRsL*jJ&nPk
z30s-BsN_lU7`uS0zwu7=u3f-g7twj53TSnOT}CUxQ!7v%Tw@#@UDAgS;&q1<U>lEw
z0YDP~(DTvjJKx{0ZCBs5FEN6}>BG{~EAKyefJmg37Tv?nnFYwO4ilEKj)^vXk`M?^
zM1^<#xpk<!CClf|96ugd@=NTog=fF_x36F2Z)w9>zK>faUOXhzE?ybon5k|$lcWY5
zmzA{(mx~Su28)6@NNb&)8^}2vvK%@52*pOoP<Sy`><qiNb{Ii3#B?k51*#Pp;Z#zR
z-I+P4%D@O{i!0@aqvfLDFn)ZoKOqji1k2q$9wK17%m)@*cTIx~^y3gSDdgP(NOgQ-
z{g)Ry$+y@L+>b@s>@!*1^%sL1uuODtk@;}Txsgfy<-cs{5dzWFnj634V>$aFli$2~
zvqLIfkPxW8Se2fjEyPbrr^AjrxlRUHnJ1V^2p$_Y?AyOT^d27=#=PUO!GmSH`$-Dm
zuno&30pUc?r>C$aL86I4bA}ljG=e?LCs)U$=gRoJn}gA~-jq}{;*4(aDwA(z$KRi(
zud>l$!`hvsA}#i!xZJ(F`g!9eB)3!_hrs060j#f}cawUn?c>$UmvaY8GNJKj^qWnt
zfJKyu2lws`UQi~vv-emPLw)qY3VlrGpW2jv?L7lro>RN|wajLV)jQ>$@zEHYtz5Gv
z^d497KTmz14~xW&jYL-T0m<LrZ!dM0UC;Ld0jW+Dv7NZpj4?cN-NBwtviDssK|(hq
z)fk@dt}-2QSJrWsy?FJk`kHtretzylt#Op41ILW{g>av;8r_zra@i4l3q*>$hPceg
zaXStT2E#J$Ze7#5Q4w;1_F4D$hLSvT5+8bp+T8v`m|?`EZjL|IBE_0f#=h8CW8xCY
zf!n-O-N1!|U4L$&xGBqN=`%De)hXe=R+o1!5|w2JH@6Sk`_{0-Aw+wV{W7wyq!Xs$
zJiiWGZIKfAXYR&3hH+|qQ{8UojK_b``9%3MBKjVAYW12mv<FWUL|}9@31a$D!}`B2
ziDgiLx3Zx5LtC?Taksm-mwI)z9&lw{r?%%c53>HgKLyV@<oRH%N5589E_HFCmI4n8
z^d0LL;4!!><=ypBbEMw|{ah62e3;qC=R@<GhZy{r)c%-xm)nU?v~ng76awM;#~B#`
z7Bc8Km_{Nqv$uda>=K149eLdn{YexE@nLldvx&;IS)#Z04h}nwt1*13_~k|=Ap}C*
zZM0|qRn__ok*=|+f!@G@FOqEg8u&CF9D4+hu!9>~YqWA-%_z~pN$gk|Qyb-O2irV7
zqLs(Rxx2VL`#NKa*^Yk;ce{L>m0Rw;_;#OxQ~Z;6kT%#VeB+!uqh&DqQ$=&-uP^>d
z(BA6j2TKCwf)qY1J2i~DsNFLw+?O_ERF<ljm6bx<FP5WVAX;wVP#&3b&Q)I>JgXi$
z9H^jg9~N8Yh6OL~w`SJyq7_a9+}LK`_Q1F9!}xa^>nKFx?zV4Pc{3z6WUzZ}%K7tZ
zbvjR_M1H1-eH*;r$D}ELSYJsj5pB1|h;YxIem@Sk|NfRg#~)CV_)*rt2c!lvwj460
zjS2-zT9c!XmzUo1?H>PSORLBelm*f4_irv}2G2!$*NO9)bahvq4k5SE`e~SEW`U<u
z&hYf*_Sr#DLo5Ed!5ajh`c`9vEBmE1vd#tJUlSFjD6kgbIcluoP2%Lae*I-&5LmSh
z8%7EwVM+J(PoF*0TGNQm|J;QOVN$p16=TV?FN=#~Vbh5Xj9Zn>7$#83nX-b6?~aZ+
zw*$!!EAB}2uq^I9mUZ^*Dto0QcgsaAyhxcWEkK^2B1JL=U@Kpz+C&1R=HHwiL7PvU
zp3pSJ$msg1Q=yNSCnY6S#%d9mknGcF^0elL?Gc1Av41~5?ggVV{7}i<#gX*@!yVVT
zz4`Fr7_^_x@Qvff4;*;s-Mil7bl4gNq0{GLe*h`*N4j*$Aihv<*f2Ir6G7@HEfX8E
zI9`Ws7)hyey-S3+RwKYXDk!+!mGAxxzM9XL=RcZSio3%?YFvStec{0~jgMYel)x^U
zxG4z#LYrb+Tm1+<)RP2$S`0q+?S;UytZQ*!yB5<#7xo<w@BU<)dHl>Vv9)ZZLaf`b
zAG&DycZ;tTC*C0}G{lEpXC5iV%7sFPLNT}0j<(&qy=^P>hp0h6f@?_@07d8^DFLj|
z-ZtKSB3ug-Mz`HMBY0y&oV;20iHWn#{6vBsOgtktfifW=0IbaHXq(A8RCHyB4cGPA
zGYvfwOK3Y-9lhf+*WO;d*tfd+yhDacfC}m&9{4e_owN6d7-sgioIX9Wz*W3$$ucqb
zFcwbK$u7T~zeS0)KzPgy@-N`xklcD}XkcFBF-%rKoc{LpYi@FhL3hI8_4@}Oe!|R;
zB9Lh}_C`;5A7+yTi(d2fD=Q2umaSR6+L!7hzA!p6vgYhXi}km^CNPxE3<h1wn;V;S
zK3M5?6AOSQOmJp!#`_JNZ<+r|#v~}ffk;B@ntLnWd-Ep7TvII2GBD^;2r*~|P3gXA
z;NHdeW>1|wInH!z&sRsu0n8Kd7ZbFGVBGBP&gSB~%hP;JK2ZK~evjXtWNlrG3YUsg
z5Xh*`TZfYlP_Y*jP+oQJHAWX*e<$`glVJWpH@^0x)JX03dW{%mY4P)?zNN!ufvM@-
zs?VPXeO6uJ(Icu%Z(N_s8T*NVj2yX+xa3ahqvUU%ReJ3ZDFuqB%+R!Y;|)|;|JiVj
zf<&v;o7`#4{ZDdwEc({%;cg012SP165dIBXt@o|(09Sdvc+tex8$vcMF(?2NLM~pF
z-@C57xnL6n8l@i;!eEt18Z?H)lT%W{V?F=cftRr7idmn#_wE6C0p(HxV@pRH%X0P_
zW51UVneBtup&|V@SSRCOiTv_(Y^ewqymO~c;^|{VJZ4*eqsHbo@Q|_FJuqNdNl}p}
z!2no;zCmoKi@QI|U3j?D(ngM$MZ^k~Q$O_ZZ?wHc+uyU4oV`)(G<CEnR30-C=tR`_
zS;KX1e)3&Hn+@_shKTfc)_2#44)D|IP<~HM{vXx}uoAE^@py3!x{z(gomqTKmCl5$
z`8{!hC8#^)^ZSU?5eixHF0IoOXBWm95B~NzoZpm_J`sC7Qt5xiR=3E4#hPnwQTPY6
zir++}`VRx+XVo2cTmJi3rB8G>7XyX7MTDd94>scGTO|I!_=EY^I^^lk=?IQ6qoqf<
z;{W~;{MPM$&&Q0YuT$?P{_H<{YRGojqkIbJQO>~6D_?Z`p0fCF+)|pYAqJX%q$y~N
zapJ7vA%Q;?h(!zhzj#XV1@jGM^Yr~3%(wHctJTV9RSeb`B7Q?Z)v^f95u?h2lKr`%
z`Wmvbem_N#QxwE+TH5=YUXIhr5OYoQ7r{6`d6+BvD@~XOlr3Q%zFEG@(m|)_66dP1
zTO0X6d4q(^c7^_CVS9r>yH9McPB!1zTd}?!E`+{6`57M%)21DFRLop*4x6=^Oe>tb
z9qbpcb&2*K-MfpoK`<dnpWFWYf{wBr0O^Brk8$G{VY)?^>sXL{`t;ooA53|-dwQD;
zflx1ByB0tL+gec77^VvDw8_g0*8hutFjy+|Jt3#%w<Ox9Ef^%!zs}3+uc=v<cA&ng
z^8lB-Y6%R-6u4p#5&zpC3UB;2F-Z7`$LQjej`e97j(fHYJOI7}fPgM?+}N><0Jc6~
z>%fO0)}!A5vW{{?>d781vrS)~2P`P;=Je%Q7d5p|=fh~<TBmC&Q(4P}>OFNaQ0T7`
zSy~(Q<-H~N80F|O)i_0EVi#BDc*yEI0ma1?2zn^`2<ac_pD7wA-+1t!Rg7c&L>{6I
zFV4<AIb~Pwi+sJrBbLQq&NYOnwJzOc?X>C2vBfAoP_}NS2=9AVJNxpcErHXTMN^I<
zGDW}f{{1auH{*E|lg>@LqoZmTH?PQe=wu(C40BBnPfzfMzY8ose5(E1ur#``ZPASP
zBWc|UWA*WnWxSmB=dyW~MW;WD=LV<t>^H(o5O|{8V**#n?$ka%rPc6IXwL7=4EL~<
zaV!$ZGjoP+bH08|Vrq%rvzcKmL>iwpPeF3bxteq*-=ba;(K^dU+kDvY_gXiZx;bWZ
z?EIH~_0!h4dC%|!Q)Tz>C!ce$c(OeuG|EzHXX}Ed3fZLYbGB1}Qa=47X$66P+jHZ_
z&?Ghl9)U9I)5k{ZZ%h%&OiF+NJQEQuk#nhT$noG&Fvo<AoVT=kZ&@mgZdFOIp|SBC
zwit-nJWd0ZV^P>d>u84Tb1p?y@7@XljyJuAv6&253g>bnGD22v7GYNm6+C+uyi!F@
zn$D1p4IK_`0m+0E$tc+``fVYQ!a+(vJ;plTdMgs?KNOvng96)4<v>TtPNbMB3~*Xn
zDNDpY6;r1sEgeQjP7k^W*b$nGz9{X=m9TO?K~9hq{Tvv3YMFj!v3Pqi!_QbJj$!eq
zAcW_|aA>H$5R^!z{4Q;8L!N<}bWHhqU^^&pCMOu$0a-##I+PRFJE3?s2s`jE{PX?-
zS7s*KemvBpf!o$_=V&m)2RwN<n7bT2xJo=cowOwJ&fUAP6}T+#0$+d_g!_fzr-AKu
zCY||pnEZbT_O6RZtUm6&xUe;C<M~k9i^!G7$-aOJz*PnJ@6#Br$De_6SnJ3HOssjX
zNNY?sqX-f2iJ+O36d>qpzI<88mfRypc>Mp#HZl<oN(fBoK$8E4OkcRL=b?uhqgE*U
zZ!fH(Mg#F;iN!304WQx=9&}Q|0tM3)*1$5|8NSzyg<Rvtp_Y9?%T5{tRiR>UL1GA2
zi!=%p7Qq}q&60aKT7st6@{#Ymj?j&wd=khI?@$nMqqs3(wBU!Kmf|7<OoZx%$(3O&
z)_ngy!Dj?j#)uI=KzR9MC=B9Qn(bfL-tx4ooEVK#Rh@LQ2;3Ew?6-;v^yCnj;`vGh
z=>?1UW{6eG22y&8m+Hz%gGNgVuiw16t!<CgziZbf6tE2U>u#{``l2DG`A&#Nyi&et
z`di0k4PRG&Ny;;b(eutw>9Wl-QA{l1eGG~>Z1`|~-b97(e1{1a&~hZ8jKxj5GedNy
zI4-#ILhACzJ((%l)yuFV2#bo@GiSaA@7!_c1~}WQRYUg`a2g!1d-U`B1I<MJCKi8!
z7ncp>W>6i`i`0(VVY8@;u?-F(MlW_VXC6i&0XTJBA5{a}%JcOoYipov*#ryWf=vo_
zZ-&D~gszM#qmb7-IxFe@$#d?5w8Ybnyp#B<o;vmD@nb~g3O7BuCrBzt3p79cuNm@i
zP-sRJVGlXp;*wQIM?5!QgR;h^(CfUk(XSsZe%_02A7oM-Y31!$6?@%rwaM*moipsu
z&o8gU+m2m)meZ!?h`|wNHL04ZfXZ$AM0ZzJ9SN$+_$6n&Ter`wm+RT{20RErEg^cd
z8EXehKx{=<@41eEO+l$L-_cRAaL~Ykx7~h`7J$5IOwpyheD_Yg1k)spE{-EF#{JFw
zkKSG)E|P?Lq}>xocZe#={f!!#$V7!q>OnQd3mlW92IDYj&ot(`jM+|u4*_a)L=clt
zZDl7XntSmBLys}cDJv6B&1@4%NsKL-1^6S#L3spAA|-4*aQ?)J3W{JV(DExx*in2_
zQ@_Mp2bK2S0|&D2nrB5vM^n`?dqYU!DsY1=^1ses6=a@D_b<kRUtj7!V1O%gW}Fa9
zE2~h$>Gnw;K%N_jQG^h#-{5k+vd+<s1U@t<tZZ!s?)#4p3%KBnXi8mrfrWB$MMcfo
z8soK^J$E5pU&Y81GJKvUoIJjlT(fn(Dw&tcgU3N#Q*xC-!RP|lK3pqB@hU4LqxoPw
zQ~?A?V8gX6Lp15IfrsfmRU-$h!LB}`SNHB!wY3^7M8;Kv_swL;%v_Vh_z_tW0T=g|
z<g6^Qc@F)o6*Ck_4_@Zxx^O*-$Pg^>GWEZHiFd&gNuY=tnk#XM;Y{Kv!{}x?=s);v
z{TzV)jT?U=YN8Bf8To>_a|bHRaa_=ouUfK1SxxO@U0vbwG^~KOIjiq0Fu|e*1Ps+I
zkBHTveK^mT*Ezrql3%!j#-Po3HHnd%i4*0dbICX5m4uXUh>A!WqJc0(SU5=t=&&mJ
zHIUWRjhqtoZ7jZ+Y4Q2u&@bzjs3(j(+`Vwr_qPLjKT9tSZ~VQi@l4((ovP8^DWO5Z
zN6w!9+rIks$LXb)jxE}+B-Lw-&xlEd^{dbJ9OL^kW#Q{B#+__WIj6ZjZ1R|B-?~^`
zAy4Gj27(Ds(v4YRge&4>z}JVbX4nZrrM<p91Vo;(r9Y3ls~r^=;>a`#3be<MkF!b2
z+fCRPf7#eEo%2!&p2UBc7x97~Ky7+jk1bnnOmn=RyjU%{@#PuxQ2wpg={y+JX3mR;
zo!msqI(d?dqP62r@F9c(B!_MvLf9d;2nTLv7~o47&On}jOgzM#Ij*+P;!PvFpg86d
zat;Ch<(xWnl%5Fr93Ni_a?ZIPv+l!D&{++Q_k?dkQ}VfUh`7ZUl}MvzlT@4*H&1d-
z7i3MS%$bhkukignP!)pT+jQ<~7S^+$Rh^aJ#<@$Rq@>7TQ~)qPif8u$3<J3E)Ec_K
ztN-yMIOPuyF*QSK*PAUiE8W~SGZ}>Fkt6~b0tEzIPL}>zR~m1bNI#v^y%`mKSz`rR
z717=rOf9zHH~kW~t+F!|Fe1#$;r7$7Z?EFe&>eCM!ZW;med$c6SXi{y1+=S1{Q?~0
zT);om0E%R^TL*+3sKg+LdI<c3;IL!5SnvrdgZci%iCXA`xM9@Eu<7iM;`TCLhv-uj
z`(&CXo=|M%&50-Fi^r_o9v)y>J5L>>nz)M!9-B4|)6-K@P+&ys{9!w%w`+gZm9ihY
zlMvWk60$F>Xxe|*0>~=yEp!I?Z$4sWwWE2bO|NPWI|wX5cep1-5=VQ1gTor;)o;$k
zEQ-qjkZyE^S&J<U!N`R4!&AfgHMvo|gI8IO8Gh;&o)kdD{TpB_(dbGFOn4(fB?sUz
z!-x*0VClVkZU78|fOG?@5}Ow?7Z9h_QKK#gw{SO5szRUwA9-wB#;R@a;`2_~eNv91
z(1NqrS>Q?>ml7y^(=js<0(k~^?Xt%6BglNoKNOM77uLLzG+SP>YR;Vfr%!(-nJt-3
zZd#DOVis#}BP~{~TSqxSO68@mudjT@YFwN@H-llK3G$(+3Su7vx1HLtV+TL~8C$cl
zo4KeaOxEV8(WR4*&@Y|a{<~!Ni#rZdv*z^~GPF~?R#WksjNU^kN7%2-^BTgH_P^`2
zDl;U#a-+>k&&oaTSGj2ghKBwwc=}T0TicScUH`PQ>*Qs7&#yT&raoI<O5S+QYyEe>
zy}7Dfllk+792V9>*@2!8wmuSS7Jg%a$5Cp1tg5IR6nlPvq(c^foi=kNjt&lf3<Ci4
zdKa@4oHGaCR$*)Gyz=Jd+Rbmrp$>(;^e|#OJ>1aNzrU|w&_U-wEplY<Uda~`B9S*p
zA3AC>JK2yzm_zEV#PsdJL4zP%?W~%WOCN{ov2d6201a@+W@&|;5fL8i*9ULjg<uGw
zD-ZW)3V7A-X1BD~&$H^zSim22VEPInce0^TQl0Zmzn*HT{Mzl*y13h9rGP)R*RTNx
z3!z4c>Sbs%eR>U`i%B0PudQ+>tV92H+A@LX@#M*UF)?Gk>zAz9$E{)*=-|zpz9{yY
z$hDgJx=_*dR=w=bdTpb#V+;)g&REWxGskt!nw^7zZ0R|f>zRCFmxi&}JP5#sqKHR^
z!XVdoTZB4cp<-XyP#+r`@uvfb#8Hj4Q+z#s2N^hqBc8PqQ;jU<&b<PxV*H6GFxXP+
zgE=MXsGio3wAm7@cXoWIupe%E1NJar07x^y^nX4}cm!O(abw}@2FnQ(f*4a*816cv
zM{{yuZrK*8u!(eEPg9*&tcY-)&wlB>dsVhMQ*VosrQ;t!@d5MrnYIJNU*7}LYdv+U
ztl~-0$6%1K^loK!`_b^^+o`&14zUGBKAO_y*U<w^PiliUvM>xDBx0x7mw@-dzV4jI
zW0WL7ue<t;|4p|-;YaVtb;yfVpG|eN&d=m_kd&;Xz{FG%U2m((yIG0KV_zJ2M2og~
z?*3`Pai;2O-FzYx_l#ICxomVyq+PwT|D^HRmmOYu_N0&AC9`|<@AW(62W&&Mq^!?c
zr-J@dm(>{<Y~A^E0`5IKdyekZhmU|`h1e#|`zX+)wvJBr);}+cin;{c-JDitME^uO
z1sNdc0^#HHh<=JqB*-E^%Ahpf3Mx;IPP*{4rvKG*FS}%Ybsii#NVY?VFc@>NHCs#<
zIjvyQ#l@;ebOa%H-3oCxrI@sIbtm~jS+O0RaAzR23`~9r+QwuHawh}<5Gs`^j%Y3?
zCU|5xa4Q!y%XQh@*I+Tk#wZh$-oJca&t9ypY8E!A;qRPI2nX0tPhPp6kpWz8E<e{^
zvDRshxCo{T1@@zEqdmPqHZV8OA&qgUSPS4h8@Qa76`As!p>w@&BwVXb*VLGiaN-2X
zVlSz6|NivNb&fDQ%sn>iE}(})!UmJ4kcWPnqrj$mvL@9rkbrm%S5$YZYmm6q<Yc*v
z3%@;CFJsX8xz5^GE2FgbeIH-B=$cXJv;okzy$xeF&YgiC36!vFx6>z`Ra0z7#OVI$
z7O^gQs@9&eUYV2$hzF*5^;TrT9&;&QDWe^R+k0<R?Qytz<8SI>=!X@f7GkJq|HR3A
z8a+Z%9ZM1laEHrRlYNu1!3}{g-3WC7q%+}B!tLqg-;wu!IceN_HcsRGgzhC><p=AW
zJ~7U^K5dD#<N{kKqsxIs5gnzQRv&C@NxNYE^pR+W5E!KQ>sj^n)xP$zry}#aM7?<&
zEKjNblld~7bXYQ{5;@BKol)i_uSe(XLNX5@`L^mIbB^aR=3!wVLt#n9+-_$P^fh$^
zoPI0w0+@QRa(@00lpa*R8`C6jzRjL+T`sr#6Iy{shYfhB5%afzuyU=$UMSA5q0upS
zd>L}A|7mT{9@7T!RC2pRy^cp2FW;VR5a5xOF_km}I^)CO1Cj`4KaJ4j34sX-{qVH#
zkJTH3CAoP@Um|FE_pFP@oXJkquGhEzxk`hJQl6*|YvbqVN5c9!7&))wC6~$6vD6OC
z-=S=O^SI>ZA2-@=R<}3ADTw_18R*hIDd#$ZS=zUxPWGvhAS*WaSB{7FUQ1L%_A=`6
zuHIu=MKuKrq?T4{u<ZkyP`1FcBCEQGK^mEzTm4?Q`;I%bWCRa7HeLovS;>RKoG;BM
zVDRaj-n`lJvSPflde2??$-3&>I?AikXnp;vW0G8cj|Va}btd^8V)xqlij!h(i3!p-
zivcPL<#R%*C3zIZdnl+S>2h)#-<YrXe3LmMG;56C7Z;B-GEyHZ?QK;)-Lo|be~)d>
zOlfJ2Mdo-sHB~uF*UPmmCy3hbXLEBqq{xB=G4<Nsl|+heN<QcjzOB<5UF`Y2@5aM-
z>gFsr==x%kzT~W6t={Id=iR>V+9YrPTq@<PtYfXJzujARtv(q#db{){UQgvI1YW10
z@P?RMOh+9kA(eHxj5-I@4n4*!Bp@7|<DVYo=fj9)2edn0-vx^TZ+CoUD&cqj6PuEA
z=UzsVbL8YwFJB%<k<9!#!L(roz!O?>&JhRVQb>rD+TG{R_upQ^Uysm>m?qAf7Ehl)
z$ED#rH5|~PQ>J%6bQFM)r+XS)sx4W0ChYw%<E#54ZVal3eG^ht<8%>2fYVkn!Or5@
z2#)d++TjQE?8BY15KYcuvmS6>@7^ZM9;mH2&~x0z6^!?CBWZnk0zKAQbfGXnMT4q6
z$hIqe&M#mq;wxjKGQv|<G~S)U(@cr17>-2YxyDMuk03DgOp3tJtnv*N02MWY8fZA`
zt8P0!RaHR?{(^}CRANrfFRI62WQD*_Pp2_pChvPyy+{6Ff+Ow<yrr}}<EhM|Axbk?
z^?XPd<B>ucfrOw@P%s^H+9@ZOQFA9f=fPl+A2J=dE1)5?Mp&se*Vlu>J~|V%vRn7=
zNVmWcY(`SLUjSvq;SBXueBr&DQ=@AZ?AV-E6Sm;GhcjQCT7!p$Sx}&y^i5yqF)P<Q
zi8Oubk|&)p#~M=5YpGuuAd631>(~R9gqD@GiPRw+`|>l~Y33z|9)L3yj|_QRGQ@_r
z6hbpR;wT@9%K$@ukY_>WFol0n-!dU+nJ^Rlx>M4^af%+Sh`7Ck`nBlkQ<j_Zrja{0
zYlKe(h=jeLSQYTv2l(-!%Oz^0Qq(t$z;G&QL%7TUbmTq?=hW0xwy|<s;^Kxe&czWi
zDMQBgm@bGe8t`dU&ss_(#`dG4qC^Td_LZZL#!a`i)nnC0VPW_FX@|Fec@mN^aKx#a
zr;4-Ug6pr{AJBDlL7U9CP+3R;{hmD}!u7{|ZSTMN;E1hN+g`@n-)z~h;(x=O>0d@q
zx@c%H0dMEv@U5;c<-&#9va+X-gV`}5-cX-^t_u~XxLjVi@XN=Kp}xkr&%_&fo?vR~
z>eVqMH)MK@9m(&R_O0Yv%C>EHnf4=D^ia6Vv8SiXo|cGpK?on5#tYbk9tqZUNbj}u
zZ+x@dT&8@M(-X9{wE?-Fn0*G7E$4r;7@_#y@Wx#R!x?m0Jj8ffQCP9Rmgme|6Q@%|
z-eN~+G8d^7))Yu)RHg;xB>9#b!LinuF>L+SVlljr${HSzP{?^tO(b23b&3J^-0e@*
z?GDFZ5j2kSkdCZAr>o99$^>ay*}Tc7^kEbxAxS3V$MZnp{i{82AO%3WcSFU+^iCvh
zPNzenIuctl3(tjY-`7MOF|4t%8e5`Zh+3R(>08ZoYN<7;33&cc^l;|Kfq9mv@!<pL
z<Y;zD_uvZ<+u#?QK|e_M#PbOuG8n&2$(NE7jwd8^Vc49tC8){J1JDsg9Gc*FnIsIV
zv&P+>wrN{GT6tU&BJVF$x({Um@|1-ni^2lWV-6&v;a*A4dGtv7;?3VciA6;XO-*4n
zs&b(hZ6Z@~Dg+~CAbADW1##WjxYdXWG{zP@u|S}~wm(x6+=hLaJJ3Ao!o~g3AVb(@
zd|>TwVO1}NkuowOt2b~3D2Z~yJU4CHwPQ!#R9T7|?i_+K8exR$451Pin0)v1YX!SU
zfd)7h@+WNA;u~`oENJ1#b7^2;!M^*9T#k&KZ7!RTX8e;-oCpaCK?a>VRyrV-NmH)X
zcbaJ8EA~js3y*bvUt~NkuH(8*sR-V<={Y&(G9lE&cr)l$582G2<KTjzHMB4?xD_=h
zXAqmjw{LIY9mjzN#vu55t+7*5QX&=rdAxk_f}+)!d!3O{J|b{<W^cgdL&Fv!gD20f
z23<x`VlZO!+*!FDy*|wdy0p-ILu08)uW==!2|g#+6}K!sUy{uL$@0$*C(ifo6Z5pj
z!T4my)k`-wX%(H(3-dV62p|!b5`b2$Tx&M}aCQF|als4#-SYo?g8;sC1M((t?L0<?
zhOgT;9Sa5#9Rd|d;Erh^ZKjOfd#?hMr0{f1Ujan_mcFd)YINKySGNlz!QD6%jBd`M
zZy~HQNe(0sJ;pgV^y$;5pm6fOCON@<aVq$?C-8Mi$>w)GPAqL!E`IC*-a}Tv6EMz(
zYt;;fGVcQ=276(v`2>JTfKj7Hj$D-KZIJmA&kX$U_#7NWCJ?&#Jlk=!Yw2XH#KivO
zU!H4|^J#L+hrg{E@T5?3n{AfAv9#oEhE90yZoJ*7(BQ<<?3bmb?K}?c!MBQT6t_=S
z#K(2T(xqwK&Zo|f>i|?~Vi3J1@AI=WeewLuieG;wgtpY5v9vo`X!zI#RTs7dH7o9%
zKX-1!=FL2Y%FmxEmr5A?vD!GNzyFQJby?vD#2(p%jP@++^IamoKP~!XooUeM>uxNH
zPt?)5lRf(|sIU!MVAl}i`y4Qap%E?4JS3967j6@MyD($N_vV?}ptFN)jwWL|utljN
zyJObmYaS8xQ_U@0+6)apwmlj4qjJuVYu%Q^|HYlvCH5gO2PU!jTRT;~Z+>{|sAVmR
zs(oSYs?y@6|E%*L`OUb|DOP0Os_8e+Ui9XL@iW_D;~B|lxTc|a<626`ibd%Ym(6X8
z?ys<F<ETNcGadw=7f)3{k7xDy*a1jYOuGNSV$W-5G+YqPvD-0JqG+lA!CTS(U;LxS
z9G<ATrTeMbev|x<*0v~{b?<9BH^Dz@XpbOKjcC>&Q+0*ATtjr?Vlxf^@4AC};d$ka
zEuumM6KJ<F)H;4FNR(j2$S7x#ifiUvKRdkVukx6I=1?T#wqH?Bvj=o3=C~VLhs@hf
z9D^;ejva$gd~2bSV+zxySf|qT)MHXOU|+$C4G#IyGTWRjw7R^=GsM|-9r|d3&Ff5`
zw7q+0-?I&3Ich_z^3V?d1`0o1UbX}6Zu6r<_bNGta^YkRUVb-w_fl%HRO~hElhI$d
zn!exm4}RRGyLZzj^{^8ao1;!$cqRYB@$Z?I^}8!xjxSA;dwfW8!KG%=g<%#=rmKQp
zWsSIUwW{Xl))EWJ(Jr&IHff9J8`GjkJ9TQ_x}Y*L<lTeyJE!e!p0D#szjjfT2>lb)
z0JK`$tFt|Ws)ud4IGY|+x<dyBo?t3T2na|R-4}8o7pSp8X@O%%74&@)7ZeHB(vlMv
zFa8UZq1){t)-{N9=?9<^N^bdH!(|h&qp>ls*v$9W`N+tQv5&Fuu$nPL_1I3M4WAXZ
zIRgcJ6^DK%Or((Lu7G{5sp-+HmoHW$Txy(Ix#oyk>6XCH1~Le9^(qC5Slv8h2CASM
zawGB|9EYwu0LdeGk%esz2EAdbX`f{x!@Neu#+WC_`uFz+w4>SJK_{-#x8Q_F3qZwV
zX0fl6^zlFQ4i-*!&r;Dc4v2Z4uYGHXX7i+$%{qGVj-~4xkGySpnD77g*525ULslo7
zKW$!fp!c$2<Cjg*OP^>c$9J-^$zpV8^No0O&G|Pro{5YsAWk&o(2PN;GSI<P?*D~8
zl@T&&!Or=fMW^uo{a+|qIutSph&|O;>5cx^KHQxC(s0iBZgN?StaEWuC`br$-PiuC
zE+WQOud1$GpMfh9Ltvxy^+nVB3UU^8&n7u_`VSX_yq-c1N`mW(7lDvN_7|sj`U{=~
zlF7jX2bgMRz0U1(lu`(}Xgd9XHDp3OMfJ|!#ko^O&`BTyyeLe9+|<<7(dl}Vt3aKv
z-@GX$u-hKt91`lcZx<qcK-8nV;4<)36J-afk7eFOU0m5=Nz8;L6f=zT2!T{$gIn)F
zxYS#Svqx?&d?;9o{e^{HH8jM9aHfd!fD-S9M|tjl(M<jOBWp5QW&O9C-WQjuyG#EB
znhSz*`qfbyrM8R4Mt{C?{L|fK*oQYJe;@hQDLe2`eQeLw%cH7_lYwK;|GY7J#)@O|
zJ-vJyzb5NTHZD|ev>Y<>i^`@;8y-Ju$b7p>Q+d=Hr+eFP$@d@iZGP$RdPU**Uu&DZ
z_Lu3m{H8Q|ob$ZmHr`+4)@jzE6^`=!r(P8$X=5w|cJ)1U<8_RE(;m+T-A$K9@}EMT
zn!nxByy5GP+;e!lJ>%Q{d-|yjyY+O&d@fv?{l5NioLZ^(n!d&(yPl3b*L`ha@t2pn
z2|iEO)h~E>?yQ<!P+YeOIjh!=yA=O<Y_@w-#Y<m9=SQalL()gj2n=+}uC@Q-;`aO4
zu+n;)iiTAVwHbX&U-_n--?U-PI3GD7XRFhc#UoUYRr&ix_iZ$tJ4SRq(PwyaNopqF
zMd`a~!+WJXeZ0kaiWvbCV{OOw?HkGbl6O@W6dSjS>I?Y>g^oQ78{9@>mdHVy3G05@
zwd2JN8@2nzzSwv-`qvJfO*Q8~*UP8IO9chC_)0(CAn|yEe{tkr$!_vO&M>_*i>~eO
z(L+J!)Of>QLeAfrHjBT#`z`8X+@!s!#)@yC{z3bvR7q@}-qU~*hikV_*8J>}Qzg+S
z`ip7EqJ^z)JFi|{XgIY`?MNLvK-{Boao~mxMLD^-CyKYczPwESfaUm2U*Od~BKhY;
zBRPyXHV{4Rr2|;2oMbx+3@I&^Ajrzfs`u&Ld(G0NQt^L<K$@nTH*em%bH_SnL<iwG
z_{vR3ke7Rfg(>K-X_|M|O=Q{;_5iF+5U8<HV?KNSJoL1r0Rl#lcx(88ws(Al7^`jf
z{s;R)7oxmRe3Bu?0aMC!fasUw1oR&!2`WYq>`q$+-GLpynwIwP$&>HPUtDr>P5!1N
z3|RlZXY((^u___Mj--gUbzjL@9sKg(xVo;cc@iq!`X}Cfo3^*_jKk4_kZRXwhQf%!
z$!8jS_39b@eeT$eM^3GKzWz`1>9nZ_y#7cC)BdLO9+nDMXDaQINj;^0I@Q^idGUc$
z7hbz{KYyBQjrMT;K}ngXnjF)&xBCR|?Nrt%A#eic+x9urr*r<P#F}ugEBWvC$BcG*
zP_*DdQOu3k3tFD8+<Wk%Xre(%_`XrUwd=+|(H_3y^`#(}k&4RW0@6<HjLToQc4eXO
zK$C{s>yp=*T(!N^ZZbV7;OpN-y9O(s6~)(Ge&{t%`tyq&l8W}Vtz9M3GM@N$c;l-4
zW<_A`w%QSWOASTm=VtraXSS|gP_t`lbEok8j}~egzxpfh-cf5$@`;xlD~@NrlDXVq
zuKBUCq|1%=J~h+r5|f^M%+xti_x^OBEmG5_`4x2*z4>kkbz5Iw4?s6zWE<g4p>t=Z
z1c9)r*y(uK{wyJo0tidMUi1=w*PI5mW)9?gl=q|6&cRp5T-jaPVeQ(cMf3J-{K?3#
zyYInVo1OOKyX>4k-SBtq@(<T_tFly-<=!=aI@OYWfB3@NHak~mshl0*sy;m_`}e1t
zyZmnslv%WKrR;C{o#rbFx1Ooktf(y46l?OP@Y#@gUb9sPr5(HbpohAY@OnXw>r%TD
zZ>wJI@VXcI1uT`m5HfK0p+m9)!)BT&&)G}#_;Kg)Hp&rw7HT63f=51X8pO=iJV!^<
z6;CxyPN9}0YGXB3Ke)|7R><jfnW0p_DJ)>Ow6$HgVntblH-pU}CA12)QK3%{mKZpJ
z%LwL(klf_&S2lz`l#KQq?6K#v-&IYc*<Pv!V|}bFx35`|d+vgykUoCKp_ma;OVkJT
zpK+<jt6w8j1<lb<g5r)zUw04$9c{-|xyW7qd_ClPQewc?{zBlR{XN#E9Ft<aKd|8b
zkDAUubY9|g8R-1<qs^RGyJNG@H;5#bKVKHs)E<(tbj0Q0m)&CC$al0H3OcDN2(Jr^
zPu(?kxx7Bme81<B+fQ0u3I(6&E4Ug+3it0yb#PG3-qSYu(6vvQn!RH7Zu~7JoYFYG
ze)|Wxg*P4EKAqde_4H#&X~{t;=9kje{mIpu7M1?J@lXHqY`x;aWw!?O*BP6;ca4ei
zp|f_P&YRvfCqA=-Bj=M_?DDVekl}RXmD|mDs-Kf5E6Gk{dn>Z1B04%ANse$F(<$K0
zFRI@6nDhqm*zsMvA$8>5Wv8D=OKS}pc%dS|@xhZmLXQ7In;unx(;o^7`@9az{9%c}
zzWt}>zv03BJ;h|9wbHi!1w~7RNCi2Ijyv`o4K@)1f1WyX{^Pws{2fyFsg~6i>zHr&
z21I)3?__9M#E)AJYAPSUH?Px}*!KoAg~zcPq9YyDC`|z*9pK##J*+LwZilH1l`VG1
ztQ-Cta~SKy*-Say*idk7h<vD~PJ30CJ#yZDf{=YF=y<ZIYJpD&o9PBZpz9K=IrCQf
zHXS{6@*a8PQV)5dZ1l6SlUvfA9NN{kX+2(dN_EZ)i7A@DYQtxpviPz0h<;2L&mfo4
z2aliseW;aT?2Pu()BY{HHhOJQIeM5XUwUkY-Y~VKpKCX`CI=P>>Js(d6{SVSS`Jcy
zx<S*YH}tBpSQ#_?$ni$4r_tZ;Mpy`efe#bsm;9A7RGp%{=j@K$XA<$YjfelZ*&@~+
znHBj)yq|$K5~>`N+5hYiE=^zBeqm?lCg~Ql3xS9CkNWUHMM|dPZ|_&e24}K+9$~p$
ze)m$l^#LF3q_ukt|I4XNK4bl@BxP7tSZGbzuU3aJYh&MYD=f5T&6_tyS62Z&uj0>{
ziTa~PtwESSY*^P{GfvDLf}oD43Z+F*KT=OqQxjEI^(8;#9Eil48XHxM27vPm0y}V&
zYF3>G;s7$g!$kGG6i0wmd$uJR7w+gW1(-0>!iB9s->=P@$<(*Lfk92v7@W@u;R)@U
z*=P31Ib})g?pbx;#%JQQmx-@;-W!0m>WRIV^EEdlj-P5gD0t66W0?^t;dWErq*rBq
zJeW1G$Kj1#W0Ftl8m|u8`8Bss_k^N==tqxyp4p6)NV>H=D$l7yf4R12!=%r@EPR<0
zZ}zsNgKoF-6wB&Pd$g4I@9%2(d#|<3FRM1k!=k{5bgU1?Jr^cS@3FgJRf1uTq2syp
z|E5%{iK17oU9*iFH<yVJFBFx@c#giC$+tL8seSe=TDu!Qwp$k*I{ivYkh2^rJ$cy&
zrwfl(uWDVRy1B1uqiz4r*%=+}BN7K&FB`wB((u{9sSEN-lI)RB?%KXxrN?iaY2%yy
z3x_iadld0Iy*uiw)vMR*^{Wzu4)xP5Cd^rlx0wg^s1O()K9!kt&@%v43>i>sVD(pv
zG2GG?R2_S9Az1r%6on1Q9-Y~DL}7x!wf_$_#&#*RQh|ZOJ5_6GMhzKIV7zt75^U4p
zPwVYS5C4lRm7{2A*RBWX1jSB&jHUp+0Dl-6d1LiRb93v1jM_tkVM^<y1nI{LUJvZ1
zKQz#HSao#Lq9^iR%ZFx_O<Z4n|JPnEcOPvb(9R*pD8Rw$^3lzc&wrF|InYaO-r7|r
zSx!4QB%V5;@wK48L|PBIwv<~pqgPh!tQ6Ybb*+})Kh)aCz*;rDm*<E>LF;OhA37d=
zGe_>tLi=g+&CTsq76<z}2al8SI;Xp6*WNYL2F`f>J9=PRR7dwWmvsj$Km4eA`JfGp
z?$1n5Uc1sa?AP~SvIjC+WSX7_mlnpq`sH}+&-g=5@z*M2j!oLPbZAmkqmOFeEuqRP
z-^N=FIU;Wms=R0R9mUQn6R*$s-cX#~+H1q?1t04s<X$#W{U~)ZRN3>xv-+Hx`(;j{
zyUX_I?dw)GYj(}g2QzPu@DOR18>#f^ySB7fTkWfre;sy5MSqQaw*P3r{$`(!{Sx|S
z?{I8$SXR;6;WnnM{f<^$c5A+Qt@=~OB)o4x?|RZ$+#EAb$}Z&<I@kFZUIOa_-(_JR
ziFp!;h}vZ9TQ=|8ysGEP+=vUU^xl?{dD81!Ra>Ny($><4BPZl~T1C%TKl({h_mz%?
zO(#cB+G<w6w4cAO+V3-ZHAQ!dHVpAz-kR_Exg;elE`_aCVi!6nh0;<p6B9q$5+3--
z56ZERmyd}}dac+=U+2zi%L&ElFEA)v`yLO{hnK}lHO47IS6q1uX7r}^7lTx1=A13A
zL1m|^;$qV2;bkT*;d_ys$%p5e#$#g$=P@?U=E&(@J$tSh6I-+bi!O$$Zob)jsOPS`
zt|J!cc4J?`>@yf2*xK6uOz6J{j>f2W6xJglx9hWK^(0qYCSGQawAPFIKumrc_q8zB
zPVANWXW_dSDaw0>WIWxSKIDdx>;+5PnX6y#=sxJ$%ro0F7H#%6-4fkPBk|LjGcOjo
z-zcuX-dwpn%tvS7fkERhjWTd6s&-rZqw{FP){92#d_HEFO<865!%E+?P4dp?Yo~oX
z{&;3t7{2SLL*loVD|-jW-*`4B>1}a8-%Fwgf0`=S9Z?-oHT__X_waEIQ!_1ki5`s2
z^dCLU+UCLs-6FFYh0|m0O3GT6829bCW5i{(MPE)Y-uBh0X{*bIb)y=VE>(H|Apcu<
zWrEkNf*<=2&6xVZ+j{>V?F9*g?Pn~psr9OJTwS(gaCyteLzc<08yntbpn^iv3k-+K
zeD&(@;F0i=HO+rU_q5)+^_F8wylBPtO<#Up%bQdF=lSQ03kx?K{T8NGQ+%#tzlu*C
z%FP1$`rO*9Y+7?EbH9t7?#<8hpKJ(I3U61<$%uCHca!%m80L7Qt6uSBc_*!|dM~2l
zjZ7D84b4bW8{H6*Hec62+e}AiHDY?zlMh<`v$2lMSSh=t+i|Tu)7~9>C+2LIr#<|%
z*YR)RTju9qzph@N;i5jvGrDtUryOHb%`qX9s-%5RzCi5^Yw%*#E#DpY-!~gI&;N3#
zMaTWR^1=2E#tF%4b}fsCxeABXUZr%lJNKef*oj-W-me(-;L{I4Y}^8KmgwgPm>L*g
zI={K}`&Yvx^@kQQjmzsVE!RsbK2x;fd&7zJ=G(h^${00I{v7*#(W5Cc!tFboEb&<Z
z-TLO`Yi->*Pk+^w8>y)t@U++0Hiu6;^}6+!uE|T?t_m_VM22hM{uCU2k3a0<;oncs
zu-LMzmPFaH$gfe+JvwXjRZi>ie303O%HEiN2k-bgZ+ncpM|JN`63SIVeW1Axd-epm
rz$sn$At!E<r361pn*TrjK_u%eDch-GNe_Gex-fmRjm5=@OM?F!U+gG*

diff --git a/docs/guides/embedding-content.rst b/docs/guides/embedding-content.rst
index b05798defe9..89768aaaf0f 100644
--- a/docs/guides/embedding-content.rst
+++ b/docs/guides/embedding-content.rst
@@ -29,6 +29,7 @@ Here is an example showing a tooltip when you hover with the mouse a reference:
 
 .. figure:: /_static/images/guides/sphinx-hoverxref-example.png
    :width: 80%
+   :align: center
 
    Tooltip shown when hovering on a reference using ``sphinx-hoverxref``.
 

From e17f6d8cda5ca786ecca17ab44c9a44f4803bebd Mon Sep 17 00:00:00 2001
From: Manuel Kaufmann <humitos@gmail.com>
Date: Mon, 18 May 2020 19:55:14 +0200
Subject: [PATCH 61/72] Add this guide to the index

---
 docs/guides/platform.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/guides/platform.rst b/docs/guides/platform.rst
index 142829f42f8..6719af0b3a1 100644
--- a/docs/guides/platform.rst
+++ b/docs/guides/platform.rst
@@ -16,6 +16,7 @@ These guides will help you customize or tune aspects of Read the Docs.
     google-analytics
     hiding-a-version
     searching-with-readthedocs
+    embedding-content
     specifying-dependencies
     technical-docs-seo-guide
     wipe-environment

From a0e2a78579b3a1c207aa397b573859ed7bd2786b Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Mon, 18 May 2020 15:13:04 -0500
Subject: [PATCH 62/72] Privacy levels: migrate protected versions

This migrates all protected to public on .org,
and to private on .com.
---
 .../0022_migrate_protected_versions.py        | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 readthedocs/builds/migrations/0022_migrate_protected_versions.py

diff --git a/readthedocs/builds/migrations/0022_migrate_protected_versions.py b/readthedocs/builds/migrations/0022_migrate_protected_versions.py
new file mode 100644
index 00000000000..c548edfc9ad
--- /dev/null
+++ b/readthedocs/builds/migrations/0022_migrate_protected_versions.py
@@ -0,0 +1,29 @@
+# Generated by Django 2.2.12 on 2020-05-18 20:06
+
+from django.db import migrations
+from django.conf import settings
+
+
+def forwards_func(apps, schema_editor):
+    """
+    Migrate all protected versions.
+
+    For .org, we mark them as public,
+    and for .com we mark them as private.
+    """
+    Version = apps.get_model('builds', 'Version')
+    target_privacy_level = 'private' if settings.ALLOW_PRIVATE_REPOS else 'public'
+    Version.objects.filter(privacy_level='protected').update(
+        privacy_level=target_privacy_level,
+    )
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('builds', '0021_make_hidden_field_not_null'),
+    ]
+
+    operations = [
+        migrations.RunPython(forwards_func),
+    ]

From a69aa583f02b9ac0438a3c12b5eb3e8833ece76d Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Mon, 18 May 2020 13:44:57 -0700
Subject: [PATCH 63/72] Fix the unresolver not working properly with root paths

---
 readthedocs/core/unresolver.py                 | 6 ++++++
 readthedocs/rtd_tests/tests/test_unresolver.py | 6 +++---
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/readthedocs/core/unresolver.py b/readthedocs/core/unresolver.py
index e2b35502001..2ad9b4097f2 100644
--- a/readthedocs/core/unresolver.py
+++ b/readthedocs/core/unresolver.py
@@ -55,6 +55,12 @@ def unresolve(self, url):
             filename=kwargs.get('filename', ''),
         )
 
+        # Handle our backend storage not supporting directory indexes,
+        # so we need to append index.html when appropriate.
+        if not filename or filename.endswith('/'):
+            # We need to add the index.html to find this actual file
+            filename += 'index.html'
+
         log.info(
             'Unresolver parsed:'
             'url=%s, project=%s lang_slug=%s version_slug=%s filename=%s',
diff --git a/readthedocs/rtd_tests/tests/test_unresolver.py b/readthedocs/rtd_tests/tests/test_unresolver.py
index cb17daa6d29..fa869a270b4 100644
--- a/readthedocs/rtd_tests/tests/test_unresolver.py
+++ b/readthedocs/rtd_tests/tests/test_unresolver.py
@@ -47,7 +47,7 @@ def test_unresolver_domain(self):
         self.assertEqual(parts.project.slug, 'pip')
         self.assertEqual(parts.language_slug, 'en')
         self.assertEqual(parts.version_slug, 'latest')
-        self.assertEqual(parts.filename, '')
+        self.assertEqual(parts.filename, 'index.html')
 
     def test_unresolver_single_version(self):
         self.pip.single_version = True
@@ -55,7 +55,7 @@ def test_unresolver_single_version(self):
         self.assertEqual(parts.project.slug, 'pip')
         self.assertEqual(parts.language_slug, None)
         self.assertEqual(parts.version_slug, None)
-        self.assertEqual(parts.filename, '')
+        self.assertEqual(parts.filename, 'index.html')
 
     def test_unresolver_subproject_alias(self):
         relation = self.pip.subprojects.first()
@@ -65,7 +65,7 @@ def test_unresolver_subproject_alias(self):
         self.assertEqual(parts.project.slug, 'sub')
         self.assertEqual(parts.language_slug, 'ja')
         self.assertEqual(parts.version_slug, 'latest')
-        self.assertEqual(parts.filename, '')
+        self.assertEqual(parts.filename, 'index.html')
 
     def test_unresolver_external_version(self):
         ver = self.pip.versions.first()

From b3ce5dc591667e87680fe8b4047cb3513a40b4dd Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Mon, 18 May 2020 13:48:15 -0700
Subject: [PATCH 64/72] Fix test

---
 readthedocs/rtd_tests/tests/test_unresolver.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/readthedocs/rtd_tests/tests/test_unresolver.py b/readthedocs/rtd_tests/tests/test_unresolver.py
index fa869a270b4..c86a57599b6 100644
--- a/readthedocs/rtd_tests/tests/test_unresolver.py
+++ b/readthedocs/rtd_tests/tests/test_unresolver.py
@@ -75,7 +75,7 @@ def test_unresolver_external_version(self):
         self.assertEqual(parts.project.slug, 'pip')
         self.assertEqual(parts.language_slug, 'en')
         self.assertEqual(parts.version_slug, '10')
-        self.assertEqual(parts.filename, '')
+        self.assertEqual(parts.filename, 'index.html')
 
     def test_unresolver_unknown_host(self):
         parts = unresolve('http://random.stuff.com/en/latest/')

From 1312ac2bc4dafbbf70b6209c1ec81d33864abf96 Mon Sep 17 00:00:00 2001
From: Santos Gallegos <stsewd@protonmail.com>
Date: Mon, 18 May 2020 18:51:33 -0500
Subject: [PATCH 65/72] Footer: Check for mkdocs doctype too

Mkdocs is also a htmldir doctype.

Fix https://github.com/readthedocs/readthedocs.org/issues/7087
---
 readthedocs/api/v2/views/footer_views.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/readthedocs/api/v2/views/footer_views.py b/readthedocs/api/v2/views/footer_views.py
index 644d6c7f36a..19e4257c9e1 100644
--- a/readthedocs/api/v2/views/footer_views.py
+++ b/readthedocs/api/v2/views/footer_views.py
@@ -15,6 +15,7 @@
 from readthedocs.builds.constants import LATEST, TAG
 from readthedocs.builds.models import Version
 from readthedocs.core.utils.extend import SettingsOverrideObject
+from readthedocs.projects.constants import MKDOCS, SPHINX_HTMLDIR
 from readthedocs.projects.models import Project
 from readthedocs.projects.version_handling import (
     highest_version,
@@ -147,7 +148,7 @@ def _get_context(self):
         page_slug = self.request.GET.get('page', '')
         path = ''
         if page_slug and page_slug != 'index':
-            if version.documentation_type == 'sphinx_htmldir':
+            if version.documentation_type in {SPHINX_HTMLDIR, MKDOCS}:
                 path = re.sub('/index$', '', page_slug) + '/'
             else:
                 path = page_slug + '.html'

From 36713567a37ba848a91f3cc061fec26de54e9745 Mon Sep 17 00:00:00 2001
From: santos22 <santosjavier22@gmail.com>
Date: Wed, 13 May 2020 00:08:46 -0700
Subject: [PATCH 66/72] Fix tests ahead of django-dynamic-fixture update

---
 readthedocs/proxito/tests/base.py             |  1 -
 readthedocs/rtd_tests/tests/test_api.py       | 38 +++++++++++++------
 .../rtd_tests/tests/test_core_utils.py        |  3 --
 .../rtd_tests/tests/test_privacy_urls.py      |  4 +-
 4 files changed, 28 insertions(+), 18 deletions(-)

diff --git a/readthedocs/proxito/tests/base.py b/readthedocs/proxito/tests/base.py
index 4ed02d93b74..daee545b30f 100644
--- a/readthedocs/proxito/tests/base.py
+++ b/readthedocs/proxito/tests/base.py
@@ -21,7 +21,6 @@ def setUp(self):
             Project,
             slug='project',
             privacy_level=PUBLIC,
-            version_privacy_level=PUBLIC,
             users=[self.eric],
             main_language_project=None,
         )
diff --git a/readthedocs/rtd_tests/tests/test_api.py b/readthedocs/rtd_tests/tests/test_api.py
index 61a673de274..cb3106572ab 100644
--- a/readthedocs/rtd_tests/tests/test_api.py
+++ b/readthedocs/rtd_tests/tests/test_api.py
@@ -354,7 +354,9 @@ def test_update_build_without_permission(self):
         client = APIClient()
         api_user = get(User, is_staff=False, password='test')
         client.force_authenticate(user=api_user)
-        build = get(Build, project_id=1, version_id=1, state='cloning')
+        project = Project.objects.get(pk=1)
+        version = project.versions.first()
+        build = get(Build, project=project, version=version, state='cloning')
         resp = client.put(
             '/api/v2/build/{}/'.format(build.pk),
             {
@@ -373,7 +375,9 @@ def test_make_build_protected_fields(self):
         Super users should be able to read/write the `builder` property, but we
         don't expose this to end users via the API
         """
-        build = get(Build, project_id=1, version_id=1, builder='foo')
+        project = Project.objects.get(pk=1)
+        version = project.versions.first()
+        build = get(Build, project=project, version=version, builder='foo')
         client = APIClient()
 
         api_user = get(User, is_staff=False, password='test')
@@ -423,7 +427,9 @@ def test_make_build_commands(self):
         self.assertEqual(build['commands'][0]['description'], 'foo')
 
     def test_get_raw_log_success(self):
-        build = get(Build, project_id=1, version_id=1, builder='foo')
+        project = Project.objects.get(pk=1)
+        version = project.versions.first()
+        build = get(Build, project=project, version=version, builder='foo')
         get(
             BuildCommandResult,
             build=build,
@@ -462,8 +468,10 @@ def test_get_raw_log_success(self):
         )
 
     def test_get_raw_log_building(self):
+        project = Project.objects.get(pk=1)
+        version = project.versions.first()
         build = get(
-            Build, project_id=1, version_id=1,
+            Build, project=project, version=version,
             builder='foo', success=False,
             exit_code=1, state='building',
         )
@@ -506,8 +514,10 @@ def test_get_raw_log_building(self):
         )
 
     def test_get_raw_log_failure(self):
+        project = Project.objects.get(pk=1)
+        version = project.versions.first()
         build = get(
-            Build, project_id=1, version_id=1,
+            Build, project=project, version=version,
             builder='foo', success=False, exit_code=1,
         )
         get(
@@ -562,8 +572,12 @@ def test_build_filter_by_commit(self):
         Should return the list of builds according to the
         commit query params
         """
-        get(Build, project_id=1, version_id=1, builder='foo', commit='test')
-        get(Build, project_id=2, version_id=1, builder='foo', commit='other')
+        project1 = Project.objects.get(pk=1)
+        project2 = Project.objects.get(pk=2)
+        version1 = project1.versions.first()
+        version2 = project2.versions.first()
+        get(Build, project=project1, version=version1, builder='foo', commit='test')
+        get(Build, project=project2, version=version2, builder='foo', commit='other')
         client = APIClient()
         api_user = get(User, is_staff=False, password='test')
         client.force_authenticate(user=api_user)
@@ -635,7 +649,7 @@ def test_project_pagination(self):
 
     def test_remote_repository_pagination(self):
         account = get(SocialAccount, provider='github')
-        user = get(User, socialaccount_set=[account])
+        user = get(User)
         for _ in range(20):
             get(RemoteRepository, users=[user], account=account)
 
@@ -649,7 +663,7 @@ def test_remote_repository_pagination(self):
 
     def test_remote_organization_pagination(self):
         account = get(SocialAccount, provider='github')
-        user = get(User, socialaccount_set=[account])
+        user = get(User)
         for _ in range(30):
             get(RemoteOrganization, users=[user], account=account)
 
@@ -719,9 +733,9 @@ def test_permissions(self):
         account_a = get(SocialAccount, provider='github')
         account_b = get(SocialAccount, provider='github')
         account_c = get(SocialAccount, provider='github')
-        user_a = get(User, password='test', socialaccount_set=[account_a])
-        user_b = get(User, password='test', socialaccount_set=[account_b])
-        user_c = get(User, password='test', socialaccount_set=[account_c])
+        user_a = get(User, password='test')
+        user_b = get(User, password='test')
+        user_c = get(User, password='test')
         org_a = get(RemoteOrganization, users=[user_a], account=account_a)
         repo_a = get(
             RemoteRepository,
diff --git a/readthedocs/rtd_tests/tests/test_core_utils.py b/readthedocs/rtd_tests/tests/test_core_utils.py
index 8c3430a6133..62305e949e4 100644
--- a/readthedocs/rtd_tests/tests/test_core_utils.py
+++ b/readthedocs/rtd_tests/tests/test_core_utils.py
@@ -174,7 +174,6 @@ def test_trigger_build_rounded_time_limit(self, update_docs):
             'commit': None
         }
         options = {
-            'queue': mock.ANY,
             'time_limit': 3,
             'soft_time_limit': 3,
             'priority': CELERY_HIGH,
@@ -241,7 +240,6 @@ def test_trigger_external_build_low_priority(self, update_docs):
             'commit': None
         }
         options = {
-            'queue': mock.ANY,
             'time_limit': mock.ANY,
             'soft_time_limit': mock.ANY,
             'priority': CELERY_LOW,
@@ -265,7 +263,6 @@ def test_trigger_build_translation_medium_priority(self, update_docs):
             'commit': None
         }
         options = {
-            'queue': mock.ANY,
             'time_limit': mock.ANY,
             'soft_time_limit': mock.ANY,
             'priority': CELERY_MEDIUM,
diff --git a/readthedocs/rtd_tests/tests/test_privacy_urls.py b/readthedocs/rtd_tests/tests/test_privacy_urls.py
index 5c834abad55..2a2a4ddbf69 100644
--- a/readthedocs/rtd_tests/tests/test_privacy_urls.py
+++ b/readthedocs/rtd_tests/tests/test_privacy_urls.py
@@ -150,7 +150,7 @@ class ProjectMixin(URLAccessMixin):
 
     def setUp(self):
         super().setUp()
-        self.build = get(Build, project=self.pip)
+        self.build = get(Build, project=self.pip, version=self.pip.versions.first())
         self.tag = get(Tag, slug='coolness')
         self.subproject = get(
             Project, slug='sub', language='ja',
@@ -352,7 +352,7 @@ class APIMixin(URLAccessMixin):
 
     def setUp(self):
         super().setUp()
-        self.build = get(Build, project=self.pip)
+        self.build = get(Build, project=self.pip, version=self.pip.versions.first())
         self.build_command_result = get(BuildCommandResult, build=self.build)
         self.domain = get(Domain, domain='docs.foobar.com', project=self.pip)
         self.social_account = get(SocialAccount)

From 276cf19777241e8387a8603728d9f5ed9a1d51ed Mon Sep 17 00:00:00 2001
From: santos22 <santosjavier22@gmail.com>
Date: Mon, 18 May 2020 17:20:10 -0700
Subject: [PATCH 67/72] Update django-dynamic-fixture to 3.1.0

---
 requirements/testing.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/requirements/testing.txt b/requirements/testing.txt
index dff25b09e2d..97adde92c7c 100644
--- a/requirements/testing.txt
+++ b/requirements/testing.txt
@@ -1,7 +1,7 @@
 -r pip.txt
 -r local-docs-build.txt
 
-django-dynamic-fixture==2.0.0
+django-dynamic-fixture==3.1.0
 pytest==5.2.2
 pytest-custom-exit-code==0.3.0
 pytest-django==3.6.0

From b530bbcb73fd08186aa3649f3be2df601bb8ebe3 Mon Sep 17 00:00:00 2001
From: David Fischer <david@readthedocs.org>
Date: Mon, 18 May 2020 21:48:05 -0700
Subject: [PATCH 68/72] Move pageview models to the analytics app

---
 readthedocs/analytics/admin.py                |  16 +++
 .../migrations/0001_initial.py}               |   7 +-
 readthedocs/analytics/migrations/__init__.py  |   0
 readthedocs/analytics/models.py               | 130 ++++++++++++++++++
 readthedocs/analytics/tasks.py                |  32 +++++
 readthedocs/analytics/tests.py                |  89 +++++++++++-
 readthedocs/api/v2/views/footer_views.py      |   2 +-
 readthedocs/projects/views/private.py         |   3 +-
 readthedocs/search/admin.py                   |  11 +-
 readthedocs/search/models.py                  | 112 +--------------
 readthedocs/search/tasks.py                   |  29 +---
 readthedocs/search/tests/test_search_tasks.py |  75 +---------
 readthedocs/settings/base.py                  |   2 +-
 13 files changed, 278 insertions(+), 230 deletions(-)
 create mode 100644 readthedocs/analytics/admin.py
 rename readthedocs/{search/migrations/0003_create_page_views_model.py => analytics/migrations/0001_initial.py} (87%)
 create mode 100644 readthedocs/analytics/migrations/__init__.py
 create mode 100644 readthedocs/analytics/models.py

diff --git a/readthedocs/analytics/admin.py b/readthedocs/analytics/admin.py
new file mode 100644
index 00000000000..79cdc6af7c4
--- /dev/null
+++ b/readthedocs/analytics/admin.py
@@ -0,0 +1,16 @@
+"""Analytics Admin classes."""
+
+from django.contrib import admin
+
+from .models import PageView
+
+
+class PageViewAdmin(admin.ModelAdmin):
+    raw_id_fields = ('project', 'version')
+    list_display = ('project', 'version', 'path', 'view_count', 'date')
+    search_fields = ('project__slug', 'version__slug', 'path')
+    readonly_fields = ('date',)
+    list_select_related = ('project', 'version', 'version__project')
+
+
+admin.site.register(PageView, PageViewAdmin)
diff --git a/readthedocs/search/migrations/0003_create_page_views_model.py b/readthedocs/analytics/migrations/0001_initial.py
similarity index 87%
rename from readthedocs/search/migrations/0003_create_page_views_model.py
rename to readthedocs/analytics/migrations/0001_initial.py
index c0b101c62c5..18ab14383df 100644
--- a/readthedocs/search/migrations/0003_create_page_views_model.py
+++ b/readthedocs/analytics/migrations/0001_initial.py
@@ -1,4 +1,4 @@
-# Generated by Django 2.2.12 on 2020-05-07 23:32
+# Generated by Django 2.2.12 on 2020-05-19 00:45
 
 import datetime
 from django.db import migrations, models
@@ -7,10 +7,11 @@
 
 class Migration(migrations.Migration):
 
+    initial = True
+
     dependencies = [
+        ('builds', '0022_migrate_protected_versions'),
         ('projects', '0048_remove_version_privacy_field'),
-        ('builds', '0019_migrate_protected_versions_to_hidden'),
-        ('search', '0002_add_total_results_field'),
     ]
 
     operations = [
diff --git a/readthedocs/analytics/migrations/__init__.py b/readthedocs/analytics/migrations/__init__.py
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/readthedocs/analytics/models.py b/readthedocs/analytics/models.py
new file mode 100644
index 00000000000..c813b21b43e
--- /dev/null
+++ b/readthedocs/analytics/models.py
@@ -0,0 +1,130 @@
+"""Analytics modeling to help understand the projects on Read the Docs."""
+
+import datetime
+
+from django.db import models
+from django.db.models import Sum
+from django.utils import timezone
+from django.utils.translation import ugettext_lazy as _
+
+from readthedocs.builds.models import Version
+from readthedocs.projects.models import Project
+
+
+def _last_30_days_iter():
+    """Returns iterator for previous 30 days (including today)."""
+    thirty_days_ago = timezone.now().date() - timezone.timedelta(days=30)
+
+    # this includes the current day, len() = 31
+    return (thirty_days_ago + timezone.timedelta(days=n) for n in range(31))
+
+
+class PageView(models.Model):
+
+    """PageView counts per day for a project, version, and path."""
+
+    project = models.ForeignKey(
+        Project,
+        related_name='page_views',
+        on_delete=models.CASCADE,
+    )
+    version = models.ForeignKey(
+        Version,
+        verbose_name=_('Version'),
+        related_name='page_views',
+        on_delete=models.CASCADE,
+    )
+    path = models.CharField(max_length=4096)
+    view_count = models.PositiveIntegerField(default=0)
+    date = models.DateField(default=datetime.date.today, db_index=True)
+
+    class Meta:
+        unique_together = ("project", "version", "path", "date")
+
+    def __str__(self):
+        return f'PageView: [{self.project.slug}:{self.version.slug}] - {self.path} for {self.date}'
+
+    @classmethod
+    def top_viewed_pages(cls, project, since=None):
+        """
+        Returns top 10 pages according to view counts.
+
+        Structure of returned data is compatible to make graphs.
+        Sample returned data::
+        {
+            'pages': ['index', 'config-file/v1', 'intro/import-guide'],
+            'view_counts': [150, 120, 100]
+        }
+        This data shows that `index` is the most viewed page having 150 total views,
+        followed by `config-file/v1` and `intro/import-guide` having 120 and
+        100 total page views respectively.
+        """
+        if since is None:
+            since = timezone.now().date() - timezone.timedelta(days=30)
+
+        qs = (
+            cls.objects
+            .filter(project=project, date__gte=since)
+            .values_list('path')
+            .annotate(total_views=Sum('view_count'))
+            .values_list('path', 'total_views')
+            .order_by('-total_views')[:10]
+        )
+
+        pages = []
+        view_counts = []
+
+        for data in qs.iterator():
+            pages.append(data[0])
+            view_counts.append(data[1])
+
+        final_data = {
+            'pages': pages,
+            'view_counts': view_counts,
+        }
+
+        return final_data
+
+    @classmethod
+    def page_views_by_date(cls, project_slug, since=None):
+        """
+        Returns the total page views count for last 30 days for a particular project.
+
+        Structure of returned data is compatible to make graphs.
+        Sample returned data::
+            {
+                'labels': ['01 Jul', '02 Jul', '03 Jul'],
+                'int_data': [150, 200, 143]
+            }
+        This data shows that there were 150 page views on 01 July,
+        200 page views on 02 July and 143 page views on 03 July.
+        """
+        if since is None:
+            since = timezone.now().date() - timezone.timedelta(days=30)
+
+        qs = cls.objects.filter(
+            project__slug=project_slug,
+            date__gt=since,
+        ).values('date').annotate(total_views=Sum('view_count')).order_by('date')
+
+        count_dict = dict(
+            qs.order_by('date').values_list('date', 'total_views')
+        )
+
+        # This fills in any dates where there is no data
+        # to make sure we have a full 30 days of dates
+        count_data = [count_dict.get(date) or 0 for date in _last_30_days_iter()]
+
+        # format the date value to a more readable form
+        # Eg. `16 Jul`
+        last_30_days_str = [
+            timezone.datetime.strftime(date, '%d %b')
+            for date in _last_30_days_iter()
+        ]
+
+        final_data = {
+            'labels': last_30_days_str,
+            'int_data': count_data,
+        }
+
+        return final_data
diff --git a/readthedocs/analytics/tasks.py b/readthedocs/analytics/tasks.py
index cb58fbdf71d..17f3fd170d0 100644
--- a/readthedocs/analytics/tasks.py
+++ b/readthedocs/analytics/tasks.py
@@ -3,10 +3,15 @@
 """Tasks for Read the Docs' analytics."""
 
 from django.conf import settings
+from django.db.models import F
+from django.utils import timezone
 
 import readthedocs
 from readthedocs.worker import app
+from readthedocs.builds.models import Version
+from readthedocs.projects.models import Project
 
+from .models import PageView
 from .utils import send_to_analytics
 
 
@@ -70,3 +75,30 @@ def analytics_event(
     data.update(DEFAULT_PARAMETERS)
     data.update(kwargs)
     send_to_analytics(data)
+
+
+@app.task(queue='web')
+def increase_page_view_count(project_slug, version_slug, path):
+    """Increase the page view count for the given project."""
+    project = Project.objects.get(slug=project_slug)
+
+    page_view, _ = PageView.objects.get_or_create(
+        project=project,
+        version=Version.objects.get(project=project, slug=version_slug),
+        path=path,
+        date=timezone.now().date(),
+    )
+    PageView.objects.filter(pk=page_view.pk).update(
+        view_count=F('view_count') + 1
+    )
+
+
+@app.task(queue='web')
+def delete_old_page_counts():
+    """
+    Delete page counts older than 30 days.
+
+    This is intended to run from a periodic task daily.
+    """
+    thirty_days_ago = timezone.now().date() - timezone.timedelta(days=30)
+    return PageView.objects.filter(date__lt=thirty_days_ago).delete()
diff --git a/readthedocs/analytics/tests.py b/readthedocs/analytics/tests.py
index eb0adcf5fa0..cd20d3880a4 100644
--- a/readthedocs/analytics/tests.py
+++ b/readthedocs/analytics/tests.py
@@ -1,6 +1,14 @@
-# -*- coding: utf-8 -*-
+from unittest import mock
+
+from django_dynamic_fixture import get
 from django.test import TestCase, RequestFactory
+from django.utils import timezone
+
+from readthedocs.builds.models import Version
+from readthedocs.projects.models import Project
 
+from .models import PageView
+from .tasks import increase_page_view_count
 from .utils import (
     anonymize_ip_address,
     anonymize_user_agent,
@@ -87,3 +95,82 @@ def test_get_client_ip_with_remote_addr(self):
         request.META['REMOTE_ADDR'] = '203.0.113.195'
         client_ip = get_client_ip(request)
         self.assertEqual(client_ip, '203.0.113.195')
+
+
+class AnalyticsTasksTests(TestCase):
+    def test_increase_page_view_count(self):
+        project = get(
+            Project,
+            slug='project-1',
+        )
+        version = get(Version, slug='1.8', project=project)
+
+        today = timezone.now()
+        tomorrow = timezone.now() + timezone.timedelta(days=1)
+        yesterday = timezone.now() - timezone.timedelta(days=1)
+
+        assert (
+            PageView.objects.all().count() == 0
+        ), 'There\'s no PageView object created yet.'
+
+        # testing for yesterday
+        with mock.patch('readthedocs.analytics.tasks.timezone.now') as mocked_timezone:
+            mocked_timezone.return_value = yesterday
+
+            increase_page_view_count(
+                project_slug=project.slug,
+                version_slug=version.slug,
+                path='index',
+            )
+
+            assert (
+                PageView.objects.all().count() == 1
+            ), 'PageView object for path \'index\' is created'
+            assert (
+                PageView.objects.all().first().view_count == 1
+            ), '\'index\' has 1 view'
+
+            increase_page_view_count(
+                project_slug=project.slug,
+                version_slug=version.slug,
+                path='index',
+            )
+
+            assert (
+                PageView.objects.all().count() == 1
+            ), 'PageView object for path \'index\' is already created'
+            assert (
+                PageView.objects.all().first().view_count == 2
+            ), '\'index\' has 2 views now'
+
+        # testing for today
+        with mock.patch('readthedocs.analytics.tasks.timezone.now') as mocked_timezone:
+            mocked_timezone.return_value = today
+            increase_page_view_count(
+                project_slug=project.slug,
+                version_slug=version.slug,
+                path='index',
+            )
+
+            assert (
+                PageView.objects.all().count() == 2
+            ), 'PageView object for path \'index\' is created for two days (yesterday and today)'
+            assert (
+                PageView.objects.all().order_by('-date').first().view_count == 1
+            ), '\'index\' has 1 view today'
+
+        # testing for tomorrow
+        with mock.patch('readthedocs.analytics.tasks.timezone.now') as mocked_timezone:
+            mocked_timezone.return_value = tomorrow
+            increase_page_view_count(
+                project_slug=project.slug,
+                version_slug=version.slug,
+                path='index',
+            )
+
+            assert (
+                PageView.objects.all().count() == 3
+            ), 'PageView object for path \'index\' is created for three days (yesterday, today & tomorrow)'
+            assert (
+                PageView.objects.all().order_by('-date').first().view_count == 1
+            ), '\'index\' has 1 view tomorrow'
diff --git a/readthedocs/api/v2/views/footer_views.py b/readthedocs/api/v2/views/footer_views.py
index 5fe91e54240..2dece241987 100644
--- a/readthedocs/api/v2/views/footer_views.py
+++ b/readthedocs/api/v2/views/footer_views.py
@@ -20,7 +20,7 @@
     highest_version,
     parse_version_failsafe,
 )
-from readthedocs.search.tasks import increase_page_view_count
+from readthedocs.analytics.tasks import increase_page_view_count
 
 
 def get_version_compare_data(project, base_version=None):
diff --git a/readthedocs/projects/views/private.py b/readthedocs/projects/views/private.py
index 41623f8ee8a..b23a4ef3654 100644
--- a/readthedocs/projects/views/private.py
+++ b/readthedocs/projects/views/private.py
@@ -32,6 +32,7 @@
     UpdateView,
 )
 
+from readthedocs.analytics.models import PageView
 from readthedocs.builds.forms import RegexAutomationRuleForm, VersionForm
 from readthedocs.builds.models import (
     RegexAutomationRule,
@@ -81,7 +82,7 @@
     ProjectImportMixin,
     ProjectRelationListMixin,
 )
-from readthedocs.search.models import SearchQuery, PageView
+from readthedocs.search.models import SearchQuery
 
 from ..tasks import retry_domain_verification
 
diff --git a/readthedocs/search/admin.py b/readthedocs/search/admin.py
index 80b88d0d75b..77a11e798f9 100644
--- a/readthedocs/search/admin.py
+++ b/readthedocs/search/admin.py
@@ -2,7 +2,7 @@
 
 from django.contrib import admin
 
-from .models import SearchQuery, PageView
+from .models import SearchQuery
 
 
 class SearchQueryAdmin(admin.ModelAdmin):
@@ -14,13 +14,4 @@ class SearchQueryAdmin(admin.ModelAdmin):
     list_select_related = ('project', 'version', 'version__project')
 
 
-class PageViewAdmin(admin.ModelAdmin):
-    raw_id_fields = ('project', 'version')
-    list_display = ('__str__', 'view_count')
-    search_fields = ('project__slug', 'version__slug', 'path')
-    readonly_fields = ('date',)
-    list_select_related = ('project', 'version', 'version__project')
-
-
 admin.site.register(SearchQuery, SearchQueryAdmin)
-admin.site.register(PageView, PageViewAdmin)
diff --git a/readthedocs/search/models.py b/readthedocs/search/models.py
index 5dd447eb7f5..a7cf408fe73 100644
--- a/readthedocs/search/models.py
+++ b/readthedocs/search/models.py
@@ -1,9 +1,7 @@
 """Search Queries."""
 
-import datetime
-
 from django.db import models
-from django.db.models import Count, Sum
+from django.db.models import Count
 from django.db.models.functions import TruncDate
 from django.utils import timezone
 from django.utils.translation import ugettext_lazy as _
@@ -98,111 +96,3 @@ def generate_queries_count_of_one_month(cls, project_slug):
         }
 
         return final_data
-
-
-class PageView(models.Model):
-    project = models.ForeignKey(
-        Project,
-        related_name='page_views',
-        on_delete=models.CASCADE,
-    )
-    version = models.ForeignKey(
-        Version,
-        verbose_name=_('Version'),
-        related_name='page_views',
-        on_delete=models.CASCADE,
-    )
-    path = models.CharField(max_length=4096)
-    view_count = models.PositiveIntegerField(default=0)
-    date = models.DateField(default=datetime.date.today, db_index=True)
-
-    class Meta:
-        unique_together = ("project", "version", "path", "date")
-
-    def __str__(self):
-        return f'PageView: [{self.project.slug}:{self.version.slug}] - {self.path} for {self.date}'
-
-    @classmethod
-    def top_viewed_pages(cls, project, since=None):
-        """
-        Returns top 10 pages according to view counts.
-
-        Structure of returned data is compatible to make graphs.
-        Sample returned data::
-        {
-            'pages': ['index', 'config-file/v1', 'intro/import-guide'],
-            'view_counts': [150, 120, 100]
-        }
-        This data shows that `index` is the most viewed page having 150 total views,
-        followed by `config-file/v1` and `intro/import-guide` having 120 and
-        100 total page views respectively.
-        """
-        if since is None:
-            since = timezone.now().date() - timezone.timedelta(days=30)
-
-        qs = (
-            cls.objects
-            .filter(project=project, date__gte=since)
-            .values_list('path')
-            .annotate(total_views=Sum('view_count'))
-            .values_list('path', 'total_views')
-            .order_by('-total_views')[:10]
-        )
-
-        pages = []
-        view_counts = []
-
-        for data in qs.iterator():
-            pages.append(data[0])
-            view_counts.append(data[1])
-
-        final_data = {
-            'pages': pages,
-            'view_counts': view_counts,
-        }
-
-        return final_data
-
-    @classmethod
-    def page_views_by_date(cls, project_slug, since=None):
-        """
-        Returns the total page views count for last 30 days for a particular project.
-
-        Structure of returned data is compatible to make graphs.
-        Sample returned data::
-            {
-                'labels': ['01 Jul', '02 Jul', '03 Jul'],
-                'int_data': [150, 200, 143]
-            }
-        This data shows that there were 150 page views on 01 July,
-        200 page views on 02 July and 143 page views on 03 July.
-        """
-        if since is None:
-            since = timezone.now().date() - timezone.timedelta(days=30)
-
-        qs = cls.objects.filter(
-            project__slug=project_slug,
-            date__gt=since,
-        ).values('date').annotate(total_views=Sum('view_count')).order_by('date')
-
-        count_dict = dict(
-            qs.order_by('date').values_list('date', 'total_views')
-        )
-
-        # This fills in any dates where there is no data
-        # to make sure we have a full 30 days of dates
-        count_data = [count_dict.get(date) or 0 for date in _last_30_days_iter()]
-
-        # format the date value to a more readable form
-        # Eg. `16 Jul`
-        last_30_days_str = [
-            timezone.datetime.strftime(date, '%d %b')
-            for date in _last_30_days_iter()
-        ]
-
-        final_data = {
-            'labels': last_30_days_str,
-            'int_data': count_data,
-        }
-
-        return final_data
diff --git a/readthedocs/search/tasks.py b/readthedocs/search/tasks.py
index e284240a862..cd82f8fe25e 100644
--- a/readthedocs/search/tasks.py
+++ b/readthedocs/search/tasks.py
@@ -2,13 +2,12 @@
 
 from dateutil.parser import parse
 from django.apps import apps
-from django.db.models import F
 from django.utils import timezone
 from django_elasticsearch_dsl.registries import registry
 
 from readthedocs.builds.models import Version
 from readthedocs.projects.models import Project
-from readthedocs.search.models import SearchQuery, PageView
+from readthedocs.search.models import SearchQuery
 from readthedocs.worker import app
 from .utils import _get_index, _get_document
 
@@ -200,29 +199,3 @@ def record_search_query(project_slug, version_slug, query, total_results, time_s
         query=query,
         total_results=total_results,
     )
-
-
-@app.task(queue='web')
-def increase_page_view_count(project_slug, version_slug, path):
-    project = Project.objects.get(slug=project_slug)
-
-    page_view, _ = PageView.objects.get_or_create(
-        project=project,
-        version=Version.objects.get(project=project, slug=version_slug),
-        path=path,
-        date=timezone.now().date(),
-    )
-    PageView.objects.filter(pk=page_view.pk).update(
-        view_count=F('view_count') + 1
-    )
-
-
-@app.task(queue='web')
-def delete_old_page_counts():
-    """
-    Delete page counts older than 30 days.
-
-    This is intended to run from a periodic task daily.
-    """
-    thirty_days_ago = timezone.now().date() - timezone.timedelta(days=30)
-    return PageView.objects.filter(date__lt=thirty_days_ago).delete()
diff --git a/readthedocs/search/tests/test_search_tasks.py b/readthedocs/search/tests/test_search_tasks.py
index 9f7cb793220..2e13066fef4 100644
--- a/readthedocs/search/tests/test_search_tasks.py
+++ b/readthedocs/search/tests/test_search_tasks.py
@@ -6,9 +6,7 @@
 from django.urls import reverse
 from django.utils import timezone
 
-from readthedocs.projects.models import Project
-from readthedocs.builds.models import Version
-from readthedocs.search.models import SearchQuery, PageView
+from readthedocs.search.models import SearchQuery
 from readthedocs.search import tasks
 
 
@@ -123,74 +121,3 @@ def test_delete_old_search_queries_from_db(self, project):
         assert SearchQuery.objects.all().count() == 1
         tasks.delete_old_search_queries_from_db()
         assert SearchQuery.objects.all().count() == 0
-
-    def test_increase_page_view_count(self, project):
-        today = timezone.now()
-        tomorrow = timezone.now() + timezone.timedelta(days=1)
-        yesterday = timezone.now() - timezone.timedelta(days=1)
-
-        assert (
-            PageView.objects.all().count() == 0
-        ), 'There\'s no PageView object created yet.'
-
-        # testing for yesterday
-        with mock.patch('readthedocs.search.tasks.timezone.now') as mocked_timezone:
-            mocked_timezone.return_value = yesterday
-
-            tasks.increase_page_view_count(
-                project_slug=project.slug,
-                version_slug=project.versions.all().first().slug,
-                path='index',
-            )
-
-            assert (
-                PageView.objects.all().count() == 1
-            ), 'PageView object for path \'index\' is created'
-            assert (
-                PageView.objects.all().first().view_count == 1
-            ), '\'index\' has 1 view'
-
-            tasks.increase_page_view_count(
-                project_slug=project.slug,
-                version_slug=project.versions.all().first().slug,
-                path='index',
-            )
-
-            assert (
-                PageView.objects.all().count() == 1
-            ), 'PageView object for path \'index\' is already created'
-            assert (
-                PageView.objects.all().first().view_count == 2
-            ), '\'index\' has 2 views now'
-
-        # testing for today
-        with mock.patch('readthedocs.search.tasks.timezone.now') as mocked_timezone:
-            mocked_timezone.return_value = today
-            tasks.increase_page_view_count(
-                project_slug=project.slug,
-                version_slug=project.versions.all().first().slug,
-                path='index',
-            )
-
-            assert (
-                PageView.objects.all().count() == 2
-            ), 'PageView object for path \'index\' is created for two days (yesterday and today)'
-            assert (
-                PageView.objects.all().order_by('-date').first().view_count == 1
-            ), '\'index\' has 1 view today'
-
-        # testing for tomorrow
-        with mock.patch('readthedocs.search.tasks.timezone.now') as mocked_timezone:
-            mocked_timezone.return_value = tomorrow
-            tasks.increase_page_view_count(
-                project_slug=project.slug,
-                version_slug=project.versions.all().first().slug,
-                path='index',
-            )
-
-            assert (
-                PageView.objects.all().count() == 3
-            ), 'PageView object for path \'index\' is created for three days (yesterday, today & tomorrow)'
-            assert (
-                PageView.objects.all().order_by('-date').first().view_count == 1
-            ), '\'index\' has 1 view tomorrow'
diff --git a/readthedocs/settings/base.py b/readthedocs/settings/base.py
index 3f07ea307d7..0b41f1fa5b7 100644
--- a/readthedocs/settings/base.py
+++ b/readthedocs/settings/base.py
@@ -352,7 +352,7 @@ def USE_PROMOS(self):  # noqa
             'options': {'queue': 'web'},
         },
         'every-day-delete-old-page-views': {
-            'task': 'readthedocs.search.tasks.delete_old_page_counts',
+            'task': 'readthedocs.analytics.tasks.delete_old_page_counts',
             'schedule': crontab(minute=0, hour=1),
             'options': {'queue': 'web'},
         },

From a12bc758901d9d205cdb03b8b8f4552d456d0017 Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Tue, 19 May 2020 07:47:13 -0700
Subject: [PATCH 69/72] Add a setting for storing pageviews

This is so we can disable it if needed based on DB load.
---
 readthedocs/api/v2/views/footer_views.py | 2 +-
 readthedocs/settings/base.py             | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/readthedocs/api/v2/views/footer_views.py b/readthedocs/api/v2/views/footer_views.py
index eb063fb4595..613b683bd8f 100644
--- a/readthedocs/api/v2/views/footer_views.py
+++ b/readthedocs/api/v2/views/footer_views.py
@@ -225,7 +225,7 @@ def get(self, request, format=None):
 
         # increase the page view count for the given page
         page_slug = request.GET.get('page', '')
-        if page_slug:
+        if page_slug and settings.RTD_STORE_PAGEVIEWS:
             increase_page_view_count.delay(
                 project_slug=context['project'].slug,
                 version_slug=context['version'].slug,
diff --git a/readthedocs/settings/base.py b/readthedocs/settings/base.py
index 0b41f1fa5b7..f5839669315 100644
--- a/readthedocs/settings/base.py
+++ b/readthedocs/settings/base.py
@@ -97,6 +97,7 @@ class CommunityBaseSettings(Settings):
     RTD_CLEAN_AFTER_BUILD = False
     RTD_MAX_CONCURRENT_BUILDS = 4
     RTD_BUILD_STATUS_API_NAME = 'docs/readthedocs'
+    RTD_STORE_PAGEVIEWS = True
 
     # Database and API hitting settings
     DONT_HIT_API = False

From b1bee5e36db960c9a30cf4198cd84be96cbe94e8 Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Tue, 19 May 2020 08:07:05 -0700
Subject: [PATCH 70/72] Move setting to feature flag

---
 readthedocs/api/v2/views/footer_views.py                     | 4 ++--
 readthedocs/projects/models.py                               | 5 +++++
 readthedocs/settings/base.py                                 | 2 --
 .../templates/projects/project_traffic_analytics.html        | 3 +++
 4 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/readthedocs/api/v2/views/footer_views.py b/readthedocs/api/v2/views/footer_views.py
index 613b683bd8f..73611a16d22 100644
--- a/readthedocs/api/v2/views/footer_views.py
+++ b/readthedocs/api/v2/views/footer_views.py
@@ -16,7 +16,7 @@
 from readthedocs.builds.models import Version
 from readthedocs.core.utils.extend import SettingsOverrideObject
 from readthedocs.projects.constants import MKDOCS, SPHINX_HTMLDIR
-from readthedocs.projects.models import Project
+from readthedocs.projects.models import Project, Feature
 from readthedocs.projects.version_handling import (
     highest_version,
     parse_version_failsafe,
@@ -225,7 +225,7 @@ def get(self, request, format=None):
 
         # increase the page view count for the given page
         page_slug = request.GET.get('page', '')
-        if page_slug and settings.RTD_STORE_PAGEVIEWS:
+        if page_slug and project.has_feature(Feature.STORE_PAGEVIEWS):
             increase_page_view_count.delay(
                 project_slug=context['project'].slug,
                 version_slug=context['version'].slug,
diff --git a/readthedocs/projects/models.py b/readthedocs/projects/models.py
index 0006ccdd914..40af8e6fc44 100644
--- a/readthedocs/projects/models.py
+++ b/readthedocs/projects/models.py
@@ -1468,6 +1468,7 @@ def add_features(sender, **kwargs):
     FORCE_SPHINX_FROM_VENV = 'force_sphinx_from_venv'
     LIST_PACKAGES_INSTALLED_ENV = 'list_packages_installed_env'
     VCS_REMOTE_LISTING = 'vcs_remote_listing'
+    STORE_PAGEVIEWS = 'store_pageviews'
 
     FEATURES = (
         (USE_SPHINX_LATEST, _('Use latest version of Sphinx')),
@@ -1557,6 +1558,10 @@ def add_features(sender, **kwargs):
             VCS_REMOTE_LISTING,
             _('Use remote listing in VCS (e.g. git ls-remote) if supported for sync versions'),
         ),
+        (
+            STORE_PAGEVIEWS,
+            _('Store pageviews for this project'),
+        ),
     )
 
     projects = models.ManyToManyField(
diff --git a/readthedocs/settings/base.py b/readthedocs/settings/base.py
index f5839669315..7cecf4089a7 100644
--- a/readthedocs/settings/base.py
+++ b/readthedocs/settings/base.py
@@ -1,6 +1,5 @@
 # pylint: disable=missing-docstring
 
-import getpass
 import os
 import subprocess
 
@@ -97,7 +96,6 @@ class CommunityBaseSettings(Settings):
     RTD_CLEAN_AFTER_BUILD = False
     RTD_MAX_CONCURRENT_BUILDS = 4
     RTD_BUILD_STATUS_API_NAME = 'docs/readthedocs'
-    RTD_STORE_PAGEVIEWS = True
 
     # Database and API hitting settings
     DONT_HIT_API = False
diff --git a/readthedocs/templates/projects/project_traffic_analytics.html b/readthedocs/templates/projects/project_traffic_analytics.html
index 0de7e4e7b19..bf4a89e1466 100644
--- a/readthedocs/templates/projects/project_traffic_analytics.html
+++ b/readthedocs/templates/projects/project_traffic_analytics.html
@@ -12,6 +12,9 @@
 
 {% block project_edit_content %}
   <h3>{% trans "Top viewed pages of the past month" %}</h3>
+    <p>
+      This beta feature can be enabled by <a href="mailto:{{ SUPPORT_EMAIL }}">asking support</a>.
+    </p>
     <div class="module-list">
       <div class="module-list-wrapper">
         <ul class="long-list-overflow">

From 14dc98d0dec67cbbf6e8e0cf6830214832838540 Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Tue, 19 May 2020 08:20:54 -0700
Subject: [PATCH 71/72] Fix tests since we added a query for feature flag

---
 readthedocs/rtd_tests/tests/test_footer.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/readthedocs/rtd_tests/tests/test_footer.py b/readthedocs/rtd_tests/tests/test_footer.py
index 933988c35c4..9f3e0902176 100644
--- a/readthedocs/rtd_tests/tests/test_footer.py
+++ b/readthedocs/rtd_tests/tests/test_footer.py
@@ -418,7 +418,7 @@ class TestFooterPerformance(APITestCase):
 
     # The expected number of queries for generating the footer
     # This shouldn't increase unless we modify the footer API
-    EXPECTED_QUERIES = 13
+    EXPECTED_QUERIES = 14
 
     def setUp(self):
         self.pip = Project.objects.get(slug='pip')

From 812f6cec3ec2b62f6089bc8bc5098e1925332abd Mon Sep 17 00:00:00 2001
From: Eric Holscher <eric@ericholscher.com>
Date: Tue, 19 May 2020 08:27:14 -0700
Subject: [PATCH 72/72] Release 5.1.0

---
 CHANGELOG.rst | 36 ++++++++++++++++++++++++++++++++++++
 setup.cfg     |  2 +-
 2 files changed, 37 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.rst b/CHANGELOG.rst
index f0e24d2d36c..b8c6e18632d 100644
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@@ -1,3 +1,39 @@
+Version 5.1.0
+-------------
+
+:Date: May 19, 2020
+
+This release includes one major new feature which is Pageview Analytics.
+This allows projects to see the pages in their docs that have been viewed in the past 30 days,
+giving them an idea of what pages to focus on when updating them.
+
+This release also has a few small search improvements, doc updates, and other bugfixes as well.
+
+* `@ericholscher <https://github.com/ericholscher>`__: Add a setting for storing pageviews (`#7097 <https://github.com/readthedocs/readthedocs.org/pull/7097>`__)
+* `@stsewd <https://github.com/stsewd>`__: Footer: Check for mkdocs doctype too (`#7094 <https://github.com/readthedocs/readthedocs.org/pull/7094>`__)
+* `@ericholscher <https://github.com/ericholscher>`__: Fix the unresolver not working properly with root paths (`#7093 <https://github.com/readthedocs/readthedocs.org/pull/7093>`__)
+* `@stsewd <https://github.com/stsewd>`__: Privacy levels: migrate protected versions (`#7092 <https://github.com/readthedocs/readthedocs.org/pull/7092>`__)
+* `@humitos <https://github.com/humitos>`__: Guide for Embed API (`#7089 <https://github.com/readthedocs/readthedocs.org/pull/7089>`__)
+* `@davidfischer <https://github.com/davidfischer>`__: Document HSTS support (`#7083 <https://github.com/readthedocs/readthedocs.org/pull/7083>`__)
+* `@stsewd <https://github.com/stsewd>`__: Search: record queries with 0 results (`#7081 <https://github.com/readthedocs/readthedocs.org/pull/7081>`__)
+* `@stsewd <https://github.com/stsewd>`__: Search: track total results (`#7080 <https://github.com/readthedocs/readthedocs.org/pull/7080>`__)
+* `@humitos <https://github.com/humitos>`__: Proxy embed URL (`#7079 <https://github.com/readthedocs/readthedocs.org/pull/7079>`__)
+* `@stsewd <https://github.com/stsewd>`__: Search: Little refactor (`#7076 <https://github.com/readthedocs/readthedocs.org/pull/7076>`__)
+* `@davidfischer <https://github.com/davidfischer>`__: Canonical/HTTPS redirect fix (`#7075 <https://github.com/readthedocs/readthedocs.org/pull/7075>`__)
+* `@santos22 <https://github.com/santos22>`__: Fix tests ahead of django-dynamic-fixture update (`#7073 <https://github.com/readthedocs/readthedocs.org/pull/7073>`__)
+* `@stsewd <https://github.com/stsewd>`__: Sphinx Search: don't skip indexing if one file fails (`#7071 <https://github.com/readthedocs/readthedocs.org/pull/7071>`__)
+* `@stsewd <https://github.com/stsewd>`__: Search: generate full link from the server side (`#7070 <https://github.com/readthedocs/readthedocs.org/pull/7070>`__)
+* `@ericholscher <https://github.com/ericholscher>`__: Fix PR builds being marked built (`#7069 <https://github.com/readthedocs/readthedocs.org/pull/7069>`__)
+* `@ericholscher <https://github.com/ericholscher>`__: Add a page about choosing between .com/.org (`#7068 <https://github.com/readthedocs/readthedocs.org/pull/7068>`__)
+* `@ericholscher <https://github.com/ericholscher>`__: Release 5.0.0 (`#7064 <https://github.com/readthedocs/readthedocs.org/pull/7064>`__)
+* `@stsewd <https://github.com/stsewd>`__: Search: Index more content from sphinx (`#7063 <https://github.com/readthedocs/readthedocs.org/pull/7063>`__)
+* `@santos22 <https://github.com/santos22>`__: Hide unbuilt versions in footer flyout (`#7056 <https://github.com/readthedocs/readthedocs.org/pull/7056>`__)
+* `@ericholscher <https://github.com/ericholscher>`__: Docs: Refactor and simplify our docs (`#7052 <https://github.com/readthedocs/readthedocs.org/pull/7052>`__)
+* `@stsewd <https://github.com/stsewd>`__: Search Document: remove unused class methods (`#7035 <https://github.com/readthedocs/readthedocs.org/pull/7035>`__)
+* `@stsewd <https://github.com/stsewd>`__: Search: iterate over valid facets only (`#7034 <https://github.com/readthedocs/readthedocs.org/pull/7034>`__)
+* `@stsewd <https://github.com/stsewd>`__: RTDFacetedSearch: pass filters in one way only (`#7032 <https://github.com/readthedocs/readthedocs.org/pull/7032>`__)
+* `@dojutsu-user <https://github.com/dojutsu-user>`__: Store Pageviews in DB (`#6121 <https://github.com/readthedocs/readthedocs.org/pull/6121>`__)
+
 Version 5.0.0
 -------------
 
diff --git a/setup.cfg b/setup.cfg
index f00f192f884..534e38d8c67 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -1,6 +1,6 @@
 [metadata]
 name = readthedocs
-version = 5.0.0
+version = 5.1.0
 license = MIT
 description = Read the Docs builds and hosts documentation
 author = Read the Docs, Inc