#The Taliaferro Times Website
Backup Site: https://taliaferro.tk
This is the site repository for The Taliaferro Times, the official newspaper and creative writing club of Booker T. Washington High School. All of the source code for the site is within this repository and its submodules.
We use Hugo, a static site generator, to generate a complete static site from HTML/Go template files and content files written in Markdown.
See COPYING for information on how you can use our content and code. See MANUAL.md for an introduction to the format and code of the site.
- Posts are made by contributors on their own respective platforms.
- Posts are edited by newspaper staff and submitted to the technical officer.
- Website design and site indexing are done locally on development computer using Hugo.
- Git added, committed, tagged, and pushed to GitLab & SourceHut. GitLab push causes Netlify build to taliaferro.tk.
- Once changes are confirmed, dev runs deployment script which causes newspaper server to pull from repository and deploy the new site.
- Made public.
See MANUAL.md for an overview of how the website works. See each file in the repository for in-line documentation on the purpose of the file and each item within.
What else does hosting on GitLab/SourceHut mean?
If the newspaper were to lose funding or access to a dedicated provider, it would be a simple matter of setting up GitLab Pages on the repository. Also, the entire site and its generation technique can be easily ported from system to system, site to site, provider to provider.
We use something similar to the Semantic Versioning System:
- MAJOR: Major release (new features which significantly change the site). Examples: radical new design, totally new search function, lots of minor changes together.
- MINOR: Small releases which add minor features or content. Examples: new post on site, little design changes, big edits to a page like About, changes which most users won't see or notice.
- PATCH: Minor changes which fix a problem. Examples: fix a problem with a recent change or design, typos, link issues, etc.
#Contributing & Bug Reporting
File issues at https://todo.sr.ht/~exprez135/Taliaferro.
#Dependencies, Resources, and More
#Behind the Scenes
- Hugo: generate site
- Git: version control
- Modified version of "HugoLunr" by Hugo Di Francesco. Uses:
- Node.js: to generate our search index. Uses the following packages (see package.json):
- Lunr.js: search
- parser-front-matter: parse our YAML front matter in posts
- readdirp: like readdir, but reads directories recursively
- Other Dependencies: see node_modules directory.
#With the Reader