Merge pull request #13 from hunterdyar/summer-redesign

Summer Redesign!

.github/workflows/pages.yml

@@ -30,7 +30,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     env:
-      HUGO_VERSION: 0.99.0
+      HUGO_VERSION: 0.129.0
     steps:
       - name: Install Hugo CLI
         run: |

config.toml

@@ -1,9 +1,21 @@
 baseURL = 'http://guidebook.hdyar.com/'
 languageCode = 'en-us'
 title = 'The Guidebook'
-theme = 'book'
+theme = 'guidebook'
 BookComments = false
 publishDir = 'docs'
+disableKinds = ['taxonomy', 'term']
+
+[outputFormats.Moved]
+MediaType = "application/json"
+BaseName = "moved"
+IsHTML = false
+IsPlainText = true
+notAlternative = true
+
+[outputs]
+home = ["HTML", "RSS", "JSON", "moved"]
+
 [markup]
   [markup.highlight]
     anchorLineNos = false
@@ -20,3 +32,4 @@ publishDir = 'docs'
 
 [markup.goldmark.renderer]
   unsafe= true
+

content/3D/_index.md

@@ -0,0 +1,5 @@
+---
+weight: 3
+title: 3D Graphics
+---
+Concepts, principles, and tools for working with 3D data and computers.

content/3D/blender-toolbox/_index.md

@@ -0,0 +1,4 @@
+---
+title: Blender Toolbox
+weight: 20
+---

content/docs/blender/toolbox/add-ons.md → content/3D/blender-toolbox/add-ons.md

@@ -1,6 +1,7 @@
 ---
 title: Useful Add-Ons
 weight: 10
+oldlink: https://guidebook.hdyar.com/docs/blender/toolbox/add-ons/
 ---
 # Useful Add-Ons.
 Blender ships with a lot of features that it keeps hidden, which can easily be activated by going into to File>Preferences>Add-Ons menu. Third party developers can create their own add-ons, and there is a marketplace of individuals writing such software.

content/docs/blender/toolbox/blender-tutorials.md → content/3D/blender-toolbox/blender-tutorials.md

@@ -1,8 +1,7 @@
 ---
 title: Blender Tutorials
-
+oldlink: https://guidebook.hdyar.com/docs/blender/toolbox/blender-tutorials/
 draft: False
-
 ---
 
 # Tutorials

content/docs/blender/toolbox/helpful-shortcuts.md → content/3D/blender-toolbox/helpful-shortcuts.md

@@ -1,6 +1,6 @@
 ---
-
 title: Helpful Blender Shortcuts
+oldlink: https://guidebook.hdyar.com/docs/blender/toolbox/helpful-shortcuts/
 ---
 
 # Helpful Blender Shortcuts

content/docs/blender/toolbox/preferences.md → content/3D/blender-toolbox/preferences.md

@@ -1,5 +1,6 @@
 ---
 title: Preferences Setup
+oldlink: https://guidebook.hdyar.com/docs/blender/toolbox/preferences/
 ---
 
 Here are the settings that I prefer to change for Blender. Open the preferences by going to **Edit > Preferences**.

content/docs/blender/toolbox/quick-tips.md → content/3D/blender-toolbox/quick-tips.md

@@ -1,5 +1,6 @@
 ---
-title: Quick Tips
+title: Blender Quick Tips
+oldlink: https://guidebook.hdyar.com/docs/blender/toolbox/quick-tips/
 ---
 
 # Quick Tips.

content/3D/concepts/3d-models.md

@@ -0,0 +1,6 @@
+---
+title: Elements of a 3D Model & How Mesh Data works
+oldlink: https://guidebook.hdyar.com/docs/blender/3d-models/
+---
+# Elements of a 3D Model & How Mesh Data works
+{{< youtube -HygudufNfU >}}

content/3D/concepts/_index.md

@@ -0,0 +1,4 @@
+---
+title: How 3D Works
+---
+How 3D data work in digital media systems.

content/3D/concepts/face-orientation.md

@@ -0,0 +1,5 @@
+---
+title: Face Orientation and Back-Face Culling
+---
+# Face Orientation and Back-Face Culling
+{{< youtube GcUrysHVgIc >}}

content/docs/digital-media-fundamentals/perspective-distortion-and-projections.md → content/3D/concepts/perspective-distortion-and-projections.md

@@ -1,6 +1,7 @@
 ---
 title: Perspective Distortion and Projections
 draft: false
+oldlink: https://guidebook.hdyar.com/docs/digital-media-fundamentals/perspective-distortion-and-projections/
 ---
 # Notes on Perspective Distortion and Projections
 

content/3D/concepts/what-is-a-3D-model.md

@@ -0,0 +1,7 @@
+---
+title: How 3D Models Work
+---
+# What is a 3D Model Anyway?
+What... is a 3D model? This has some overlap with the above video.
+{{< youtube I3ndKKrazoA >}}
+

content/3D/learning-blender/_index.md

@@ -0,0 +1,3 @@
+---
+title: Using Blender
+---

content/docs/blender/helpful-blender-tutorials.md → content/3D/learning-blender/helpful-blender-tutorials.md

@@ -18,7 +18,7 @@ title: Blender YouTube Creators
 
 - [Erindale](https://www.youtube.com/c/Erindale)
 	- Geometry Nodes
-	- Bob Ross of geometry nodes
+	- Bob Ross of Geometry Nodes
 	- Beginner Friendly —> Advanced
 
 

content/docs/blender/install-blender.md → content/3D/learning-blender/install-blender/index.md

@@ -1,13 +1,18 @@
 ---
 title: Installing Blender
 weight: 1
+oldlink: https://guidebook.hdyar.com/docs/blender/install-blender/
 ---
 
+[![Blender Logo](blender.png)](http://blender.org)
+
 # Installing Blender
 You can always download and install the latest stable release of Blender at [blender.org](https://www.blender.org/).
 
+This is the recommended way to install Blender.
+
 ## Blender Launcher
-Only if you want to use brand new or experimental features (at the time of writing, new Geometry Nodes), you may want to explore different development branches of Blender. Dealing with multiple versions of Blender on one machine can be annoying. The best way to do this is with a piece of open source software called [Blender Launcher](https://github.com/DotBow/Blender-Launcher).
+Only if you want to use brand new or experimental features (at the time of writing, new Geometry Nodes), you may want to explore different development branches of Blender. Dealing with multiple versions of Blender on one machine can be annoying. The best way to do this is with a piece of open source software called [Blender Launcher](https://github.com/Victor-IX/Blender-Launcher-V2).
 
 Blender Launcher will download and manage different blender versions, and let you easily change shortcuts/file associations for them.
 

content/docs/blender/learn-blender.md → content/3D/learning-blender/learn-blender.md

@@ -1,6 +1,7 @@
 ---
 title: Learn Blender
 weight: 2
+oldlink: https://guidebook.hdyar.com/docs/blender/learn-blender/
 ---
 <!-- <img src="/images/blender/learn/important-green.svg" style="width:1em;height:1em;display:inline-block;margin-right:0.5em" /> -->
 
@@ -11,10 +12,10 @@ Students in IMM103, the <img src="/images/blender/learn/important-green.svg" sty
 # Blender Learning Path
 This page is a learning path for learning Blender. Assuming you know nothing, you can follow through from top to bottom and learn enough Blender that you can continue teaching yourself. The goal is to learn enough to get past the initial difficulty curve, and get into the space where you can hack and learn easily through external resources.
 
-This webpage avoids any single 'full tutorial', and encourages you to jump between guides. If you want to ignore all of that, then the popular [Donut Tutorial](https://www.youtube.com/playlist?list=PLjEaoINr3zgFX8ZsChQVQsuDSjEqdWMAD) from Blender Guru is how many blender users first learned the software. This long tutorial provides a broad overview of almost everything you can do in Blender, and will leave you confident in the user interface. I would explore shorter resources and more experimentation-based approaches first, and consider going through it later to "round out" your knowledge of the interface.
+This webpage avoids any sifngle 'full tutorial', and encourages you to jump between guides. If you want to ignore all of that, then the popular [Donut Tutorial](https://www.youtube.com/playlist?list=PLjEaoINr3zgFX8ZsChQVQsuDSjEqdWMAD) from Blender Guru is how many blender users first learned the software. This long tutorial provides a broad overview of almost everything you can do in Blender, and will leave you confident in the user interface. I would explore shorter resources and more experimentation-based approaches first, and consider going through it later to "round out" your knowledge of the interface.
 
 ## <img src="/images/blender/learn/important-green.svg" style="width:1em;height:1em;display:inline-block" /> The First Steps
-First, of course, [Install Blender]({{< ref "docs/blender/install-blender.md">}}).
+First, of course, [Install Blender]({{< ref "3D/learning-blender/install-blender.md">}}).
 
 Next, keep your eye on the version of blender mentioned in tutorials/guides. Blender made a significant change to its user interface in version 2.8. Versions 2.7 and older are out of date, but versions 2.8 and newer should be fine.
 
@@ -30,7 +31,7 @@ Installing blender isn't really the first step. The first step is understanding
 
 
 - <img src="/images/blender/learn/important-green.svg" style="width:1em;height:1em;display:inline-block;margin-right:0.2em"/>[Blender Manual: Structure](https://docs.blender.org/manual/en/latest/modeling/meshes/structure.html)
-- <img src="/images/blender/learn/bookmark.svg" style="width:1em;height:1em;display:inline-block;margin-right:0.5em" />This [Guidebook page]({{< ref "3d-models.md" >}}) on what 3D models are.
+- <img src="/images/blender/learn/bookmark.svg" style="width:1em;height:1em;display:inline-block;margin-right:0.5em" />This [Guidebook page]({{< ref "/3D/concepts/3d-models.md" >}}) on what 3D models are.
 
 ### The Interface
 The next step is understanding the interface. This makes following tutorials and guides easier. We want to be comfortable in the software, and to not be forced to go exact-step by exact-step through a sequence of memorized processes.
@@ -48,7 +49,7 @@ When you're following along with a tutorial, you want to follow the higher-level
 
 #### The Viewport
 - <img src="/images/blender/learn/important-green.svg" style="width:1em;height:1em;display:inline-block;margin-right:0.2em"/> [Viewport Navigation Video](https://www.youtube.com/watch?v=ILqOWe3zAbk)
-- <img src="/images/blender/learn/important-green.svg" style="width:1em;height:1em;display:inline-block;margin-right:0.5em" />Learn about the difference between [Orthographic and Perspective]({{< ref "/docs/digital-media-fundamentals/perspective-distortion-and-projections.md">}}) projections.
+- <img src="/images/blender/learn/important-green.svg" style="width:1em;height:1em;display:inline-block;margin-right:0.5em" />Learn about the difference between [Orthographic and Perspective]({{< ref "/3D/concepts/perspective-distortion-and-projections.md">}}) projections.
 - [Blender Manual: Perspective/Orthographic](https://docs.blender.org/manual/en/latest/editors/3dview/navigate/projections.html)
 - [Blender Manual: Navigating Viewport](https://docs.blender.org/manual/en/latest/editors/3dview/navigate/navigation.html)
 - [Blender Manual: Fly/Walk Navigation](https://docs.blender.org/manual/en/latest/editors/3dview/navigate/walk_fly.html)

content/3D/textures/_index.md

@@ -0,0 +1,3 @@
+---
+title: Textures and Materials
+---

content/docs/blender/toolbox/bake-textures-in-blender-to-unity.md → content/3D/textures/bake-textures-in-blender-to-unity.md

@@ -1,8 +1,6 @@
 ---
-title: How to Bake Procedural Materials into PBR Maps
-
-draft: false
-
+title: How to Bake Procedural Materials (Blender to Unity)
+oldlink: https://guidebook.hdyar.com/docs/blender/toolbox/bake-textures-in-blender-to-unity/
 ---
 
 ## How to Bake Procedural Materials into PBR Maps

content/3D/textures/textures-into-unity.md

@@ -0,0 +1,8 @@
+---
+Title: Bringing Textures into Unity
+oldlink: https://guidebook.hdyar.com/docs/unity/unity-fundamentals/textures-into-unity/
+---
+
+# Bringing Textures into Unity
+
+{{< youtube 0ms_v9TVWgI>}}

content/Python/_index.md

@@ -0,0 +1,5 @@
+---
+title: "Python"
+weight: 5
+---
+Learning programming with one of the most popular and most accessible programming languages

content/Python/python-fundamentals/_index.md

@@ -0,0 +1,7 @@
+---
+weight: 1
+bookFlatSection: false
+bookCollapseSection: true
+title: "Python Fundamentals"
+---
+Python is a popular general purpose programming language with large community of creators and educators.

content/Python/python-fundamentals/introducting-functions.md

@@ -0,0 +1,9 @@
+---
+title: Introducing Functions
+draft: false
+weight: 1
+oldlink: https://guidebook.hdyar.com/docs/creative-coding-python/python-fundamentals/introducting-functions/
+---
+# Functions in Python
+
+{{< youtube s_z2N4Xi614 >}}

content/Python/python-fundamentals/loops.md

@@ -0,0 +1,20 @@
+---
+title: Loops
+draft: false
+weight: 4
+oldlink: https://guidebook.hdyar.com/docs/creative-coding-python/python-fundamentals/loops/
+---
+
+## Basic Loops in Processing
+{{< youtube MyKxPgr0Qb0 >}}
+
+## Loop Examples
+{{< pyscript >}}
+for i in range(10):
+    print(i)
+{{< /pyscript >}}
+
+{{< pyscript >}}
+for i in range(0,100,10):
+    print(i)
+{{< /pyscript >}}

content/Python/python-fundamentals/modules.md

@@ -0,0 +1,9 @@
+---
+title: Modules
+draft: false
+weight: 5
+oldlink: https://guidebook.hdyar.com/docs/creative-coding-python/python-fundamentals/modules/
+---
+
+## Introducing Modules in Python
+{{< youtube tr8JlkE2brk >}}

content/docs/creative-coding-python/python-fundamentals/tuples.md → content/Python/python-fundamentals/tuples.md

@@ -2,6 +2,7 @@
 title: Tuples
 draft: false
 weight: 5
+oldlink: https://guidebook.hdyar.com/docs/creative-coding-python/python-fundamentals/tuples/
 ---
 
 ## Introducing Tuples in Python

content/Python/python-fundamentals/using-files-in-idle.md

@@ -0,0 +1,7 @@
+---
+title: Files & The Python IDLE
+draft: false
+weight: 0
+oldlink: https://guidebook.hdyar.com/docs/creative-coding-python/python-fundamentals/using-files-in-idle/
+---
+{{< youtube t9MoE6Jzg7E >}}

content/_index.md

@@ -1,33 +1,4 @@
 ---
 title: The Guidebook
-type: docs
-bookToC: false
+layout: home
 ---
-
-# The Guidebook
-
-# About
-
-{{< columns >}}
-
-## Welcome
-
-This site is an open repository for guides, videos, and general technical references related to crafting immersive digital experiences. It covers Unity Development, C# Programming, and more. This site is focused on technical how-to. 
-<--->
-
-## Audience
-
-Much of the content for this site was written to be used supplementary to in-class material. There are often more complex ways to accomplish a task that has various benefits over a more accessible approach. I choose what I feel is appropriate for my beginner-to-intermediate audience. The tone and language of the website may reflect that much of it was written for an audience of specific students with a beginner skill level. I hope that it is still helpful to a general audience.
-
-{{< /columns >}}
-
----
-
-
-## Contributing To This Site
-
-- The content for this site is written in [Markdown](https://www.markdownguide.org/).
-- This site was generated from the markdown content using [Hugo](https://gohugo.io/).
-- The generation process uses the theme [Hugo Book](https://themes.gohugo.io/themes/hugo-book/) by Alex Shpak.
-- The site is hosted on [GitHub Pages](https://pages.github.com/).
-- The github repository is [here](https://github.com/hunterdyar/IMMGuidebook). You can fork this repository and make changes, then submit a pull request.

content/about.md

@@ -0,0 +1,27 @@
+---
+title: About
+---
+# About The Guidebook
+
+## Welcome
+
+This site is an open repository for guides, videos, and general technical references related to crafting immersive digital experiences. It covers Unity Development, C# Programming, and more. This site is focused on technical how-to.
+
+The Guidebook is written and managed by Professor [Hunter Dyar](https://hdyar.com) and student workers in the Immersive Media department.
+
+## Audience
+
+Much of the content for this site was written to be used supplementary to in-class material. There are often more complex ways to accomplish a task that has various benefits over a more accessible approach. I choose what I feel is appropriate for my beginner-to-intermediate audience. The tone and language of the website may reflect that much of it was written for an audience of specific students with a beginner skill level. I hope that it is still helpful to a general audience.
+
+---
+
+
+## Contributing To This Site
+
+The best way to give feedback or a suggestion is with an [issue](https://github.com/hunterdyar/IMMGuidebook/issues) on [GitHub](https://github.com/hunterdyar/IMMGuidebook/).
+
+- The content for this site is written in [Markdown](https://www.markdownguide.org/).
+- This site was generated from the markdown content using [Hugo](https://gohugo.io/).
+- Layout uses the [tachyons](https://tachyons.io) css framework.
+- The site is hosted on [GitHub Pages](https://pages.github.com/).
+- The GitHub repository is [here](https://github.com/hunterdyar/IMMGuidebook). You can fork this repository and make changes, then submit a pull request.

content/code-architecture/_index.md

@@ -0,0 +1,7 @@
+---
+weight: 4
+title: Building Code Systems
+---
+
+Working with Unity and C# to build more complex and more complete systems, and be able to iterate effectively.
+> "*There are two ways of constructing a software design: One way is to make it so simple that there are obviously no deficiencies, and the other way is to make it so complicated that there are no obvious deficiencies. The first method is far more difficult.*" - [C.A.R. Hoare](https://dl.acm.org/doi/10.1145/358549.358561).

content/docs/programming/fundamentals/_index.md → content/code-architecture/architecture/_index.md

@@ -1,7 +1,5 @@
 ---
+title: Architecture
 bookCollapseSection: true
-weight: 10
+weight: 70
 ---
-
-
-