Merge branch 'source' into add_jsx_attribute_methods

Author: wkillerud

.github/workflows/deploy.yml

@@ -0,0 +1,34 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches:
+      - source
+    # Review gh actions docs if you want to further define triggers, paths, etc
+    # https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#on
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    name: Deploy to GitHub Pages
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 20
+
+      - name: Install dependencies
+        run: npm install
+      - name: Build website
+        run: npm run build
+
+      # Popular action to deploy to GitHub Pages:
+      # Docs: https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-docusaurus
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./build

.gitignore

@@ -1,12 +1,21 @@
-.DS_Store
+# Dependencies
+/node_modules
+
+# Production
+/build
 
-node_modules
+# Generated files
+.docusaurus
+.cache-loader
 
-lib/core/metadata.js
-lib/core/MetadataBlog.js
+# Misc
+.vscode
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
 
-website/translated_docs
-website/build/
-website/yarn.lock
-website/node_modules
-website/i18n/*
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

.travis.yml

@@ -0,0 +1,30 @@
+# Website
+
+This website is built using [Docusaurus 3](https://docusaurus.io/), a modern static website generator.
+
+### Installation
+
+```
+$ npm install
+```
+
+### Local Development
+
+```
+$ 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
+
+```
+$ npm run build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+### Deployment
+
+The site is automatically deployed to GitHub pages whenever changes are made to the source branch.
+Create a new branch with your changes and submit a PR against `source`. Once merged, your changes will be visible at https://podium-lib.io/

Dockerfile

@@ -0,0 +1,3 @@
+module.exports = {
+  presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
+};

README.md

@@ -1,7 +1,8 @@
 ---
+slug: first-blog-post
 title: New documentation site
-author: Trygve Lie
-authorURL: https://github.com/trygve-lie/
+authors: trygve
+tags: [hello, podium]
 ---
 
 Welcome to our blog. Our documentation site has just gotten an refreshing update

babel.config.js

@@ -1,14 +1,17 @@
 ---
+slug: version-4.0.0
 title: Version 4.0.0
-author: Trygve Lie
-authorURL: https://github.com/trygve-lie/
+authors: trygve
+tags: [podium, version, release]
 ---
 
 We are very happy to release version 4.0.0 of Podium. Both `@podium/layout` and
 `@podium/podlet` are now available at v4.0.0.
 
 Version 4.0.0 attempts to be almost entirely backwards compatible with version 3.0.0.
 
+<!--truncate-->
+
 This release contains the following changes:
 
 ### JSON Schema
@@ -25,7 +28,7 @@ A document template is intended to supply the necessary HTML for the page outsid
 While a v4 ships with a default document template it's straight forward to build your own custom template and plug this into both layouts and podlets
 which helps make it easier to develop podlets in isolation (from layouts) while imposing the same constraints on it that it will have when included in a layout.
 
-Please see the [document template](/docs/next/api/document) section for further
+Please see the [document template](/docs/api/document) section for further
 information.
 
 ### HTTP framework free
@@ -63,7 +66,7 @@ which are related specifically to the layout.
 During the process of rewriting to HTTP framework free, an `HttpIncoming` object was introduced which
 is passed between the various parts of Podium.
 
-You can read more about [`HttpIncoming` and its role here](/docs/next/api/incoming).
+You can read more about [`HttpIncoming` and its role here](/docs/api/incoming).
 
 Due to this, you should pass an instance of `HttpIncoming` (available at `res.locals.podium` in express) to the `.client.fetch()` and `.client.stream()` methods in
 a `@podium/layout` instead of the context.

website/blog/2019-05-20-new-documentation.md renamed to blog/2019-05-20-new-documentation.md

@@ -1,11 +1,14 @@
 ---
+slug: version-4.1.0
 title: Version 4.1.0
-author: Trygve Lie
-authorURL: https://github.com/trygve-lie/
+authors: trygve
+tags: [podium, version, release]
 ---
 
 Version 4.1.0 of `@podium/layout` and `@podium/podlet` are now available.
 
+<!--truncate-->
+
 ### Assets
 
 This release contain some minor changes to the `.js()` and `.css()` methods in

website/blog/2019-06-14-version-4.0.0.md renamed to blog/2019-06-14-version-4.0.0.md

@@ -1,11 +1,14 @@
 ---
+slug: version-4.2.0
 title: Version 4.2.0
-author: Trygve Lie
-authorURL: https://github.com/trygve-lie/
+authors: trygve
+tags: [podium, version, release]
 ---
 
 Version 4.2.0 of `@podium/layout` and `@podium/podlet` are now available.
 
+<!--truncate-->
+
 ### TypeDefinitions
 
 This release is shipped with TypeDefinitions for all public APIs.
@@ -33,7 +36,7 @@ podlet.js({
 })
 ```
 
-When rendered by the [`document template`](/docs/next/api/document.md) the above
+When rendered by the [`document template`](/docs/api/document) the above
 will translate into the following HTML element:
 
 ```html
@@ -43,14 +46,14 @@ will translate into the following HTML element:
 Please see the following documentation for the options the different methods
 can now take:
 
- * @podium/podlet [`.css()`](/docs/next/api/podlet#cssoptions-options) method
- * @podium/podlet [`.js()`](/docs/next/api/podlet#jsoptions-options) method
- * @podium/layout [`.css()`](/docs/next/api/layout#cssoptions-options) method
- * @podium/layout [`.js()`](/docs/next/api/layout#jsoptions-options) method
+ * @podium/podlet [`.css()`](/docs/api/podlet#cssoptions-options) method
+ * @podium/podlet [`.js()`](/docs/api/podlet#jsoptions-options) method
+ * @podium/layout [`.css()`](/docs/api/layout#cssoptions-options) method
+ * @podium/layout [`.js()`](/docs/api/layout#jsoptions-options) method
 
 For further information on how assets are handled in general, please see the
-[asset section](/docs/next/api/assets).
+[asset section](/docs/api/assets).
 
-If you maintain a custom [`document template`](/docs/next/api/document), please
-see [this section](/docs/next/api/document#assets) on how to render registered
+If you maintain a custom [`document template`](/docs/api/document), please
+see [this section](/docs/api/document#assets) on how to render registered
 assets into HTML elements appropriately.