hullblogs.com/README.md

2.8 KiB

hullblogs.com

Aggregated posts from University of Hull students

This is an Eleventy powered website that aggregates RSS/Atom posts and presents them in reverse chronological order. It's purpose is to aggregate blog posts from current and past University of Hull students.

When it's live, you will be able to visit it here: https://hullblogs.com/.

To add your blog to the site, please follow the instructions below in the add your site section. You must be a current or past University of Hull student in order to get your blog added.

Note that because this uses a static site generator, the content won't update automatically. The site must be rebuilt in order for new posts to show up.

Add your site

To add your site, you need to update the feeds.json file in this repository, and add a ne entry like this:

{
	"author_name": "Your name here",
	"github_username": "your_github_username",
	"feed_uri": "https://example.com/feed/"
}

The 3 properties have the following meanings:

  • author_name: Your name. Shown beneath your posts.
  • github_username: Your GitHub username. Used for displaying your avatar.
  • feed_uri: The URL of your Atom or RSS feed.

Editing feeds.json is easy. You can even do it right in your web browser: https://github.com/FreesideHull/hullblogs.com/edit/main/feeds.json.

Run your own instance

For development (and production, if you're in charge of the hullblogs.com website) purposes, it's sometimes useful to run your own instance of this website. These instructions wil have you up and running in no time!

System (and user) Requirements

  • Node.js
  • A text editor (for editing feeds.json)
  • A web browser (we recommend Firefox)
  • Basic knowledge of the Linux Terminal (or Windows Command Line)

Getting Started

First, clone this repository and cd into it:

git clone https://github.com/FreesideHull/hullblogs.com.git
cd hullblogs.com

Then, install the dependencies:

npm install

Now, you can build and serve the site locally:

npm start

It will take a moment to build, but then you'll get a message like this that shows the URL you can visit your local instance of the size:

Contributing

Contributions are very welcome - both issues and pull requests! To add your blog to the site, please see the add your blog section above.

License

hullblogs.com is released under the Apache Licence 2.0. The full license text is included in the LICENSE file in this repository. Tldr legal have a great summary of the license if you're interested.