fcmam5 / pybee.github.io Goto Github PK

pybee.github.io

This is the homepage for the BeeWare project.

It is a Lektor-based site.

If you want to contribute a modification, you can fork this repository and submit a pull request. However, do not fork the master branch - fork the lektor branch and make changes there instead.

If you want to test out a change before you submit it, download and install Lektor (note: currently it's better to use Lektor with Python 2.7):

$ pip install lektor

Then from the root directory of the checkout, run:

$ lektor server

This will start a webserver that will autoreload whenever you make a change to site content.

Community

You can talk to the community through:

• @pybeeware on Twitter
• BeeWare Gitter channel: pybee/general
• Tickets on the pybee.github.io issue tracker

Contributing

If you find problems with this website, log them on GitHub. If you want to contribute, please fork the code and submit a pull request.

Before submitting a pull request, please make sure your forked branch is up to date with the original branch. To do this:

• set your upstream remote:

  $ git remote add upstream https://github.com/pybee/pybee.github.io.git
  

• make sure you have the latest changes from upstream:

  $ git fetch upstream
  

• rebase your lektor branch to upstream before pushing to git and submitting a pull request:

  $ git rebase upstream/lektor
  

Translating

Want to make BeeWare more accessible to non-English-speakers? Help translate the site! Steps are as follows:

1. Add language specification to:

   pybee.github.io/BeeWare.lektorproject

   Fill out the name of the language, its url prefix, and the locale.

2. Add translated mirror files at the same directory level as the primary English files and add appropriate suffixes.

   For example:

   Arabic's locale is 'ar', so you would add...

   contents+ar.lr

   ...where the original file name is:

   contents.lr

Note: A great place to start translating is the contributing section:

pybee.github.io/content/contributing