| title | description | author | layout |
|---|---|---|---|
This site |
About the PanDA news website |
Torre Wenaus |
page |
This site is maintained by the PanDA team.
This website is implemented using github's Pages service which makes it easy to create a website associated with a github account or project. Pages uses Jekyll, a tool to automatically build a website from source files (which are kept in github). It supports structured sites like blogs in a simple but powerful way. We all like to work in code editors; this lets you write content in a friendly editor using the easy markdown syntax (which is used by github itself).
To create a post you add a file in the github repository of posting sources, so you need to be an PanDA repository user.
If you wish (and it is recommended) you can easily set up a local instance of the site in order to preview submissions. See the documentation on installing and running Jekyll. The newsletter uses user pages, ie use the master branch.
Here's a template. This snippet covers the entire content of what should be in the post file. Note that the first lines enclosed by three dashes must be the first lines in the file. The format is markdown, see references below.
The file must be added to the _posts directory following the name convention yyyy-mm-dd-title-goes-here.md.
---
title: PanDA news, May 1 2015 (required)
tags: t1 t2 t3 (optional)
author: you (required)
---
There's the latest on PanDA...
## Section
You can also have subsections
### Subsection
(you get the idea). You can include a link [here](http://path), use
* bulleted
* nested
* lists
and refer to `inline code` and
include
large
code
blocks.
See the markdown doc for more.
- Jekyll to build websites from plain text
- The liquid template engine used by Jekyll
- markdown syntax