From a17283dffc1b5e8ea86a00c36ec6485815df09cf Mon Sep 17 00:00:00 2001
From: Jacob Hotz <77470805+Jacob1010-h@users.noreply.github.com>
Date: Sat, 9 Dec 2023 08:37:17 -0800
Subject: [PATCH] move and rewrite things

---
 .github/workflows/pages.yml       |  8 +++++++
 Gemfile => docs/Gemfile           |  0
 Gemfile.lock => docs/Gemfile.lock |  0
 _config.yml => docs/_config.yml   |  5 +++++
 docs/test.md                      | 35 +++++++++++++++++++++++++++++++
 5 files changed, 48 insertions(+)
 rename Gemfile => docs/Gemfile (100%)
 rename Gemfile.lock => docs/Gemfile.lock (100%)
 rename _config.yml => docs/_config.yml (90%)
 create mode 100644 docs/test.md

diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
index 6564156..a5138f6 100644
--- a/.github/workflows/pages.yml
+++ b/.github/workflows/pages.yml
@@ -9,6 +9,8 @@ name: Deploy Jekyll site to Pages
 on:
   push:
     branches: ["main"]
+    paths:
+      - "docs/**"
 
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
@@ -28,6 +30,9 @@ jobs:
   # Build job
   build:
     runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: docs
     steps:
       - name: Checkout
         uses: actions/checkout@v3
@@ -37,6 +42,7 @@ jobs:
           ruby-version: '3.1' # Not needed with a .ruby-version file
           bundler-cache: true # runs 'bundle install' and caches installed gems automatically
           cache-version: 0 # Increment this number if you need to re-download cached gems
+          working-directory: '${{ github.workspace }}/docs'
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v3
@@ -48,6 +54,8 @@ jobs:
       - name: Upload artifact
         # Automatically uploads an artifact from the './_site' directory by default
         uses: actions/upload-pages-artifact@v1
+        with:
+          path: "docs/_site/"
 
   # Deployment job
   deploy:
diff --git a/Gemfile b/docs/Gemfile
similarity index 100%
rename from Gemfile
rename to docs/Gemfile
diff --git a/Gemfile.lock b/docs/Gemfile.lock
similarity index 100%
rename from Gemfile.lock
rename to docs/Gemfile.lock
diff --git a/_config.yml b/docs/_config.yml
similarity index 90%
rename from _config.yml
rename to docs/_config.yml
index d3ff3ff..8bbdd32 100644
--- a/_config.yml
+++ b/docs/_config.yml
@@ -4,6 +4,11 @@ repo_name: Programming Website
 description: A website for the Programming Sub-team of the Patribots, FRC Team 4738 
 site_author: Jacob Hotz
 
+url: https://patribots4738.github.io/Programming-Website/
+
+aux_links:
+  Template Repository: https://github.com/Patribots4738/Programming-Website
+
 # Theme
 theme: just-the-docs
 logo: "/docs/assets/images/logo.jpg"
diff --git a/docs/test.md b/docs/test.md
new file mode 100644
index 0000000..a6cf549
--- /dev/null
+++ b/docs/test.md
@@ -0,0 +1,35 @@
+---
+title: Test
+layout: default
+---
+
+This is a *bare-minimum* template to create a Jekyll site that uses the [Just the Docs] theme. You can easily set the created site to be published on [GitHub Pages] – the [README] file explains how to do that, along with other details.
+
+If [Jekyll] is installed on your computer, you can also build and preview the created site *locally*. This lets you test changes before committing them, and avoids waiting for GitHub Pages.[^1] And you will be able to deploy your local build to a different platform than GitHub Pages.
+
+More specifically, the created site:
+
+- uses a gem-based approach, i.e. uses a `Gemfile` and loads the `just-the-docs` gem
+- uses the [GitHub Pages / Actions workflow] to build and publish the site on GitHub Pages
+
+Other than that, you're free to customize sites that you create with this template, however you like. You can easily change the versions of `just-the-docs` and Jekyll it uses, as well as adding further plugins.
+
+[Browse our documentation][Just the Docs] to learn more about how to use this theme.
+
+To get started with creating a site, simply:
+
+1. click "[use this template]" to create a GitHub repository
+2. go to Settings > Pages > Build and deployment > Source, and select GitHub Actions
+
+If you want to maintain your docs in the `docs` directory of an existing project repo, see [Hosting your docs from an existing project repo](https://github.com/just-the-docs/just-the-docs-template/blob/main/README.md#hosting-your-docs-from-an-existing-project-repo) in the template README.
+
+----
+
+[^1]: [It can take up to 10 minutes for changes to your site to publish after you push the changes to GitHub](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll#creating-your-site).
+
+[Just the Docs]: https://just-the-docs.github.io/just-the-docs/
+[GitHub Pages]: https://docs.github.com/en/pages
+[README]: https://github.com/just-the-docs/just-the-docs-template/blob/main/README.md
+[Jekyll]: https://jekyllrb.com
+[GitHub Pages / Actions workflow]: https://github.blog/changelog/2022-07-27-github-pages-custom-github-actions-workflows-beta/
+[use this template]: https://github.com/just-the-docs/just-the-docs-template/generate