ssoriche / mojolicious.io

A semi-official website dedicated to the Mojolicious web framework

Home Page:https://mojolicious.io

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

mojolicious.io - A semi-official website dedicated to the Mojolicious web framework

This site is powered by Statocles. To do anything fancy, please read more about it first.

To contribute to the site, clone the project and install the dependencies

$ git clone git@github.com:MojoliciousDotIO/mojolicious.io.git
$ cd mojolicious.io
$ cpanm --installdeps .

Note that you might need to update your cpanm installation. If the above fails, run cpanm --self-upgrade (or perlbrew install-cpanm depending on if you're using perlbrew, we do) and retry.

To serve the site locally, simply run statocles daemon [--date YYYY-MM-DD]. To see it as of a different date, try the --date flag (useful if you want to postdate a blog post for example). Note that it may take quite a while to startup, Statocles is powerful but it isn't very optimized yet.

To add a new post run statocles blog post [--date YYYY-MM-DD] 'Title of your post', where again the optional date lets you create a post for a future date.

Then when you're done, run the server again to see how it looks. Repeat until you're satisfied, when you are, open a PR.

Author Bios

If you are a new author, you should add biographical information into the the site.yml data under site.args.data.bios.<<unique key>>. This unique key is then referenced in your article's data.bio topmatter yaml field.

Data in that object should contain at least name and text values containing your name (or pseudonym) and a blurb about you, respectively. You are encouraged to also link an image. If you have a publicly accessible image, like gravatar, you may use a full url to it. Otherwise, add an image to this site's static directory and link to it. Finally, if you have a twitter account, you may point to it with a twitter key.

jberger:
    name: 'Joel Berger'
    twitter: '@joelaberger'
    image: 'https://secure.gravatar.com/avatar/cc767569f5863a7c261991ee5b23f147'
    text: |-
      Joel has Ph.D. in Physics from the University of Illinois at Chicago.
      He an avid Perl user and [author](https://metacpan.org/author/JBERGER) and is a member of the Mojolicious Core Team.

Other keys may be added but will need to be incorporated into the site renderer to take effect. Please open an issue to discuss.

Tips

  • Please add a "fold" to your article at an appropriate place by adding --- as a line where the fold should happen.
  • Please keep all of your files in the post's directory (the one with index.html), this will help keep things orderly.
  • Please use urls that are relative to the site root (not relative to the page) for content above the fold. This is because that content will be show on other pages like the blog scroll.
  • Until we add some smarts to the calendar plugin, if you want to postdate a calendar entry, comment it out in the calendar page metadata, otherwise it will show up too early (or let us add it).
  • Please don't commit the results of running the deploy command (in live/ or worse in .statocles/), let us do that for you on the production server when its time.

Acknowledgements and Legal

The style is Sparrow by Styleshout.

All content except where otherwise noted is copyright (c) 2017 Joel Berger.

Creative Commons License
This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

About

A semi-official website dedicated to the Mojolicious web framework

https://mojolicious.io


Languages

Language:HTML 81.1%Language:CSS 8.3%Language:JavaScript 6.7%Language:Perl 2.8%Language:Perl 6 1.0%