Site for reviewing skateparks and generel skatepark talk
- Three Main Features, Login, Review Maker, and Chatboard
- Four API's created for this website
- View our site and create a account
- Make a post about your favorite skatepark
- Talk in the chatroom
- If our backend is down, clone our backend to test features on your own laptop
- Might have to change links in javascript
- Backend Site
- Finn Carpenter
- Justin Nguyen
- Matiula Danish
- James Lee
This site is intended for Students. This is to record plans, complete hacks, and do work for your learnings.
- This can be customized to support computer science as you work through pathway (JavaScript, Python/Flask, Java/Spring)
- All tangible artifact work is in a _posts or in a _notebooks.
- Front matter (aka meta data) in ipynb and md files is used to organize information according to week and column in running web site.
All GitHub Pages
websites are managed on GitHub infrastructure. GitHub uses Jekyll
to tranform 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.
- GitHub Pages is powered by: Jekyll.
- Publised teacher website: nighthawkcoders.github.io/teacher
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, prior to files on GitHub
Development Cycle. For GitHub pages, the tooling described below will create a development cycle make-code-save-preview
. In the development cycle, it is a requirement to preview work locally, prior to doing a VSCode commit
to git.
Deployment Cycle. In the deplopyment cycle, sync-github-action-review
, it is a requirement to complete the development cycle prior to doing a VSCode sync
. The sync triggers github repository update. The action starts the jekyll build to publish the website. Any step can have errors and will require you to do a review.
- The result of these step is Ubuntu tools to run preview server. These procedures were created using jekyllrb.com
- Run scripts in scripts directory of student repo: setup_ubuntu.sh and activate.sh. Expected name of the repository to run these scripts is 'student'.
- Ihe result of these step are MacOS tools to run preview server. These procedures were created using jekyllrb.com. Run scripts in scripts directory of student repo: setup_macos.sh and activate_macos.sh. Expected name of the repository to run these scripts is 'student'.
-
The result of these step is server running on: http://0.0.0.0:4100/teacher/. Regeneration messages will run in 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
, ormake convert
to manage the running server. Logging of details will appear in terminal. AMakefile
has been created in project to support commands and start processes.- Start preview server in terminal
cd ~/vscode/teacher # my project location, adapt as necessary make
- Terminal output of shows server address. Cmd or Ctl click http location to open preview server in browser. Example Server address message...
Server address: http://0.0.0.0:4100/teacher/
- Save on ipynb or md activiates "regeneration". Refresh browser to see updates. Example terminal message...
Regenerating: 1 file(s) changed at 2023-07-31 06:54:32 _notebooks/2024-01-04-cockpit-setup.ipynb
-
Terminal message are generated from background processes. Click return or enter to obtain prompt and use terminal as needed for other tasks. Alway return to root of project
cd ~/vscode/teacher
for all "make" actions. -
Stop preview server, but leave constructed files in project for your review.
make stop
- Stop server and "clean" constructed files, best choice when renaming files to eliminate potential duplicates in constructed files.
make clean
- Test notebook conversions, best choice to see if IPYNB conversion is acting up.
make convert