xmppjs/xmpp.org

Name: xmpp.org

Owner: xmpp.js

Description: xmpp.org website (builds: https://travis-ci.org/xsf/xmpp.org/builds)

Created: 2017-09-04 09:25:24.0

Updated: 2017-09-04 09:25:27.0

Pushed: 2017-09-04 09:36:18.0

Homepage: http://xmpp.org

Size: 34863

Language: CSS

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

xmpp.org

Please log any issues.

Any editorial questions: Laura Gill or Simon Tennant can help

Contributing new content and updates

• Fork the code to your own git repository.
• Make your changes in /content/pages or directly in GitHub.
• When you are happy with your updates, submit a pull request describing the changes.
• IMPORTANT :- Before sending a Pull Request make sure that your forked repo is in sync with the base repo.
• The updates will be reviewed and merged in.

Communication forum

Please use xsf@muc.xmpp.org for discussions about the site, content, generation etc.

Site generation

• Commits to the master branch generate a new build.
• Builds are visible at https://travis-ci.org/xsf/xmpp.org/builds
• Changes will be visible on http://xmpp.org after the next update

Software Requirements

• Pelican 3.3
• ghp-import
• Markdown 2.3.1

Gentle introduction to Pelican

Pelican's QUICKSTART page is a good place to learn about the basics of Pelican (installation, project skeleton, development cycle, etc.).

Installation instructions

Two types of installations are documented: a regular one, and one that creates a virtual environment via Vagrant.

Regular installation

To run a development server on your local computer, follow these basic steps:

clone ssh://git@github.com/xsf/xmpp.org.git
stall Pelican and dependencies
mpp.org

Running the server in development mode:

 serve

If you want the server to autoreload whenever a file change, you can instead do:

 devserver

View at http://localhost:8000

Docker-based installation

The Makefile will build the website completely just by make. It'll do the following:

• Create a build Docker image (make builder) which is a development environment with a complete set of dependencies ready.

• Run this docker image on the xmpp.org directory locally. This directory is presumed to contain a checked out repository for the website. (make site)

• From the newly created static files in deploy/output, it will then create a minimalist docker image to actually serve the website. (make deployer)

For development convenience, you can run the website on port 8080 by make serve

Vagrant-based installation

For your convenience, this repository ships with a basic Vagrantfile, which allows you to create virtual machine with all the dependencies required for local development.

Assuming your computer has Vagrant installed, the following will get you a running server:

clone ssh://git@github.com/xsf/xmpp.org.git
mpp.org
ant up
ant ssh
vagrant/
 devserver

Now, the wesite should be available at http://localhost:8000

Configuration

o>
bfile.py
velop_server.sh
kefile
ADME.md
licanconf.py (development configuration)
blishconf.py (production configuration)
tput
<generated files - published to gh-pages branch>
ntent
pages
  <website page files>
lican-bootstrap3
<website theme>

Site generation

To just generate a new version (without starting up a local webserver) just do:

make html

Theme development

You can modify the theme (layout and styling) in the xmpp.org-theme directory.

Make changes to Sass files, not compiled CSS.

npm i then run grunt to compile Sass.