Style improvements for .docx files

Editor manual updates

Author: mckeea

src/guidelines/editor-manual.qmd

@@ -3,7 +3,9 @@ title: "Guide for Writing Techncial Documentation"
 subtitle: "Copernicus Land Monitoring Service"
 author: "European Environment Agency (EEA)"
 version: 0.4
-description: "A comprehensive guide for creating technical documentation for the Copernicus Land Monitoring Service using Quarto. It covers Markdown basics, document rendering, and the review process, ensuring consistency and clarity in documentation."
+description: "A comprehensive guide for creating technical documentation for the Copernicus
+  Land Monitoring Service using Quarto. It covers Markdown basics, document rendering,
+  and the review process, ensuring consistency and clarity in documentation."
 date: "2025-04-05"
 template-version: 1.0
 
@@ -16,6 +18,10 @@ format:
   docx:
     reference-doc: ../styles/template-guideline.docx
   pdf: default
+keywords: ["10. output location", "11. quarto", "12. local", "13. build", "14. special",
+  "15. site.", "2. manage", "3. media", "4. rendering", "5. documentation", "6. html",
+  "7. pdf", "8. docx", "9. preview", "Answer: 1. environment", "Example Output:",
+  "Example:", "```"]
 ---
 
 <!--# maybe we should promote (or at least describe the option of unsing variables in yaml that can be reused in the document:  e.g. product-name: "Example Product" ---  # Welcome to {{ product-name }} Documentation.      -->
@@ -36,7 +42,7 @@ In this section, we explain how the documentation project is organized and where
 
 Below is a typical folder layout for the project: <!--# instead of my-doc.qmd use CLMS_my-product_ATBD.qmd we should rename the templates to better fit the planned naming convention CLMS_template_ATBD.qmd and CLMS_template_PUM.qmd (I wil,share the naming convention file with you soon-->
 
-```
+```markdown
 project-root-doc/
 ├── src/
 │   ├── templates/
@@ -134,18 +140,57 @@ This is another line.
 
 ``` markdown
 - Item one
+
 - Item two
+
   - Subitem
 ```
 
 ### Numbered (Ordered) List
 
 ``` markdown
 1. First step
+
 2. Second step
+
    1. Sub-step
 ```
 
+::: callout-important
+Make sure to include a blank line between list items, and ensure they are correctly indented. This ensures proper rendering in .docx and .pdf outputs. Without these, list entries may merge, misalign, or render incorrectly.
+:::
+
+### Paragraphs Within List Items
+
+To include a paragraph or a block of text as part of a list item, indent the paragraph to match the indentation of the list content. Also, make sure the paragraph follows the list item without a blank line, or it may break the list.
+
+```markdown
+- This is the list item title.
+  This is a paragraph that belongs to the same list item.
+  It should be indented to align with the start of "This is a paragraph..."
+
+- Another item
+  With its own paragraph block.
+```
+
+### Single-Item List Rendering Issue
+
+When a list or sublist contains only one item, it can be incorrectly rendered in .docx or .pdf formats. In such cases, the item may appear in the wrong font or style.
+
+To fix this, apply a custom style to the single list item. In the provided Word template, use the style named "NormalLine". 
+
+Here is how to apply it:
+
+```markdown
+- step 1        
+    - [step 1.1]{custom-style="NormalLine"}\
+```
+
+::: callout-note
+- The custom-style attribute ensures the correct formatting.
+- Don't forget to include the backslash (\) at the end of the line to prevent unwanted spacing or breaks.
+:::
+
 ## Links and Images
 
 ### Link
@@ -393,6 +438,19 @@ This method keeps captions aligned with each image, and works across all output
 
 > ⚠️ **Note:** Tables used for captions will show borders in DOCX and PDF outputs. Removing them requires custom styles in a reference DOCX.
 
+## Page Breaks for .docx/.pdf Outputs
+
+In Quarto, using section breaks (like - - -) may not reliably produce a page break in .docx or .pdf outputs. Instead, to insert a page break that appears only in those formats, use the following block: that appears only in .docx or .pdf outputs, use the following block:
+
+```markdown
+::: {.content-visible format=docx}
+```{=openxml}
+<w:p><w:r><w:br w:type="page"/></w:r></w:p>
+:::
+```
+
+This will ensure that the page break is included in the rendered Word or PDF document, but not visible in HTML or other formats.
+
 ## Equations
 
 Quarto supports mathematical equations using LaTeX-style syntax. You can add inline equations or display equations as blocks.

src/products/Riparian_Zones_Nomenclature_Guideline.qmd

@@ -315,7 +315,7 @@ The minimum mapping unit defined is ≥ 0.5 ha for all objects. A minimum width
 
 [MMW Exceptions:]{.underline}
 
-- To maintain continuity of linear features (Codes 1.2.1.0, 1.2.2.0, 6.2.1.0, 6.2.2.0, 8.1.1.0 and 8.1.2.0); the MMW may fall below the limit of 10 m, over a distance of up to 100 m.
+- [To maintain continuity of linear features (Codes 1.2.1.0, 1.2.2.0, 6.2.1.0, 6.2.2.0, 8.1.1.0 and 8.1.2.0); the MMW may fall below the limit of 10 m, over a distance of up to 100 m.]{custom-style="NormalLine"}\
 
 **Good Practice for Data Display -- Mapping Scale:**
 
@@ -465,7 +465,7 @@ This category includes:
 
 - **1.1 Urban fabric, industrial, commercial, public, military and private units**
 
-Urban fabric contains land covered by artificial structures and transport networks. Industrial or commercial units are almost completely covered by artificial surface.
+  Urban fabric contains land covered by artificial structures and transport networks. Industrial or commercial units are almost completely covered by artificial surface.
 
   - 1.1.1 Urban fabric (predominantly public and private units)
 
@@ -477,47 +477,47 @@ Urban fabric contains land covered by artificial structures and transport networ
 
   - 1.1.2 Industrial, commercial and military units
 
-    - 1.1.2.0 Industrial, commercial and military units
+    - [1.1.2.0 Industrial, commercial and military units]{custom-style="NormalLine"}\
 
 - **1.2 Transport infrastructure**
 
-Motorways, roads and railways with its associated land and installations are included in this class if width \>10 m. Airports and port areas with installations and associated land are included. If an infrastructure line is crossing a river, the bridge has to be mapped if the bridge is wider than 10 m.
+  Motorways, roads and railways with its associated land and installations are included in this class if width \>10 m. Airports and port areas with installations and associated land are included. If an infrastructure line is crossing a river, the bridge has to be mapped if the bridge is wider than 10 m.
 
   - 1.2.1 Road networks and associated land
 
-    - 1.2.1.0 Road networks and associated land
+    - [1.2.1.0 Road networks and associated land]{custom-style="NormalLine"}\
 
   - 1.2.2 Railways and associated land
 
-    - 1.2.2.0 Railways and associated land
+    - [1.2.2.0 Railways and associated land]{custom-style="NormalLine"}\
 
   - 1.2.3 Port areas and associated land
 
-    - 1.2.3.0 Port areas and associated land
+    - [1.2.3.0 Port areas and associated land]{custom-style="NormalLine"}\
 
   - 1.2.4 Airports and associated land
 
-    - 1.2.4.0 Airports and associated land
+    - [1.2.4.0 Airports and associated land]{custom-style="NormalLine"}\
 
 - **1.3 Mineral extraction, dump and construction sites, land without current use**
 
-Dump sites include public, industrial or mine dump sites. Construction development, soil and bedrock excavations and earthwork are included in this class. Land without current use is land that is in transitional phase and it is included in urban areas.
+  Dump sites include public, industrial or mine dump sites. Construction development, soil and bedrock excavations and earthwork are included in this class. Land without current use is land that is in transitional phase and it is included in urban areas.
 
    - 1.3.1 Mineral extraction, dump and construction sites
 
-    - 1.3.1.0 Mineral extraction, dump and construction sites
+    - [1.3.1.0 Mineral extraction, dump and construction sites]{custom-style="NormalLine"}\
 
   - 1.3.2 Land without current use
 
-    - 1.3.2.0 Land without current use
+    - [1.3.2.0 Land without current use]{custom-style="NormalLine"}\
 
 - **1.4 Green urban, sports and leisure facilities**
 
 Green urban areas are areas with vegetation within the urban fabric and it includes parks. Sports and leisure facilities are included (camping grounds, sport grounds, leisure parks, golf courses, race courses, etc.). It also comprises parks not surrounded by urban areas.
 
-   - 1.4.0 Green urban, sports and leisure facilities
+  - 1.4.0 Green urban, sports and leisure facilities
 
-    - 1.4.0.0 Green urban, sports and leisure facilities
+    - [1.4.0.0 Green urban, sports and leisure facilities]{custom-style="NormalLine"}\
 
 {{< pagebreak >}}
 
@@ -661,7 +661,7 @@ The build-up areas adjacent to small farms will be included in this class.
 
 **MMW Exceptions:**
 
-- To maintain continuity of linear features (1.2.1.0 / 1.2.2.0 / 6.2.1.0 / 6.2.2.0 / 9.1.1.0 / 9.1.2.0), the MMW may fall below the limit of 10 m over a distance of up to 100 m.
+- [To maintain continuity of linear features (1.2.1.0 / 1.2.2.0 / 6.2.1.0 / 6.2.2.0 / 9.1.1.0 / 9.1.2.0), the MMW may fall below the limit of 10 m over a distance of up to 100 m.]{custom-style="NormalLine"}\
 
 **Methodological Advice:**
 
@@ -4101,7 +4101,7 @@ Sand and gravel of river banks including accumulation of material at bars and fl
 
 **MMW Exceptions:**
 
-- To maintain continuity of linear features, the MMW may fall below the limit of 10 m over a distance of up to 100 m.
+- [To maintain continuity of linear features, the MMW may fall below the limit of 10 m over a distance of up to 100 m.]{custom-style="NormalLine"}\
 
 **Methodological Advice:**