Added "View as markdown" button (#3161)

* Added "View as Markdown" buttons

* Review feedback + added tests

* Before re-review

* View on GitHub

Author: mnocon

.github/workflows/build.yaml

@@ -65,6 +65,25 @@ jobs:
                         exit 1
                     fi
 
+    python-tests:
+        runs-on: ubuntu-latest
+
+        steps:
+            - uses: actions/checkout@v4
+
+            - name: Set up Python
+              uses: actions/setup-python@v3
+              with:
+                  python-version: "3.13"
+
+            - name: Install dependencies
+              run: |
+                  python -m pip install --upgrade pip
+                  pip install -r requirements-dev.txt
+
+            - name: Run pytest
+              run: pytest
+
     markdownlint:
         runs-on: ubuntu-latest
         if: github.event_name == 'pull_request'

.gitignore

@@ -1,7 +1,7 @@
 /vendor/
 **/.DS_Store
 __pycache__/*
-hooks/__pycache__/*
+**/__pycache__
 /site/
 **/.idea/
 .php-cs-fixer.cache

docs/css/custom.css

@@ -158,7 +158,7 @@ body {
 }
 
 .md-typeset h1 {
-    margin: 0 0 1rem;
+    margin: 0 0 0.5rem;
     font-size: 24px;
     line-height: 34px;
 }
@@ -649,3 +649,73 @@ div.path {
 [hidden] {
     display: none !important;
 }
+
+.page-actions {
+    display: none;
+    gap: 0;
+    margin: 12px 0 2rem 0;
+    padding-bottom: 6px;
+    border-bottom: 1px solid var(--ibexa-snow);
+}
+
+.md-typeset .page-action-btn {
+    display: inline-flex;
+    align-items: center;
+    gap: 6px;
+    padding: 4px 12px;
+    background: transparent;
+    border: none;
+    text-decoration: none;
+    color: var(--ibexa-dusk-black);
+    font-size: 13px;
+    font-weight: 500;
+    cursor: pointer;
+    transition: color 0.15s ease;
+    white-space: nowrap;
+    position: relative;
+}
+
+.page-action-btn+.page-action-btn::before {
+    content: '';
+    position: absolute;
+    left: 0;
+    top: 50%;
+    transform: translateY(-50%);
+    height: 16px;
+    width: 1px;
+    background: var(--ibexa-snow);
+}
+
+.page-action-btn svg {
+    width: 14px;
+    height: 14px;
+    fill: currentColor;
+    flex-shrink: 0;
+}
+
+.page-action-btn.external::after,
+.page-action-btn[rel="nofollow"]::after {
+    display: none;
+}
+
+@media (max-width: 768px) {
+    .page-actions {
+        gap: 0;
+    }
+}
+
+.page-actions--visible {
+    display: flex;
+}
+
+.page-action-btn.page-action-btn--success {
+    background: #d4edda;
+    border-color: #c3e6cb;
+    color: #155724;
+}
+
+.page-action-btn.page-action-btn--info {
+    background: color-mix(in srgb, var(--turquoise-pearl) 25%, white);
+    border-color: color-mix(in srgb, var(--turquoise-pearl) 40%, white);
+    color: var(--sherpa-blue);
+}

docs/css/navigation.css

@@ -393,7 +393,7 @@
     margin-left: 0;
     margin-top: 0;
     margin-bottom: 0;
-    padding-bottom: 2rem;
+    padding-bottom: 0.5rem;
 }
 
 ul.breadcrumbs li.breadcrumb-item {

docs/css/release-notes.css

@@ -82,7 +82,7 @@
                     <a href="release_notes/ibexa_dxp_v5.0/">Release notes</a>
                 </div>
                 <div class="notification__image">
-                    <img src="images/notification-latest-release.svg" alt="The latest release" />
+                    <img src="images/notification-latest-release.svg" alt="" />
                 </div>
             </div>
         </div>
@@ -97,7 +97,7 @@
                     <a href="ibexa_products/editions/#lts-updates">Discover other LTS Updates</a>
                 </div>
                 <div class="notification__image">
-                    <img src="images/notification-lts-update.svg" alt="LTS Update" />
+                    <img src="images/notification-lts-update.svg" alt="" />
                 </div>
             </div>
         </div>

docs/index.md

@@ -1,6 +1,7 @@
 ---
 description: Explore Personalization API sets that let you manage item data, track events, combine tracking data with users and render recommendations.
 page_type: landing_page
+exclude_from_llmstxt: true
 ---
 
 # Personalization API

docs/personalization/api_reference/api_reference.md

@@ -1,5 +1,6 @@
 ---
 description: Personalization server can use external information about the items. Use HTTP methods to create, update or get items from the data store.
+exclude_from_llmstxt: true
 ---
 
 # Content API

docs/personalization/api_reference/content_api.md

@@ -1,6 +1,7 @@
 ---
 description: Use HTTP GET request method to render recommendations.
 month_change: false
+exclude_from_llmstxt: true
 ---
 
 # Recommendation API

docs/personalization/api_reference/recommendation_api.md

@@ -1,5 +1,6 @@
 ---
 description: Allows to track items based on an ID. It covers many content types with the same ID configured for tracking.
+exclude_from_llmstxt: true
 ---
 
 # Tracking API