This is a general help for NightHawk pages.
Go to settings and configure pages, and configure Build and Deployment for "GitHub Actions". IF YOU DO NOT DO THIS YOUR PAGE WILL NOT BUILD.
In case of issues with the user for your repository not being able to be resolved resulting in the page not building do the following: instead of the usual repository: yourRepoName
in the repository section write repository: usr/yourRepoName
Game projects use the minima theme. To understand files and organization read Minima README.md
To name a file, use the following structure (Note that dates should never be in the future and should always be in the format YYYY-MM-DD):
Make sure that notebooks are in the notebook folder and posts are in the posts folder.
For markdown files in _posts:
year-month-day-fileName.md
For jupyter notebooks in _notebooks:
year-month-day-fileName.ipynb
categories: [
C1.4]` Each item in the same category will be lumped together to be seen easily on the tags page.search_exclude: true
to the front matter of the page. This will hide the page from appearing when the viewer uses search.image: /images/file.jpg
and then the name of the image that you want to use. The image must be in the images
folder. Furthermore, if you would like the file to not show up on the blog page hide: true
can be added to the front matter.@import "minima/NIGHTHAWK-Pages-styles";
. Note that you can also add your own SCSS in the file itself in the area labeled specifically for that purpose. Also, you can mix different styles by combining them together in NIGHTHAWK-Pages however the effects may vary.{%- include post_list.html -%}
Note that the liquid syntax is surrounded by curly braces and percent signs. This can be used anywhere in the repository.layout: [your layout here]
Using another pre-existing layout use the same front matter syntax as defined above. This layout will have to be written in in logic customizing liquid to define the structure of the page.This site is intended for Students. This is to record plans, complete hacks, and do work for your learnings.
All GitHub Pages
websites are managed on GitHub infrastructure. GitHub uses Jekyll
to transform your content into static websites and blogs. Each time we change files in GitHub it initiates a GitHub Action that rebuilds and publishes the site with Jekyll.
In all development, it is recommended to test your code before deployment. The GitHub Pages development process is optimized by testing your development on your local machine, before committing files to GitHub.
Development Cycle. For GitHub pages, the tooling described below will support a development cycle, such as make-code-save-preview
. In the development cycle, it is a requirement to preview work locally, before doing a VSCode commit
to git. Preview functionality requires Python and Python libraries.
Deployment Cycle. In the deployment cycle, sync-github-action-review
, it is a requirement to complete the development cycle before doing a VSCode sync
. The sync triggers a GitHub repository update. The action starts with the Jekyll build to publish the website. Any step can have errors and will require you to do a review of GitHub Actions.
The result of these steps is MacOS tools to run the preview server. These procedures were created using jekyllrb.com. Run scripts in the scripts directory of the student repo: activate_macos.sh. The expected name of the repository to run these scripts is 'student'.
The result of these steps is the server running on: http://0.0.0.0:4100/teacher/. Regeneration messages will run in the terminal on any save. Press the Enter or Return key in the terminal at any time to enter commands.
Complete installation
bundle install
Run Server. This requires running terminal commands make
, make stop
, make clean
, or make convert
to manage the running server. Logging of details will appear in the terminal. A Makefile
has been created in the project to support commands and start processes.
Server address: http://0.0.0.0:4100/teacher/
Regenerating: 1 file(s) changed at 2023-07-31 06:54:32
_notebooks/2024-01-04-cockpit-setup.ipynb
Terminal messages are generated from background processes. Click return or enter to obtain a prompt and use the terminal as needed for other tasks. Always return to the root of project cd ~/vscode/teacher
for all "make" actions.
Stop the preview server, but leave constructed files in the project for your review.
make stop
make clean
make convert
Metadata, also known as "front matter", is a set of key-value pairs that can provide additional information to GitHub Pages about .md and .ipynb files. This can and probably will be used in other file types (ie doc, pdf) if we add them to the system.
In the front matter, you can also define things like a title and description for the page. Additional front matter is defined to place content on the "Computer Science Lab Notebook" page. The courses:
key will place data on a specific page with the nested week:
placing data on a specific row on the page. The type:
key in "front matter" will place the blog under the plans, hacks(ToDo), and tangibles columns.
In our files, the front matter is defined at the top of the page or the first markdown cell.
First, open one of the .md or .ipynb files already included in either your _posts|_notebooks folder.
In the .md file, you should notice something similar to this at the top of the page. To see this in your .ipynb files you will need to double-click the markdown cell at the top of the file.
---
toc: true
comments: false
layout: post
title: Daily Plan Sample
description: Example Blog!!! This shows planning and notes from hacks.
type: plans
courses: { compsci: {week: 0} }
---
The front matter will always have '---' at the top and bottom to distinguish it and each key-value pair will be separated by a ':'.
Here we can modify things like the title and description.
The type value will tell us which column this is going to appear under, supported values: plans
, hacks
, tangibles
.
The courses will tell us which menu item it will be under, in this case, the compsci
menu, and the week
tells it what row (week) it will appear under that menu.
In our examples, hacks(ToDo) contain references to our IPYNB files; these are stored in GitHub under the _notebooks
folder. The plans and tangibles contain references to our MD files; these are stored in GitHub under the _posts
folder.
compsci.md
- this is the "Computer Science Lab Notebook" page and is the link https://nighthawkcoders.github.io/student/compsci
. It contains the Title and Number of units on the page._data/compsci.yml
- this contains the supporting data that helps organize the units on the page._layouts
\schedule.html - this contains code, in the Liquid language, that generates the HTML for all the rows and columns.csa: {week: 0}
under courses.