Add new docs (#486)

* Add initial new docs

based on astro starlight

* Add consolidated changes

Add Dan's tweaks for the NIST pages

* Direct to NIST pages

Author: headmin

.github/workflows/build_documentation.yml

@@ -0,0 +1,53 @@
+name: Build documentation site to nist-pages
+
+on:
+  push:
+    branches: ["main"]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+env:
+  BUILD_PATH: "."
+  SITE_PATH: "https://pages.nist.gov/"
+  BASE_PATH: "/macos_security"
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup PNPM
+        uses: pnpm/action-setup@v2
+        with:
+          version: 8
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: pnpm
+          cache-dependency-path: ${{ env.BUILD_PATH }}/docs/pnpm-lock.yaml
+      - name: Install dependencies
+        run: pnpm install
+        working-directory: ${{ env.BUILD_PATH }}/docs
+      - name: Build with Astro
+        run: |
+          pnpm astro build \
+            --site "${{ env.SITE_PATH }}" \
+            --base "${{ env.BASE_PATH }}"
+        working-directory: ${{ env.BUILD_PATH }}/docs
+      - name: Upload to nist-pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ${{ env.BUILD_PATH }}/docs/dist
+          publish_branch: nist-pages

docs/astro.config.mjs

@@ -0,0 +1,88 @@
+
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+export default defineConfig({
+	integrations: [
+		starlight({
+			title: 'macOS Security Compliance Project',
+			favicon: '/favicon.png',
+			logo: {
+				src: './src/assets/logo.png',
+			},
+			customCss: [
+				// Path to your custom CSS file
+				'./src/styles/custom.css',
+			],
+head: [
+			  {
+			    tag: 'link',
+    			    attrs: {
+				rel: 'stylesheet',
+			        href: './nist-combined.css',
+				},
+			},
+			{
+                            tag: 'script',
+                            attrs: {
+                                src: './nist-header-footer.js',
+                                type: 'text/javascript',
+                                defer: 'defer',
+				 },
+                        },
+			],
+			social: {
+				slack: 'https://macadmins.slack.com/archives/C0158JKQTC5',
+				github: 'https://github.com/usnistgov/macos_security',
+			},
+			sidebar: [
+				{
+					label: 'Introduction',
+					items: [
+						{ label: 'Home', link: '/' },
+						{ label: 'Introduction', link: '/guides/introduction/' },
+						{ label: 'Getting Started', link: '/guides/getting-started/' },
+					],
+				},
+				{
+					label: 'How To',
+					collapsed: false,
+					items: [
+						{ label: 'Generate a Baseline', link: '/guides/how-to/generate-baseline/' },
+						{ label: 'Tailoring', link: '/guides/how-to/tailoring/' },
+						{ label: 'Generate Guidance', link: '/guides/how-to/generate-guidance/' },
+						{ label: 'Generate Configuration Profiles', link: '/guides/how-to/generate-profiles/' },
+						{ label: 'Generate DDM Components', link: '/guides/how-to/generate-declarative/' },
+						{ label: 'Compliance Script', link: '/guides/how-to/compliance-script/' },
+						{ label: 'Exemptions', link: '/guides/how-to/exemptions/' },
+						{ label: 'Customization', link: '/guides/how-to/customization/' },
+						{ label: 'Generate Mapping', link: '/guides/how-to/generate-mapping/' },
+						{ label: 'Generate SCAP', link: '/guides/how-to/generate-scap/' },
+					],
+				},
+				{
+					label: 'Repository',
+					collapsed: true,
+					items: [
+						{ label: 'Layout', link: '/reference/layout/' },
+						{ label: 'Baselines', link: '/reference/baselines/' },
+						{ label: 'Includes', link: '/reference/includes/' },
+						{ label: 'Rules', link: '/reference/rules/' },
+						{ label: 'Sections', link: '/reference/sections/' },
+						{ label: 'Scripts', link: '/reference/scripts/' },
+					],
+				},
+				{
+					label: 'More Information',
+					collapsed: true,
+					items: [
+						{ label: 'mSCP Resources', link: '/reference/more/resources/' },
+						{ label: 'Contributing', link: '/reference/more/contributing/' },
+						{ label: 'Vendor Attribution', link: '/reference/more/vendor-attribution/' },
+						{ label: 'FAQ', link: '/reference/more/faq/' },
+					],
+				},
+			],
+		}),
+	],
+});

docs/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "docs",
+  "type": "module",
+  "version": "0.0.1",
+  "scripts": {
+    "dev": "astro dev",
+    "start": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "astro": "astro"
+  },
+  "dependencies": {
+    "@astrojs/starlight": "^0.32.4",
+    "astro": "^5.5.3",
+    "sharp": "^0.33.5"
+  }
+}