Skip to content

Defer to README for website dev #78

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Feb 13, 2020
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
93 changes: 2 additions & 91 deletions docs/infrastructure/website.rst
Original file line number Diff line number Diff line change
@@ -1,95 +1,6 @@
The Website
===========

RITlug's website is powered by Github pages and stored in a repository in the RITlug Github organization.
It is powered by vanilla Jekyll (no plugins) as Github pages does not allow plugins for security reasons.
In order to update any aspect of the site, simply push or merge changes to the repository and the changes will take effect within a few minutes.
RITlug's website is powered by GitHub Pages and stored in a repository in the RITlug Github organization.

Announcements
-------------

This is a quick rundown of how to post an announcement on the RITlug website.
See also `Announcements <announcements.md>`__.

- Fork the repository to your own Github account (go to the RITlug repository and click "fork")
- Clone the repository locally (if desired - you can also create it online)
- Create a new file in announcements/\_posts named with the convention 2015-10-02-new-website.md
- Add front matter to the file

::

---
title: title of your announcement
author: your name
date: date, in the format 2015-10-03
tags: [a, list, of tags] (optional)
layout: post
---

- Add a blank line, then type your announcement
- Add the new file to git
- Git commit
- Git push to your repository
- Open a pull request against the master branch (which is default) of the RITlug copy of the repository
- When your pull is merged, the site will update within a few minutes

Talks
-----

This follows the same process as announcements, with a couple of small tweaks:

- The files will be put in talks/\_posts
- There is an extra line in the frontmatter called 'slides' which provides a link to where the slides for the talk can be viewed.
This should be a URL, usually along the lines of /talks/your-talk-name.pdf if hosted on the RITlug site
- The slides (if hosted on the RITlug site) should be put in the talks folder, prefaced with the year and semester. Something like 2015-fall-
- If hosted on the RITlug site, the slides should also be committed

Site Source
-----------

This is the structure of the source code for the site, e.g. where to find anything.
Most of the structure should be pretty self explanatory.

The site uses Google's `Material Design Light template <http://getmdl.io>`__, version 1.0.
The javascript is patched to allow for linking to other pages in the tab bar - a feature which should be built in in version 1.1.

The site follows a fairly typical Jekyll setup so you can refer to the Jekyll documentation.

Pointer: You can access announcements from within templates using {{ site.categories.announcements }} and talks using {{ site.categories.talks }}.

.. raw:: html

<pre>
├── about.md - the about page (at /about.html)
├── announcements
│   ├── index.html
│   └── _posts - all announcements posted on the site, in markdown format
├── _config.yml
├── connect.html
├── css
│   ├── material-brown-orange.css
│   └── styles.css
├── feeds
│   └── latest.xml - ATOM feed
├── img
│   └── ritlug.png
├── _includes - sections of the template. These are files included in templates in the _layouts directory.
├── index.html
├── js
│   └── material.js
├── _layouts - Available layouts. These are referred to in the pages themselves.
│   ├── default.html
│   ├── page.html
│   └── post.html
├── LICENSE
├── README.md
├── schedule.md
└── talks
├── index.html
└── _posts - Talks posted on the site, in markdown format
</pre>

Developing and Previewing
-------------------------

`Refer to the README in the site repository <http://github.com/ritlug/ritlug.github.io>`__
`Please refer to the README and CONTRIBUTING in the site repository <http://github.com/ritlug/ritlug.github.io>`__