Merge pull request #13 from async-go/jason-githubactions

Make things more configurable

components/Header.js

@@ -1,14 +1,33 @@
 import { React } from "react";
 import getConfig from "next/config";
 
-export default function Header() {
+function trimUrl(url) {
+  // Utility function to remove (index).md from page URLs
+  url = url.replace(/\/index\.md$/, "");
+  url = url.replace(/\.md$/, "");
+  return url;
+}
+
+function MakeLinks() {
   const { publicRuntimeConfig } = getConfig();
-  const handbookName = publicRuntimeConfig.handbookName || "";
+  const headerLinks = publicRuntimeConfig.headerLinks;
+  return (
+    <>
+      {Object.keys(headerLinks).map((link) => (
+        <a key={link} href={trimUrl(headerLinks[link])}>
+          {link}
+        </a>
+      ))}
+    </>
+  );
+}
+
+export default function Header() {
   return (
     <>
       <header>
         <nav>
-          <a href="/">{handbookName + " Home"}</a>
+          <MakeLinks />
         </nav>
       </header>
     </>

next.config.mjs

@@ -5,6 +5,13 @@ import rehypeHeadings from "rehype-autolink-headings";
 import rehypeUrl from "rehype-url-inspector";
 import url from "url";
 
+function trimUrl(url) {
+  // Utility function to remove (index).md from page URLs
+  url = url.replace(/\/index\.md$/, "");
+  url = url.replace(/\.md$/, "");
+  return url;
+}
+
 const mdx = withMDX({
   extension: /\.(md)$/,
   options: {
@@ -43,11 +50,7 @@ const mdx = withMDX({
               }
               if (parsedUrl.pathname) {
                 // Trim (index).md extension from links
-                parsedUrl.pathname = parsedUrl.pathname.replace(
-                  /\/index\.md$/,
-                  ""
-                );
-                parsedUrl.pathname = parsedUrl.pathname.replace(/\.md$/, "");
+                parsedUrl.pathname = trimUrl(parsedUrl.pathname);
                 match.node.properties[match.propertyName] =
                   url.format(parsedUrl);
               }
@@ -65,9 +68,11 @@ export default mdx({
   publicRuntimeConfig: {
     // Be sure to customize these values for your site. Changing these values
     // requires restarting the dev server.
-    handbookName:
-      // The name of the handbook as shown in the header
-      "Handbook Demo",
+    headerLinks: {
+      // A list of links for the header of every page, relative to root.
+      "Handbook Home": "/",
+      Team: "/company/team/index.md",
+    },
     editRepositoryBase:
       // This is the base path for the "edit this page" link. The relative path
       // of the current page from the root is added. No trailing slash. If unset,

pages/index.md

@@ -1,9 +1,14 @@
 # Handbook home
 
-This is what your future company handbook would look like if you use this template; this is the starting point, and you can easily customize from here. If you'd like to read more about how it works, check out the [README](https://github.com/async-go/company-handbook-template/blob/main/README.md) in our [GitLab project](https://github.com/async-go/company-handbook-template). The handbook is designed to be simple to use, and changes integrate into whatever version control you're already using, giving you a nice discussion flow before merging.
+This is starting point of what your future company handbook would look like if you use this template. If you'd like to read more about how it works, check out the [README](https://github.com/async-go/company-handbook-template/blob/main/README.md) in our [GitHub project](https://github.com/async-go/company-handbook-template). The handbook is designed to be simple to use, and changes integrate into whatever version control you're already using, giving you a nice discussion flow before merging.
 
 We have a lot of ideas on how to improve this handbook template to make it easier to get started. You can check out our public [issues tracker](https://github.com/async-go/company-handbook-template/issues) and see what we have planned or submit your own ideas.
 
+## Company
+
+- [Strategy](./strategy/index.md)
+- [Team members](./company/team.md)
+
 ## Departments
 
 Each of our departments has their own sub-section of the handbook.
@@ -13,7 +18,6 @@ Each of our departments has their own sub-section of the handbook.
 - [Marketing](./marketing/index.md)
 - [Sales](./sales/index.md)
 
-## Quick links
+## Other links
 
 - [Editing this handbook](./editing/index.md)
-- [Team members](./company/team.md)

pages/strategy/index.md

@@ -0,0 +1,3 @@
+# Strategy
+
+Here is where you can document your company strategy.

styles/custom.css

@@ -27,13 +27,13 @@
 .anchor-link {
   padding-left: 1rem;
   font-size: 1rem;
-  color: var(--text-light);
+  color: var(--border);
 }
 
 .anchor-link:hover {
   padding-left: 1rem;
   font-size: 1rem;
-  color: var(--accent);
+  color: var(--text-light);
 }
 
 header {