Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
The source files for building the next www.irchelp.org
HTML CSS JavaScript ApacheConf Other

Merge pull request #19 from wilhelmy/master

update IRCnet info/URLs and slightly reorder the site in order of importance
latest commit c4babe6667
@sdaugherty sdaugherty authored
Failed to load latest commit information.
documents IRCnet: reorder, add some website URLs
otherfiles - Moving images to image directories, and removing old backup files.
.gitignore
.travis.yml Set up travis to automatically push changes to staging site
COPYING
README.md
bake_site.sh Oops. I Want the tarball to include the html not the markdown
deploy_staging.sh Change staging deploy script slightly to add .nojekyll file so github…
serve_devsite.sh Warning for development webserver

README.md

Welcome WIO Editors!

This is the new and improved www.irchelp.org.

PLEASE be aware that this is not a normal open source project, but rather the files that comprise a website being ran as a public service. No right to redistribute these files is granted, but you may use them for the purpose of making improvements and submitting them back to us. See COPYING for more information.

Otherwise, please do not create mirrors of the site, thanks.

Build Status

Directory Structure

  • documents/ - contains the files that will be processed as input by PieCrust
  • otherfiles/ - contains other files, which may be used by scripts later (not used yet)

Most of the documents can be found here.

Build Process

The build process should eventually go something like this.

  1. a _target folder is created.
  2. the documents folder is processed with PieCrust and the output placed in the root of _target
  3. the otherfiles folder is copied to the root of _target, skipping any files that already exist from the build process
  4. Sanity checks are optionally performed (has the size dropped more than it should, etc)
  5. Entire contents of target are rsynced to a staging folder on the server.
  6. The live folder is renamed to old, and the staging folder is renamed so that it becomes the live folder.

Getting PieCrust

Note: This is only necessary to run the development server, or to compile the site. There is no need to download PieCrust just to make changes to content.

Run this command from the root of your wio git repository.

hg clone https://bitbucket.org/ludovicchabant/piecrust _piecrust

Running the Development Server

After downloading PieCrust as described above, run the serve_devsite.sh script from the root of your wio git repository:

./serve_devsite.sh

This will run a testing server that you can connect to via http://localhost:8080, which will update automatically as files are changed in the documents folder. The testing server remains attached to the terminal and can be ended with ctrl+c when done testing.

This differs slightly from the production setup, in that the production setup requires the site to be built (see below) before it's uploaded to the server.

Building the Site

./bake_site.sh

Publishing the Site to Staging (irchelpers only)

  1. Build the site.
  2. In another directory, git clone git@github.com:irchelp/irchelp.github.io if you haven't already.
  3. cd irchelp.github.io
  4. git pull (make sure you start from latest version)
  5. tar -xvzf ../wio/wio.tar.gz (untar the wio.tar.gz you made when you built the site into the staging directory)
  6. git add -A (stage all the changed files)
  7. git commit -m "updated the staging site with my new cool changes"
  8. git push

Your changes wiil be live at http://irchelp.github.io within 10 minutes.

Publishing the Site to Production (Live Site)

  1. Make sure you have the version you want to publish as your working copy, and all changes are committed.
  2. Tag the version. git tag YYYYMMDD-NN where YYYYMMDD is the current date and -NN is a version number in case there are multiple changes in a day (check the existing tags to make sure you aren't reusing them)
  3. Push your tags. git push --tags
  4. Site will be built by travsisci, and if there are no problems, a release with that tag will be found at https://github.com/irchelp/wio/releases/ in a few minutes.

(rest of process TBD.... )

Something went wrong with that request. Please try again.