Initial quarto project (#1)

* vscode: added quarto extension to recommended extentions
* quarto: initial web project
* wp: quarto added some settings from the manual
* We are going to deploy with GHA

.github/workflows/publish.yml

@@ -0,0 +1,25 @@
+on:
+    workflow_dispatch:
+    push:
+      branches: main
+
+name: Quarto Publish
+
+jobs:
+  build-deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Quarto
+        uses: quarto-dev/quarto-actions/setup@v2
+
+      - name: Render and Publish
+        uses: quarto-dev/quarto-actions/publish@v2
+        with:
+          target: gh-pages
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,2 @@
+/.quarto/
+/_site/

.vscode/extensions.json

@@ -0,0 +1,13 @@
+{
+	// See https://go.microsoft.com/fwlink/?LinkId=827846 to learn about workspace recommendations.
+	// Extension identifier format: ${publisher}.${name}. Example: vscode.csharp
+
+	// List of extensions which should be recommended for users of this workspace.
+	"recommendations": [
+		"quarto.quarto"
+	],
+	// List of extensions recommended by VS Code that should not be recommended for users of this workspace.
+	"unwantedRecommendations": [
+
+	]
+}

README.md

@@ -1,2 +1,3 @@
-# user-guide
+# extendR user guide
+
 User guide for the extendr software suite: Examples, design patterns and workflows

_quarto.yml

@@ -0,0 +1,32 @@
+project:
+  type: website
+
+execute:
+  freeze: auto
+
+website:
+  title: "extendr"
+  reader-mode: true
+  repo-url: https://github.com/extendr/user-guide
+  repo-actions: [edit, issue]
+  repo-branch: main
+  sidebar:
+    contents: auto
+    style: "docked"
+    search: true
+  navbar:
+    left:
+      - href: index.qmd
+        text: Home
+      - about.qmd
+
+format:
+  html:
+    theme:
+      light: flatly
+      dark: darkly
+    css: styles.css
+    toc: true
+
+
+

about.qmd

@@ -0,0 +1,5 @@
+---
+title: "About"
+---
+
+About this site

conversion.qmd

@@ -0,0 +1,4 @@
+---
+title: "Conversion to and from R data"
+---
+

index.qmd

@@ -0,0 +1,7 @@
+---
+title: "extendR: User guide"
+---
+
+# Introduction
+
+extendR is a suite of software packages concerned with bridging R and Rust, through automatically generated bindings. See <https://extendr.github.io/> for more information. This website is a _user_ guide to all things extendr, Rust, R and the confluence of all three.

styles.css

@@ -0,0 +1 @@
+/* css styles */