[python-uk] Static site generators with Python

Andy Robinson andy at reportlab.com
Sat Sep 3 13:19:26 EDT 2016

Steve, thanks for this.

For the use case I have in mind - running club web site, all info public
- typically 3-5 people in a club would use the GitHub raw web UI to create
a new markdown file, hit commit and it's live. No branches or pull requests
ever.  A handful of others would have set up the CSS and templating. And
they can change a sentence from anywhere.  We have already tested with
enough naive users and it works fine.

This completely fixes the old "single point of failure" with one webmaster
who went on holiday, yet with far less to go wrong - no MySQL database etc,
redundant infrastructure, great performance.

We will be doing a lot of fun stuff providing separate "dynamic" features
with front end widgets that can fetch a JSON file and format it.

So the only issue is picking a nice static site generator and hooking it
all up. Obviously I prefer Python and now I know we don't need to maintain
any infrastructure. So, thanks again?

Sorry to top post but anything else on my iPhone is a nightmarish ordeal.


On Saturday, 3 September 2016, Stestagg <stestagg at gmail.com> wrote:

> On Fri, Sep 2, 2016 at 7:57 PM Andy Robinson <andy at reportlab.com
> <javascript:_e(%7B%7D,'cvml','andy at reportlab.com');>> wrote:
>> Re-subjecting...
>> On 2 September 2016 at 19:30, Stestagg <stestagg at gmail.com
>> <javascript:_e(%7B%7D,'cvml','stestagg at gmail.com');>> wrote:
>> > Hi Andy
>> >
>> > We use travis to build the site. You can see the travis yaml file and
>> build
>> > scripts in our repo:
>> ...
>> > If you can make your repo public, I would recommend travis as a great
>> way to
>> > build your site.
>> We can
>> > If you've any questions, please ask on or off list.
>> Thanks for this. I have never touched Travis, but it's time I learned.
>> If I understand correctly, it's a hosted service which can do pretty
>> much anything you want when it sees a commit; in this case
>> - pull from jobs repo
>> - generate output files
>> - push back the finished HTML up to the GitHub repo
>> ?
>> Cool!
>> (Yes, I've been under a rock for about 10 years)
>> I am embarking on a rather ambitious project to modernise an entire
>> sport.  Thousands of clubs have the problem of somewhere between zero
>> and one webmasters at any one time, and the dynamic  things they need
>> to do - fixture lists, race results - can just about all he handled by
>> Javascript these days.  With some nice reusable widgets and standards,
>> no need for database server.  And GitHub solves the problem of letting
>> multiple people access the repo and write/edit stories with no coding
>> skill.
>> Speaking of which, is or was anyone on this site involved with
>> athletics or running?
>> - Andy
> Yes, that's right, travis (and circleci, and the others..) basically just
> spin up a container, check out the repo, and run the commands listed in the
> travis.yml (or equivalent) in a full environment.
> This allows us to pull, and even push, using secret tokens, to other git
> repos (although that's not a very common use-case), install software, run
> tests, and build the site.
> One thing I would caution about is that github is not a CMS, and while
> it's awesome and does DCVS really well, there is definitely a minimum level
> of experience required to use it to submit a good pull request.  Simple
> things like naming files correctly, editing online, cloning repos etc, are
> not intuitive to people not used to these sort of workflows.
> If your users are willing to learn/already know enough to understand
> what's happening, then it's fine, but I would expect a certain amount of
> frustration from the less technically oriented editors.  (Something of a
> feature for pythonjobs, but I don't know if that's the case for athletics)
> Finally, if you're thinking of doing this at scale, I'd recommend reaching
> out to the github support team fairly early on. We did for pythonjobs, just
> to check that what we were doing was a good idea, and they were very keen
> on the idea, but opening a channel early on may help with any issues down
> the line
> Steve
>> _______________________________________________
>> python-uk mailing list
>> python-uk at python.org
>> <javascript:_e(%7B%7D,'cvml','python-uk at python.org');>
>> https://mail.python.org/mailman/listinfo/python-uk

Sent from Gmail Mobile
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-uk/attachments/20160903/77c69c82/attachment.html>

More information about the python-uk mailing list