Merge pull request #44 from sbcgua/docusaurus-update

Docusaurus update, migrate to pnpm

Author: sbcgua

.github/workflows/deploy-gh-pages.yml

@@ -19,19 +19,22 @@ jobs:
       run:
         working-directory: ./docsite
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
-      - uses: actions/setup-node@v4
+      - uses: pnpm/action-setup@v6
         with:
-          node-version: 22
-          cache: npm
-          cache-dependency-path: './docsite/package-lock.json'
+          version: 10
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: pnpm
+          cache-dependency-path: './docsite/pnpm-lock.yaml'
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install
       - name: Build website
-        run: npm run build
+        run: pnpm run build
 
       - name: Upload Build Artifact
         uses: actions/upload-pages-artifact@v3

.github/workflows/test-deploy-gh-pages.yml

@@ -16,16 +16,19 @@ jobs:
        run:
          working-directory: ./docsite
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
-      - uses: actions/setup-node@v4
+      - uses: pnpm/action-setup@v6
         with:
-          node-version: 22
-          cache: npm
-          cache-dependency-path: './docsite/package-lock.json'
+          version: 10
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: pnpm
+          cache-dependency-path: './docsite/pnpm-lock.yaml'
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install
       - name: Test build website
-        run: npm run build
+        run: pnpm run build

docsite/.npmrc

@@ -0,0 +1,8 @@
+# Prevent malicious scripts
+ignore-scripts=true
+# Block non-registry sources
+block-exotic-subdeps=true
+# Wait for community vetting (7 days)
+minimum-release-age=10080
+# Prevent automatic downgrade attacks
+trustPolicy=no-downgrade

docsite/README.md

@@ -4,41 +4,23 @@ This website is built using [Docusaurus](https://docusaurus.io/), a modern stati
 
 ## Installation
 
-```sh
-npm install
-```
+`pnpm install`
 
 ## Local Development
 
-```sh
-npm start
-```
-
 This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
 
-## Build
+`pnpm start`
 
-```sh
-npm build
-```
+## Build
 
 This command generates static content into the `build` directory and can be served using any static contents hosting service.
 
-## Deployment
-
-Using SSH:
+`pnpm build`
 
-```sh
-USE_SSH=true npm deploy
-```
-
-Not using SSH:
-
-```sh
-GIT_USER=<Your GitHub username> npm deploy
-```
+## Deployment
 
-If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
+Done via github actions
 
 ## Notes
 
@@ -50,3 +32,6 @@ If you are using GitHub pages for hosting, this command is a convenient way to b
 - if blog link is above `truncate` is must be complete (start with `/`), otherwise will be broken on tags page
 - change Repo/Settings/Pages/Source to Github actions (otherwise does not deploy from GA) - after that the pages are based on the GA artifact not the `gh-pages` branch! (TODO: maybe check how to deploy to a branch ... but maybe not)
 - to add search, apply for Algolia
+
+## PNPM
+

docsite/blog/2016-08-28-tab-delimited-text-parser.md

@@ -7,7 +7,7 @@ tags: [old]
 
 I'd like to share a piece of code which might be useful for someone. It is called text2tab (at the time of initial publishing - Abap data parser). Its purpose is parsing of TAB-delimited text into an arbitrary flat structure or internal table. Why TAB-delimited? This is the format which is used automatically if you copy (clipboard) something from Excel - this creates some opportunities for good program usability.
 
-<!-- truncate -->
+{/*truncate*/}
 
 ## Example
 

docsite/blog/2018-09-02-tab-delimited-text-serializer/index.md

@@ -5,13 +5,11 @@ authors: sbcgua
 tags: [old]
 ---
 
-My first article on this topic was quite a while ago - [Abap tab-delimited text parser](/blog/tab-delimited-text-parser) - Since then I added some improvements to the project.
+My first article on this topic was quite a while ago - [Abap tab-delimited text parser](/blog/tab-delimited-text-parser) - Since then I added some improvements to the project. The main new feature is serializing. `ZCL_TEXT2TAB_SERIALIZER` class supports serialization of flat tables and structures. Here is how it works ...
 
-## Serializer - new feature
+{/*truncate*/}
 
-The main new feature is serializing. `ZCL_TEXT2TAB_SERIALIZER` class supports serialization of flat tables and structures. Here is how it works:
-
-<!-- truncate -->
+## Let's start with an example
 
 ```abap
 data lo_serializer type ref to zcl_text2tab_serializer.

docsite/docusaurus.config.js

@@ -29,7 +29,7 @@ const config = {
 
   future: {
     v4: true,
-    experimental_faster: true,
+    faster: true,
   },
 
   title:   'Text2Tab',