https://github.com/davorg/planetdrwho

News and information about Doctor Who
https://github.com/davorg/planetdrwho

atom drwho feeds news perlanet rss

Last synced: 9 days ago
JSON representation

News and information about Doctor Who

• Host: GitHub
• URL: https://github.com/davorg/planetdrwho
• Owner: davorg
• Created: 2017-10-09T11:01:50.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2024-04-27T14:34:30.000Z (8 months ago)
• Last Synced: 2024-10-27T11:11:08.278Z (about 2 months ago)
• Topics: atom, drwho, feeds, news, perlanet, rss
• Language: Perl
• Homepage: https://drwho.theplanetarium.org/
• Size: 52.3 MB
• Stars: 2
• Watchers: 3
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Planet Dr Who

This repo contains the code and data that powers the site [Planet Doctor Who](https://drwho.theplanetarium.org).

The site aggregates news and information about the how *Doctor Who* from various corners of the internet.

The site is built using [Perlanet](https://github.com/davorg/perlanet) which is a tool for aggregating web

feeds (it's a version of the Python tool "Planet" written in Perl - hence the rather silly name).

The way it works is this:

* `perlanetrc` contains YAML with the data that drives the file. Most importantly, it has the

`feeds` list which defines the feeds that are aggregated into the web site (and a new Atom feed).

* `index.tt` is a template which is expanded (using the [Template Toolkit](https://tt2.org/) into

the web site's front (and only) page. The template is passed a number of variables which can be

used to display the new, aggregated feed. For example the `feed` variable is an an object (actually

an instance of [XML::Feed](https://metacpan.org/pod/XML::Feed) which contains the new feed.

* `index.html` and `atom.xml` are the generated files which make up the web site and the new Atom

feed. They are generated on a schedule using [GitHub Actions](https://github.com/features/actions).

* `.github/workflows/buildsite.yml` is the file that controls how the site is built.

* `cpanfile` defines the Perl libraries that are required to generate the web site.

* Everything else is a file that is used to display the new web site - fonts, images, CSS files, etc

The generated web site is hosted on [GitHub Pages](https://pages.github.com/).

**Important Note:** The files `index.html` and `atom.xml` are automatically generated. Please don't

sent pull requests that change them - as any changes will be overwritten the next time the site

is rebuilt.