docs: replace code marks with :isv[] where applicable

.github/workflows/pr.yml

@@ -4,37 +4,64 @@ on:
     branches:
       - main
 jobs:
-  mdx-lint:
+  preview-website:
     runs-on: ubuntu-latest
+    environment:
+      name: preview
+      url: https://site-interslavic-pr-${{ github.event.pull_request.number }}.surge.sh
+    env:
+      GITHUB_PR_NUMBER: ${{ github.event.pull_request.number }}
+      DEPLOYMENT_URL: https://site-interslavic-pr-${{ github.event.pull_request.number }}.surge.sh
     steps:
+      - name: Start deployment
+        uses: bobheadxi/deployments@v1
+        id: deployment
+        with:
+          step: start
+          token: ${{ secrets.GITHUB_TOKEN }}
+          env: preview
+
       - name: Checkout
         uses: actions/checkout@v3
         with:
           fetch-depth: 2 # To retrieve the preceding commit.
 
-      - name: Get changed docs
-        id: docs
+      - name: Get changed files
+        id: changed-files
         uses: tj-actions/changed-files@v41
         with:
-          files: |
-            docs/**/*.{md,mdx}
+          separator: '\n'
 
-      - name: Get changed translations
-        id: translations
-        uses: tj-actions/changed-files@v41
-        with:
-          files: |
-            i18n/**/*.{md,mdx}
+      - name: Write changed files to log
+        run: |
+          echo "${{ steps.changed-files.outputs.all_changed_files }}" > git-changes.log
+          cat git-changes.log
 
       - name: Set up Node.js
         uses: actions/setup-node@v3
         with:
           node-version-file: '.nvmrc'
 
-      - name: Validate docs
-        if: ${{ steps.docs.outputs.all_changed_files != '' }}
-        run: npx --package=@interslavic/text-plugins isv-verify-i18n ${{ steps.docs.outputs.all_changed_files }} 'i18n/**/*.{md,mdx}'
+      - name: NPM install
+        uses: bahmutov/npm-install@v1
+        with:
+          useLockFile: false
+
+      - name: Build a preview
+        run: npm run build
 
-      - name: Validate translations
-        if: ${{ steps.translations.outputs.all_changed_files != '' }}
-        run: npx --package=@interslavic/text-plugins isv-verify-i18n 'docs/**/*.{md,mdx}' ${{ steps.translations.outputs.all_changed_files }}
+      - name: Deploy to Surge
+        run: npx surge ./build ${{ env.DEPLOYMENT_URL }}
+        env:
+          SURGE_LOGIN: ${{ secrets.SURGE_LOGIN }}
+          SURGE_TOKEN: ${{ secrets.SURGE_TOKEN }}
+
+      - name: Update deployment status
+        uses: bobheadxi/deployments@v1
+        if: always()
+        with:
+          step: finish
+          token: ${{ secrets.GITHUB_TOKEN }}
+          status: ${{ job.status }}
+          env: ${{ steps.deployment.outputs.env }}
+          deployment_id: ${{ steps.deployment.outputs.deployment_id }}

.gitignore

@@ -18,6 +18,7 @@
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+git-changes.log
 
 # IDE
 /.idea

docs/learn/grammar/adjectives.md

@@ -3,6 +3,8 @@ sidebar_position: 2
 license: republish
 author: Jan van Steenbergen
 origin: http://steen.free.fr/interslavic/adjectives.html
+description: "Explore the inflection, short form, adverbs, and degrees of comparison of adjectives in Interslavic. Learn about regular and irregular forms, comparative and superlative structures, and usage examples."
+tags: [interslavic, adjectives, inflection, degrees of comparison, language learning]
 ---
 
 # Adjectives

docs/learn/grammar/conjunctions.md

@@ -3,6 +3,8 @@ sidebar_position: 7
 license: republish
 author: Jan van Steenbergen
 origin: http://steen.free.fr/interslavic/prepositions.html
+description: "Learn about the usage, inflection, and examples of prepositions in Interslavic. Discover how prepositions govern different cases and their meanings in various contexts."
+tags: [interslavic, conjunctions, prepositions, grammar, language learning]
 ---
 
 # Conjunctions

docs/learn/grammar/index.md

@@ -3,6 +3,8 @@ sidebar_position: 6
 license: republish
 author: Jan van Steenbergen
 origin: http://steen.free.fr/interslavic/grammar.html
+description: "Learn about the grammar of Interslavic, a natural and broadly understandable language for Slavs, based on common forms found in Slavic languages."
+tags: [interslavic, grammar, slavic languages, communication, language learning]
 ---
 
 # Grammar

docs/learn/grammar/nouns.md

@@ -2,8 +2,9 @@
 sidebar_position: 1
 license: republish
 author: Jan van Steenbergen
-description: "Genders, numbers, cases, declensions and more"
 origin: http://steen.free.fr/interslavic/nouns.html
+description: "Learn about the genders, numbers, cases, and declensions of nouns in Interslavic. Understand the nuances of noun declension patterns and irregularities."
+tags: [interslavic, nouns, grammar, language learning]
 ---
 
 # Nouns

docs/learn/grammar/numerals.md

@@ -3,6 +3,8 @@ sidebar_position: 4
 license: republish
 author: Jan van Steenbergen
 origin: http://steen.free.fr/interslavic/numerals.html
+description: "Learn about cardinal numbers, ordinal numbers, fractions, collective numbers, and more in Interslavic."
+tags: [interslavic, numerals, grammar, language learning]
 ---
 
 # Numerals

docs/learn/grammar/prepositions.md

@@ -3,6 +3,8 @@ sidebar_position: 6
 license: republish
 author: Jan van Steenbergen
 origin: http://steen.free.fr/interslavic/conjunctions.html
+description: "Learn about the usage, inflection, and examples of conjunctions in Interslavic. Discover how conjunctions connect words, sentences, phrases, and clauses together."
+tags: [interslavic, prepositions, conjunctions, grammar, language learning]
 ---
 
 # Prepositions

docs/learn/grammar/pronouns.md

@@ -1,9 +1,11 @@
 ---
 sidebar_position: 3
+toc_max_heading_level: 2
 license: republish
 author: Jan van Steenbergen
 origin: http://steen.free.fr/interslavic/pronouns.html
-toc_max_heading_level: 2
+description: "Explore the usage, inflection, and examples of pronouns in Interslavic. Learn about personal, reflexive, possessive, demonstrative, relative, interrogative, and indefinite pronouns."
+tags: [interslavic, pronouns, grammar, language learning]
 ---
 
 # Pronouns

docs/learn/grammar/syntax.md

@@ -3,6 +3,8 @@ sidebar_position: 8
 license: republish
 author: Jan van Steenbergen
 origin: http://steen.free.fr/interslavic/syntax.html
+description: "Explore the syntax of Interslavic, a natural and broadly understandable language for Slavs, based on common forms found in Slavic languages."
+tags: [interslavic, syntax, grammar, language learning]
 ---
 
 # Syntax

docs/learn/grammar/verbs.md

@@ -3,6 +3,8 @@ sidebar_position: 5
 license: republish
 author: Jan van Steenbergen
 origin: http://steen.free.fr/interslavic/verbs.html
+description: "Explore the perfective and imperfective aspect, conjugation, and examples of verbs in Interslavic. Learn about regular and irregular forms, and usage."
+tags: [interslavic, verbs, grammar, language learning]
 ---
 
 # Verbs

docs/learn/introduction/constructed-slavic-languages.md

@@ -1,5 +1,10 @@
 ---
 sidebar_position: 4
+license: republish
+author: Jan van Steenbergen
+origin: http://steen.free.fr/interslavic/constructed_slavic_languages.html
+description: "Explore the history and development of artificial Slavic languages, from early attempts in the 16th century to recent projects like Interslavic."
+tags: [constructed languages, slavic languages, language history, language learning]
 ---
 
 # Constructed Slavic languages