Add optional slug field to chapter sections to allow for slug overriding (#2617)

* Add optional `slug` field to chapter sections to allow for slug overriding. Useful for including special chars in slug.

* Add tests for optional slug field of chapter sections

* Update docs to include optional slug field of chapter sections

* Improve documentation for slug field of chapter sections

Author: jimbonothing64

csfieldguide/chapters/content/en/human-computer-interaction/sections/mātāpono-māori.md renamed to csfieldguide/chapters/content/en/human-computer-interaction/sections/maataapono-maaori.md

@@ -10,8 +10,9 @@ interface-usability:
 usability-heuristics:
   section-number: 4
 
-mātāpono-māori:
+maataapono-maaori:
   section-number: 5
+  slug: mātāpono-māori
 
 accessibility:
   section-number: 6

csfieldguide/chapters/content/structure/human-computer-interaction/sections/sections.yaml

@@ -34,6 +34,7 @@ def load(self):
         """
         chapter_sections_structure = self.load_yaml_file(self.structure_file_path)
         next_section_number = 1
+        used_slugs = set()
 
         for (section_slug, section_structure) in chapter_sections_structure.items():
             if section_structure is None:
@@ -74,6 +75,24 @@ def load(self):
                 chapter_section_translations[language]["content"] = content.html_string
                 chapter_section_translations[language]["name"] = content.title
 
+            # Override slug. Useful when macrons or other special chars wanted in slug.
+            new_slug = section_structure.get("slug", None)
+            if new_slug:
+                if new_slug == section_slug:
+                    raise InvalidYAMLValueError(
+                        self.structure_file_path,
+                        f"slug - value {new_slug} is invalid.",
+                        f"Must be different from default slug {section_slug}."
+                    )
+                if new_slug in used_slugs:
+                    raise InvalidYAMLValueError(
+                        self.structure_file_path,
+                        f"slug - value {new_slug} is invalid.",
+                        f"Must be unique, {new_slug} has already been used."
+                    )
+                section_slug = new_slug
+                used_slugs.add(section_slug)
+
             chapter_section, created = self.chapter.chapter_sections.update_or_create(
                 number=section_number,
                 defaults={

csfieldguide/chapters/management/commands/_ChapterSectionsLoader.py

@@ -0,0 +1,5 @@
+# This is the first section
+
+## This is a second level heading
+
+This is the content for the first section.

csfieldguide/tests/chapters/loaders/assets/chapter-sections/en/multiple-sections-duplicate-slug/multiple-sections-duplicate-slug-1.md

@@ -0,0 +1,7 @@
+# This is the second section
+
+## This is a second level heading
+
+## This is another second level heading
+
+This is the content for the second section.

csfieldguide/tests/chapters/loaders/assets/chapter-sections/en/multiple-sections-duplicate-slug/multiple-sections-duplicate-slug-2.md

@@ -0,0 +1,3 @@
+# This is the section heading
+
+This is the content for the section.

csfieldguide/tests/chapters/loaders/assets/chapter-sections/en/single-section-invalid-slug/single-section-invalid-slug.md

@@ -0,0 +1,3 @@
+# This is the section heading
+
+This is the content for the section.

csfieldguide/tests/chapters/loaders/assets/chapter-sections/en/single-section-slug/single-section-slug.md

@@ -0,0 +1,7 @@
+multiple-sections-duplicate-slug-1:
+  section-number: 1
+  slug: new-slug
+
+multiple-sections-duplicate-slug-2:
+  section-number: 2
+  slug: new-slug

csfieldguide/tests/chapters/loaders/assets/chapter-sections/structure/multiple-sections-duplicate-slug/multiple-sections-duplicate-slug.yaml

@@ -0,0 +1,3 @@
+single-section-invalid-slug:
+  section-number: 1
+  slug: single-section-invalid-slug

csfieldguide/tests/chapters/loaders/assets/chapter-sections/structure/single-section-invalid-slug/single-section-invalid-slug.yaml

@@ -0,0 +1,3 @@
+single-section-slug:
+  section-number: 1
+  slug: new-slug