django-spire 0.23.4__py3-none-any.whl

django_spire/knowledge/templates/django_spire/knowledge/entry/item/list_item.html

@@ -0,0 +1,41 @@
+{% extends 'django_spire/item/item.html' %}
+
+{% block item_title %}
+    <div class="row m-0">
+        {% include 'django_spire/element/grabber_element.html' with grabber_class='col-auto align-self-center' %}
+        <div class="col">
+            {% url 'django_spire:knowledge:entry:version:page:editor' pk=entry.current_version_id as entry_detail_url %}
+            {% include 'django_spire/element/attribute_element.html' with attribute_value=entry.name attribute_href=entry_detail_url %}
+        </div>
+    </div>
+{% endblock %}
+
+{% block item_row_content %}
+    <div class="col">
+        {% include 'django_spire/element/attribute_element.html' with attribute_title='Author' attribute_value=entry.current_version.author.get_full_name %}
+    </div>
+    {% if entry.current_version.published_datetime %}
+        <div class="col">
+            {% include 'django_spire/element/attribute_element.html' with attribute_title='Published' attribute_value=entry.current_version.published_datetime %}
+        </div>
+    {% endif %}
+    <div class="col">
+        {% include 'django_spire/element/attribute_element.html' with attribute_title='Last Edit' attribute_value=entry.current_version.last_edit_datetime %}
+    </div>
+    <div class="col-auto">
+        {% include 'django_spire/knowledge/entry/badge/entry_status_badge.html' with status=entry.current_version.status %}
+    </div>
+{% endblock %}
+
+{% block item_button %}
+    {% if AuthController.knowledge.can_view %}
+        {% url 'django_spire:knowledge:entry:version:page:editor' pk=entry.current_version_id as entry_detail_url %}
+    {% endif %}
+    {% if AuthController.knowledge.can_change %}
+        {% url 'django_spire:knowledge:entry:form:update' pk=entry.pk collection_pk=collection.pk as entry_edit_url %}
+    {% endif %}
+    {% if AuthController.knowledge.can_delete %}
+        {% url 'django_spire:knowledge:entry:page:delete' pk=entry.pk as entry_delete_url %}
+    {% endif %}
+    {% include 'django_spire/dropdown/ellipsis_dropdown.html' with view_url=entry_detail_url edit_url=entry_edit_url delete_url=entry_delete_url %}
+{% endblock %}

django_spire/knowledge/templates/django_spire/knowledge/entry/modal/publish_confirm_modal.html

@@ -0,0 +1,21 @@
+{% extends 'django_spire/modal/center_modal.html' %}
+
+{% block modal_trigger %}
+    {% include 'django_spire/button/primary_button.html' with button_text='Publish' button_class='btn-md' %}
+{% endblock %}
+
+{% block modal_content %}
+	<form
+        class="row text-center"
+        method="post"
+        action="{% url 'django_spire:knowledge:entry:version:redirect:publish' pk=entry.current_version_id %}"
+    >
+        {% csrf_token %}
+        <div class="col-12">
+            Are you sure you want to publish {{ entry }}?
+        </div>
+        <div class="col-12 mt-2">
+            {% include 'django_spire/contrib/form/button/form_submit_button.html' with button_text='Publish' %}
+        </div>
+    </form>
+{% endblock %}

django_spire/knowledge/templates/django_spire/knowledge/entry/page/form_page.html

@@ -0,0 +1,9 @@
+{% extends 'django_spire/knowledge/navigation/page/../../page/full_page.html' %}
+
+{% block knowledge_full_page_content %}
+    <div class="row">
+        <div class="col-12">
+            {% include 'django_spire/knowledge/entry/card/form_card.html' %}
+        </div>
+    </div>
+{% endblock %}

django_spire/knowledge/templates/django_spire/knowledge/entry/page/import_form_page.html

@@ -0,0 +1,9 @@
+{% extends 'django_spire/knowledge/navigation/page/../../page/full_page.html' %}
+
+{% block knowledge_full_page_content %}
+    <div class="row">
+        <div class="col-12">
+            {% include 'django_spire/knowledge/entry/container/import_form_container.html' %}
+        </div>
+    </div>
+{% endblock %}

django_spire/knowledge/templates/django_spire/knowledge/entry/version/container/editor_container.html

@@ -0,0 +1,80 @@
+{% extends 'django_spire/knowledge/container/container.html' %}
+
+{% block container_title %}
+    {{ entry.name }}
+{% endblock %}
+
+{% block container_subtitle %}
+    <div class="row">
+        <div class="col text-end">
+            {% if not entry.current_version.is_published and AuthController.knowledge.can_change %}
+                {% include 'django_spire/knowledge/entry/modal/publish_confirm_modal.html' %}
+            {% else %}
+                {% include 'django_spire/knowledge/entry/badge/entry_status_badge.html' with status=entry.current_version.status %}
+            {% endif %}
+        </div>
+    {% if AuthController.knowledge.can_change %}
+        <div class="col text-start"
+                x-data="{
+                editor_is_readonly: !should_init_editor_in_edit_mode(),
+                toggle_editor_readonly() {
+                    KNOWLEDGE_ENTRY_VERSION_EDITOR?.readOnly?.toggle()
+                    this.editor_is_readonly = KNOWLEDGE_ENTRY_VERSION_EDITOR?.readOnly?.isEnabled
+
+                    if (this.editor_is_readonly) {
+                        django_glue_fetch(
+                            '{% url "django_spire:knowledge:entry:version:json:update_entry_from_version" pk=entry.id %}',
+                        )
+                    }
+
+                    let view_mode = this.editor_is_readonly ? 'readonly' : 'edit'
+
+                    let url = new URL(window.location)
+                    url.searchParams.set('view_mode', view_mode)
+                    history.pushState(null, '', url);
+                }
+            }"
+        >
+            <div
+                    @click="toggle_editor_readonly();"
+                    class="btn btn-app-primary btn-sm shadow-sm"
+            >
+                <i :class="editor_is_readonly ? 'bi bi-pencil' : 'bi bi-check-lg'" class="me-1"></i>
+                <span x-text="editor_is_readonly ? 'Edit' : 'Save'"></span>
+            </div>
+        </div>
+    {% endif %}
+    </div>
+{% endblock %}
+
+
+{% block container_content %}
+    <div class="container">
+        <div class="row px-3">
+            <div class="col">
+                <script>
+                    // Define editor instance outside of alpine js scope to avoid potential issues caused by reactivity
+                    // and to allow above button to access
+                    let KNOWLEDGE_ENTRY_VERSION_EDITOR;
+                </script>
+
+                {# The EditorJS will be attached to this div #}
+                <div
+                    :id="editor_element_id"
+                    x-data="{
+                    editor_element_id: 'knowledge-entry-version-editor',
+                    init() {
+                        KNOWLEDGE_ENTRY_VERSION_EDITOR = create_editorjs_instance({
+                            holder_id: this.editor_element_id,
+                            initial_editor_blocks: {{ version_blocks }},
+                            update_url: '{% url "django_spire:knowledge:entry:version:json:update_blocks" pk=entry.id %}'
+                        })
+                    }
+
+                }"
+                >
+                </div>
+            </div>
+        </div>
+    </div>
+{% endblock %}

django_spire/knowledge/templates/django_spire/knowledge/entry/version/page/editor_page.html

@@ -0,0 +1,76 @@
+{% extends 'django_spire/knowledge/page/full_page.html' %}
+
+{% load static %}
+{% load spire_core_tags %}
+
+{% block base_head_additional_css %}
+    <link href="{% static 'django_spire/knowledge/css/editor.css' %}?v={{ DJANGO_SPIRE_VERSION }}" rel="stylesheet">
+{% endblock %}
+
+{% block base_body_additional_top_js %}
+    {{ block.super }}
+
+    <script src="https://cdn.jsdelivr.net/npm/@editorjs/editorjs@2.31.0/dist/editorjs.umd.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@editorjs/paragraph@2.11.7/dist/paragraph.umd.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@editorjs/list@2.0.8/dist/editorjs-list.umd.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@editorjs/header@2.8.8/dist/header.umd.min.js"></script>
+{% endblock %}
+
+{% block full_page_sub_navigation %}
+    {% include 'django_spire/knowledge/sub_navigation/widget/collection_entry_sub_navigation_widget.html' with current_collection_id=entry.collection.id current_version_id=current_version.id %}
+{% endblock %}
+
+{% block full_page_info_navigation %}
+    <div class="row">
+        <div class="col-12 mb-3">
+            {% include 'django_spire/element/attribute_element.html' with attribute_title='Author' attribute_value=entry.current_version.author.get_full_name %}
+        </div>
+    </div>
+
+    <div class="row">
+        <div class="col-12 mb-3">
+            {% include 'django_spire/element/attribute_element.html' with attribute_title='Status' %}
+            {% include 'django_spire/knowledge/entry/badge/entry_status_badge.html' with status=entry.current_version.status %}
+        </div>
+    </div>
+
+    {% if entry.current_version.published_datetime %}
+        <div class="row">
+            <div class="col-12 mb-3">
+                {% include 'django_spire/element/attribute_element.html' with attribute_title='Published' attribute_value=entry.current_version.published_datetime %}
+            </div>
+        </div>
+    {% endif %}
+
+    <div class="row">
+        <div class="col-12 mb-3">
+            {% include 'django_spire/element/attribute_element.html' with attribute_title='Last Edit' attribute_value=entry.current_version.last_edit_datetime %}
+        </div>
+    </div>
+
+    <div class="row">
+        <div class="col-12 mb-3">
+            {% include 'django_spire/element/attribute_element.html' with attribute_title='Tags' %}
+            {% for tag, weight in entry.simplified_and_weighted_tag_dict|safe_dict_items %}
+                {% include 'django_spire/tag/element/tag.html' %}
+            {% endfor %}
+        </div>
+    </div>
+{% endblock %}
+
+{% block knowledge_full_page_content %}
+    <div class="row justify-content-center ps-3">
+        <div class="col-12">
+            {% include 'django_spire/knowledge/entry/version/container/editor_container.html' %}
+        </div>
+    </div>
+{% endblock %}
+
+{% block base_body_additional_bottom_js %}
+    {{ block.super }}
+
+    <script src="{% static 'django_spire/knowledge/entry/version/js/null_paragraph.js' %}?v={{ DJANGO_SPIRE_VERSION }}"
+            type="application/javascript"></script>
+    <script src="{% static 'django_spire/knowledge/entry/version/js/editor.js' %}?v={{ DJANGO_SPIRE_VERSION }}"
+            type="application/javascript"></script>
+{% endblock %}

django_spire/knowledge/templates/django_spire/knowledge/message/knowledge_message_intel.html

@@ -0,0 +1,32 @@
+{% extends 'django_spire/ai/chat/message/message.html' %}
+
+{% block message_content %}
+    <div class="row">
+        <div class="col">
+            {{ message_intel.answer_intel.answer|linebreaksbr }}
+        </div>
+    </div>
+
+    <div class="row mt-2 p-1" x-data="{show_resources: false}">
+        <div class="col-auto mx-2 ps-1 pe-2 py-1 fs-7 rounded-3 border border-primary-subtle">
+            <span class="text-muted cursor-pointer" x-on:click="show_resources = !show_resources">
+                <i class="bi bi-caret-right" x-show="!show_resources"></i>
+                <i class="bi bi-caret-down" x-show="show_resources"></i>
+                Sources
+            </span>
+
+            <ul class="my-0 me-3" x-show="show_resources">
+                {% for entry_intel in message_intel.entries_intel %}
+                    <li class="pb-1">
+                        <a href="{% url 'django_spire:knowledge:entry:version:page:editor' pk=entry_intel.entry.id %}?show_sub_nav=false&block_id={{ entry_intel.relevant_block_id }}"
+                           target="_blank">
+                            {{ entry_intel.relevant_heading_text }}
+                        </a>
+                    </li>
+                {% endfor %}
+            </ul>
+
+        </div>
+    </div>
+
+{% endblock %}

django_spire/knowledge/templates/django_spire/knowledge/page/full_page.html

@@ -0,0 +1,37 @@
+{% extends 'django_spire/page/full_page.html' %}
+
+{% load static %}
+
+{% block base_head_additional_css %}
+    <link href="{% static 'django_spire/knowledge/css/navigation_items.css' %}?v={{ DJANGO_SPIRE_VERSION }}" rel="stylesheet">
+{% endblock %}
+
+{% block base_body_top_js %}
+    <script src="{% static 'django_spire/knowledge/collection/js/managers.js' %}?v={{ DJANGO_SPIRE_VERSION }}" type="application/javascript"></script>
+{% endblock %}
+
+{% block full_page_sub_navigation_title %}
+    {{ collection.name_short }}
+{% endblock %}
+
+{% block full_page_sub_navigation_buttons %}
+    {% if AuthController.knowledge.can_add %}
+        {% url 'django_spire:knowledge:collection:form:create' as create_url %}
+        {% include 'django_spire/button/primary_button.html' with button_text='Add' button_href=create_url button_icon="bi bi-plus" %}
+    {% endif %}
+{% endblock %}
+
+{% block full_page_info_navigation_title %}
+    More Info
+{% endblock %}
+
+{% block full_page_content %}
+    <div class="main-content-with-panels">
+        {% block knowledge_full_page_content %}
+        {% endblock %}
+    </div>
+{% endblock %}
+
+{% block base_body_additional_bottom_js %}
+    <script src="{% static 'django_spire/knowledge/collection/js/x_component.js' %}?v={{ DJANGO_SPIRE_VERSION }}" type="application/javascript"></script>
+{% endblock %}

django_spire/knowledge/templates/django_spire/knowledge/page/home_page.html

@@ -0,0 +1,11 @@
+{% extends 'django_spire/knowledge/page/full_page.html' %}
+
+{% load static %}
+
+{% block full_page_content %}
+    <div class="row">
+        <div class="col-12">
+            {% include 'django_spire/knowledge/collection/card/top_level_list_card.html' %}
+        </div>
+    </div>
+{% endblock %}

django_spire/knowledge/templates/django_spire/knowledge/sub_navigation/element/collection_sub_navigation_ellipsis_dropdown.html

@@ -0,0 +1,15 @@
+{% extends 'django_spire/dropdown/ellipsis_dropdown.html' %}
+
+{% block dropdown_content %}
+    {% if AuthController.knowledge.can_change %}
+        {% include 'django_spire/dropdown/element/dropdown_link_element.html' with x_link_url='collection.edit_url' link_icon='bi bi-pencil' link_text='Edit Collection' %}
+    {% endif %}
+    {% if AuthController.knowledge.can_add %}
+        {% include 'django_spire/dropdown/element/dropdown_link_element.html' with x_link_url='collection.create_entry_url' link_icon='bi bi-plus' link_text='Add Entry' %}
+        {% include 'django_spire/dropdown/element/dropdown_link_element.html' with x_link_url='collection.import_entry_url' link_icon='bi bi-upload' link_text='Import Entry' %}
+    {% endif %}
+    {% if AuthController.knowledge.can_delete %}
+        {% include 'django_spire/dropdown/element/dropdown_link_element.html' with x_link_url='collection.delete_url' link_icon='bi bi-trash3' link_text='Delete Collection' link_css='text-app-danger' %}
+    {% endif %}
+{% endblock %}
+

django_spire/knowledge/templates/django_spire/knowledge/sub_navigation/element/entry_sub_navigation_ellipsis_dropdown.html

@@ -0,0 +1,12 @@
+{% extends 'django_spire/dropdown/ellipsis_dropdown.html' %}
+
+{% block dropdown_content %}
+    {% if AuthController.knowledge.can_change %}
+        {% include 'django_spire/dropdown/element/dropdown_link_element.html' with x_link_url='entry.edit_url' link_icon='bi bi-input-cursor-text' link_text='Rename' %}
+        {% include 'django_spire/dropdown/element/dropdown_link_element.html' with x_link_url='entry.edit_version_url' link_icon='bi bi-pencil' link_text='Edit' %}
+    {% endif %}
+    {% if AuthController.knowledge.can_delete %}
+        {% include 'django_spire/dropdown/element/dropdown_link_element.html' with x_link_url='entry.delete_url' link_icon='bi bi-trash3' link_text='Delete' link_css='text-app-danger' %}
+    {% endif %}
+{% endblock %}
+

django_spire/knowledge/templates/django_spire/knowledge/sub_navigation/item/collection_sub_navigation_item.html

@@ -0,0 +1,29 @@
+<div
+    class="knowledge-nav-item cursor-pointer row pt-2 pb-1 fs-7"
+    :class="collection.id === current_collection_id && !current_version_id ? 'bg-app-primary-soft rounded-2' : ''"
+>
+    <div
+        class="col d-flex align-items-center overflow-hidden"
+        @click="toggle_expand(collection.id)"
+    >
+        <i
+            :class="is_expanded(collection.id) ? 'bi bi-chevron-down' : 'bi bi-chevron-right'"
+            class="flex-shrink-0"
+            {% if hide_chevron %}
+            style="visibility: hidden"
+            {% else %}
+            :style="{visibility: (collection.has_child_collections() || collection.has_entries()) ? 'visible' : 'hidden'}"
+            {% endif %}
+        ></i>
+        <i
+            :class="is_expanded(collection.id) ? 'bi-folder2-open' : 'bi-folder2'"
+            class="bi flex-shrink-0 ms-1"
+        ></i>
+        <span class="text-truncate ms-1" x-text="collection.name"></span>
+    </div>
+    {% if AuthController.knowledge.can_view %}
+        <div class="col-auto">
+            {% include 'django_spire/knowledge/sub_navigation/element/collection_sub_navigation_ellipsis_dropdown.html' %}
+        </div>
+    {% endif %}
+</div>

django_spire/knowledge/templates/django_spire/knowledge/sub_navigation/item/entry_sub_navigation_item.html

@@ -0,0 +1,21 @@
+<div
+    class="row ms-2 pt-2 pb-1 knowledge-nav-item cursor-pointer fs-7"
+    :class="entry.version_id === current_version_id ? 'bg-app-primary-soft rounded-2' : ''"
+>
+    <a
+        class="col d-flex align-items-center overflow-hidden text-decoration-none text-app-default-text-color"
+        {% if AuthController.knowledge.can_view %}
+            :href="'{% url "django_spire:knowledge:entry:version:page:editor" pk=0 %}'.replace(0, entry.version_id)"
+        {% endif %}
+        data-closes-nav
+    >
+        <i class="bi bi-file-earmark-text flex-shrink-0"></i>
+        <span class="text-truncate ms-1" x-text="entry.name"></span>
+    </a>
+
+    {% if AuthController.knowledge.can_view %}
+        <div class="col-auto">
+            {% include 'django_spire/knowledge/sub_navigation/element/entry_sub_navigation_ellipsis_dropdown.html' %}
+        </div>
+    {% endif %}
+</div>

django_spire/knowledge/templates/django_spire/knowledge/sub_navigation/widget/collection_entry_sub_navigation_widget.html

@@ -0,0 +1,168 @@
+<div
+    x-data="{
+        user_search: '',
+        found_items: new Map(),
+        manager: new CollectionManager({{ collection_tree_json }}),
+        is_dragging: false,
+        current_collection_id: {{ current_collection_id|default:'null' }},
+        current_version_id: {{ current_version_id|default:'null' }},
+        top_level_collection_id: {{ collection.id }},
+        expanded_ids: [],
+
+        init() {
+            if (this.current_collection_id) {
+                this.expand_path_to(this.current_collection_id)
+            }
+        },
+
+        expand_path_to(collection_id) {
+            const collection = this.manager.collection_lookup_map.get(collection_id)
+            if (!collection) return
+
+            let current = collection
+            let ids_to_expand = []
+
+            while (current && current.id !== -1) {
+                ids_to_expand.push(current.id)
+                current = current.parent
+            }
+
+            this.expanded_ids = ids_to_expand
+        },
+
+        is_expanded(collection_id) {
+            return this.expanded_ids.includes(collection_id)
+        },
+
+        toggle_expand(collection_id) {
+            if (this.is_expanded(collection_id)) {
+                this.expanded_ids = this.expanded_ids.filter(id => id !== collection_id)
+            } else {
+                this.expanded_ids.push(collection_id)
+            }
+        },
+
+        toggle_dragging(value) {
+            this.is_dragging = value
+        },
+
+        async move_collection({collection, order, new_parent}) {
+            let response = null
+            if (new_parent === null) {
+                new_parent = this.top_level_collection_id
+            }
+            try {
+                response = await django_glue_fetch(
+                    '{% url "django_spire:knowledge:collection:json:reorder" %}',
+                    {payload: {collection_id: collection.id, order: order, parent: new_parent}}
+                )
+            } catch (e) {
+                 $dispatch('notify', {'type': 'error', 'message': 'An unexpected error has occured. Please refresh the page and try again.'})
+            }
+
+            if (response.type === 'error') {
+                $dispatch('notify', {'type': response.type, 'message': response.message})
+            }
+
+            this.manager.set_parent({collection: collection, parent_id: new_parent})
+        },
+
+        async move_entry({entry, collection, order}) {
+            let response = null
+            try {
+                response = await django_glue_fetch(
+                    '{% url "django_spire:knowledge:entry:json:reorder" %}',
+                    {payload: {entry_id: entry.entry_id, order: order, collection_id: collection.id}}
+                )
+            } catch (e) {
+                 $dispatch('notify', {'type': 'error', 'message': 'An unexpected error has occured. Please refresh the page and try again.'})
+            }
+
+            if (response.type === 'error') {
+                $dispatch('notify', {'type': response.type, 'message': response.message})
+            }
+        },
+
+        search() {
+            let item_map = new Map()
+            const query = this.user_search.toLocaleLowerCase()
+            document.querySelector('.search-items').style.display = query ? 'block' : 'none'
+            document.querySelector('.navigation-items').style.display = query ? 'none' : 'block'
+            document.querySelectorAll('.collection, .entry').forEach(div => {
+                let div_id =  div.id.toLocaleLowerCase()
+
+                let item = {}
+                if (div.classList.contains('collection')) {
+                    item = Alpine.$data(div).collection
+                } else {
+                    item = Alpine.$data(div).entry
+                }
+
+                if (div_id.includes(query)) {
+                    item_map.set(item, item)
+                } else {
+                    item_map.delete(item)
+                }
+            })
+
+            if (!query) {
+                this.found_items.clear()
+            } else {
+                this.found_items = item_map
+            }
+        },
+    }"
+>
+    <div class="container-fluid">
+        <div class="row align-items-center mx-1 pb-2">
+            <div class="col-12 px-0">
+                <input
+                    class="rounded-2 p-1 form-control"
+                    type="text"
+                    placeholder="Search ..."
+                    x-model="user_search"
+                    @input.debounce.300ms="search"
+                >
+            </div>
+        </div>
+    </div>
+    <div
+        class="user-select-none px-2"
+        x-sort:config="{
+            handle: '[x-sort\\:handle]',
+            distance: 20,
+            swapThreshold: 0.01
+        }"
+    >
+        {% include 'django_spire/knowledge/collection/component/x_collection_navigation.html' %}
+
+        <div class="navigation-items">
+            <x-collection-navigation :data="{items: manager.collection_map, id: null}"></x-collection-navigation>
+        </div>
+
+        <div class="search-items">
+            <template x-for="(item, index) in Array.from(found_items.values())" :key="index">
+                <div>
+                    <template x-if="item?.constructor.name === 'Collection'">
+                        <div
+                            x-data="{
+                                collection: item
+                            }"
+                        >
+                            {% include 'django_spire/knowledge/sub_navigation/item/collection_sub_navigation_item.html' with hide_chevron=True %}
+                        </div>
+                    </template>
+                    <template x-if="item?.constructor.name === 'Entry'">
+                        <div
+                            x-data="{
+                                entry: item
+                            }"
+                        >
+                            {% include 'django_spire/knowledge/sub_navigation/item/entry_sub_navigation_item.html' %}
+                        </div>
+                    </template>
+                </div>
+            </template>
+        </div>
+    </div>
+</div>

django_spire/knowledge/templatetags/spire_knowledge_tags.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+import re
+
+from django import template
+
+
+register = template.Library()
+
+
+@register.filter
+def format_to_html(value: str) -> str:
+    if not value:
+        return ' '
+
+    line_break_html = re.sub(r'\n', '<br>', value)
+    bolded_html = re.sub(
+        r'\*\*(.*?)\*\*', r'<span class="fw-bold">\1</span>',
+        line_break_html
+    )
+    italicized_html = re.sub(
+        r'\*(.*?)\*', r'<span class="fst-italic">\1</span>',
+        bolded_html
+    )
+    return re.sub(
+        r'~~(.*?)~~', r'<span class="text-decoration-line-through">\1</span>',
+        italicized_html
+    )

django_spire/knowledge/urls/__init__.py

@@ -0,0 +1,10 @@
+from django.urls import include, path
+
+
+app_name = 'knowledge'
+
+urlpatterns = [
+    path('page/', include('django_spire.knowledge.urls.page_urls', namespace='page')),
+    path('collection/', include('django_spire.knowledge.collection.urls', namespace='collection')),
+    path('entry/', include('django_spire.knowledge.entry.urls', namespace='entry')),
+]

django_spire/knowledge/urls/page_urls.py

@@ -0,0 +1,10 @@
+from django.urls import path
+
+from django_spire.knowledge.views import page_views
+
+
+app_name = 'page'
+
+urlpatterns = [
+    path('', page_views.home_view, name='home'),
+]

django_spire/knowledge/views/page_views.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from django.core.handlers.wsgi import WSGIRequest
+from django.template.response import TemplateResponse
+
+from django_spire.auth.controller.controller import AppAuthController
+from django_spire.contrib.generic_views import portal_views
+from django_spire.knowledge.collection.models import Collection
+
+
+@AppAuthController('knowledge').permission_required('can_view')
+def home_view(request: WSGIRequest) -> TemplateResponse:
+    def breadcrumbs_func(breadcrumbs):
+        breadcrumbs.add_breadcrumb(name='Knowledge')
+
+    return portal_views.list_view(
+        request,
+        model=Collection,
+        breadcrumbs_func=breadcrumbs_func,
+        context_data={
+            'collections': Collection.objects.active().parentless().request_user_has_access(request),
+        },
+        template='django_spire/knowledge/page/home_page.html',
+    )