This website is managed by the PyLadies Tech and Infra team. If you would like to join as an official member, read more here! You can also join us in Slack,
This website welcomes pull requests from anyone in the community.
This is the source code for the http://pyladies.com/ website. It uses
mynt, a static site generaton, and is powered by
- Understanding the repo's directory layout
- Setting up a development system
- To add a new PyLadies location
- To write a blog post
- To contribute source code to the repository
- To write a resource
- For Organizers
Understanding the repo's directory layout
Before adding a new location or contributing to the pyladies website, it's helpful to understand a bit about the repo and its contents.
This is a general overview of the repo's root directory structure.
.circleci directory contain code for
installing dependencies, configuring the CircleCI service, and instructions for
testing and deployment. The repo's root directory also contains
www folder. Most of the time, contributors will edit or add files in
Setting Up a Development System
If you wish to add a location, new chapter, or make code changes, please review the next few sections. There are a few tasks to set up a development system:
- Set up Python and a project directory
- Create and activate a virtual environment
- Fork and clone your pyladies repo
- Run the site locally
Set up Python and a project directory
Check that Python 3.6 is installed with
python --version. If it is not installed, it can be downloaded at https://python.org:
$ python --version Python 3.6.10
(Optional) Learn the directory which this Python version is installed
$ which python /usr/local/bin/python
You may see a different directory name which is fine.
Create a directory for development
$ mkdir pyladies-dev
Change into the directory
$ cd pyladies-dev # To check your current directory (`<YOUR_PATH>` will be different on # your system.) $ pwd YOUR_PATH/pyladies-dev
The process will be similar though the commands will vary slightly. Reference: Table of basic Powershell commands.
Create and activate a virtual environment
pyladies-devdirectory, install the
$ pip install virtualenv
Create a virtual environment named
$ virtualenv pyladyenv
Activate the virtual environment:
$ source pyladyenv/bin/activate (pyladyenv) $
After activation, you should see
(pyladyenv)above your command prompt.
Troubleshooting note (
AttributeError: 'module' object has no attribute 'X509_up_ref'): The error comes from PyOpenSSL. Either your OpenSSL is too old or too new. Try upgrading or downgrading OpenSSL and PyOpenSSL.
Fork and clone your pyladies repo
- On GitHub, fork http://github.com/pyladies/pyladies to your own GitHub account
<YOUR_GITHUB_USER_NAME>by pressing the green Fork button on the upper right of the screen.
- From the
pyladies-devdirectory, clone your fork to your machine using
(pyladyenv) $ git clone https://github.com/<YOUR_GITHUB_USER_NAME>/pyladies.git Cloning into 'pyladies'... remote: Enumerating objects: 47, done. remote: Counting objects: 100% (47/47), done. remote: Compressing objects: 100% (29/29), done. remote: Total 5877 (delta 22), reused 38 (delta 16), pack-reused 5830 Receiving objects: 100% (5877/5877), 39.73 MiB | 3.62 MiB/s, done. Resolving deltas: 100% (2922/2922), done.
You have successfully cloned your pyladies fork.
Run the site locally
Troubleshooting note for some operating systems: Make sure you have headers for Python and libevent
installed (e.g., on Ubuntu, python-dev and libevent-dev). Packages in
requirements.txt are required for the website to build successfully with mynt.
Change to the root of the pyladies repo (your virual environment should still be activated):
(pyladyenv) $ cd pyladies
Install dependencies using
(pyladyenv) $ pip install -r requirements.txt # You will see files being installed and this message at completion # It's okay if the versions differ slightly Successfully built hoep MarkupSafe mynt pathtools pycparser PyYAML watchdog Installing collected packages: argh, asn1crypto, six, pycparser, cffi, bcrypt, idna, enum34, ipaddress, cryptography, docutils, pyasn1, PyNaCl, paramiko, Fabric, hoep, MarkupSafe, Jinja2, Pygments, PyYAML, pathtools, watchdog, mynt Successfully installed Fabric-1.13.1 Jinja2-2.9.6 MarkupSafe-1.0 PyNaCl-1.1.2 PyYAML-3.12 Pygments-2.2.0 argh-0.26.2 asn1crypto-0.22.0 bcrypt-3.1.3 cffi-1.10.0 cryptography-2.0.3 docutils-0.14 enum34-1.1.6 hoep-1.0.2 idna-2.6 ipaddress-1.0.18 mynt-0.3.1 paramiko-2.2.1 pathtools-0.1.2 pyasn1-0.3.2 pycparser-2.18 six-1.10.0 watchdog-0.8.3
Navigate into the
(pyladyenv) $ cd www
Use mynt to generate and serve the website locally with
mynt gen -f _site && mynt serve _site:
(pyladyenv) $ mynt gen -f _site && mynt serve _site >> Parsing >> Rendering >> Generating Completed in 1.114s >> Serving at 127.0.0.1:8080 Press ctrl+c to stop.
Copy the IP address provided once mynt has completed building the site. It will say something like
>> Serving at 127.0.0.1:8080. Then paste the IP address into the URL bar of a browser window and load it to view the site.
Congrats on running the site on your machine
- (Optional: After making changes to the source code) To view any changes you make to the site code, type ctrl+c in the terminal to stop the local webserver. Then run the command from Step 5 again and refresh the browser window.
- How to fork and clone: https://help.github.com/articles/fork-a-repo
- How to create a virtualenv: http://simononsoftware.com/virtualenv-tutorial/
Note: It is important that when you create your virtualenv, do not create it in the same folder as the code you downloaded. The reason is that mynt will search the current directory for files to build and it looks for all folders that don't start with an underscore (which means it will find your virtualenv folder and error out).
To add a new PyLadies location to the PyLadies Website
Follow the instructions for setting up a development environment.
To add or edit a location, you will make changes to the
file found in the
YAML files are often used for configuration information. They can be fussy about spacing, indentations, and punctuation. It can be helpful when troubleshooting to use an online YAML validator to see if the file is correctly formatted. An example is YAML Lint though there are many others and some editors provide similar functionality.
An example of a location:
- email: firstname.lastname@example.org external_website: true image: pyladies_berlin.png location: latitude: 52.52 longitude: 13.38 meetup: PyLadies-Berlin meetup_id: 4663512976 meetup_image: https://secure.meetupstatic.com/photos/event/6/b/8/6/highres_454587526.jpeg name: Berlin, Germany organizer: Anett G. pro_network: Python Software Foundation Meetup Pro Network twitter: PyLadiesBer website: http://berlin.pyladies.com
Please note: if you wish to use the
website field, you need to create an official website through the PyLadies Chapter Website repository. Otherwise you can skip that field.
For Unicode accents in some languages To use a Unicode accent in a YAML file, it's important to use the HTML entity character for the accent. The HTML entity can found be found in a table of characters.
For example, México will have the HTML entity
To write a blog post
See CONTRIBUTING.md for instructions and guidelines.
To contribute to the repository
See CONTRIBUTING.md for instructions and guidelines.
To write a resource (more "sticky" than a blog post)
Collection of outside resources
If you want to add a bullet item to an existing subject matter, find the relevant post in
www/_posts (file titled by it's general category) and add to the
.md file. Please also update the date in the
.md file. For instance, if you want to add another suggestion to text editors, the original file is:
www/_posts/2013-04-19-tools-resources.md, and once you're done editing, it would be renamed to
If there is a collection of resources that do not fit into our loosely-named categories, like "tools" or "tutorials", etc, then start your own in
www/_posts/ and name the Markdown file with today's date, general category, plus the word "resources", like:
2013-04-21-developer-tips-resources.md. You will also need to have the following at the top:
--- layout: post.html title: "Your title here" tags: [list, of relevant, tags] category: resources ---
Your own resource
--- layout: post.html title: "Your title here" tags: [list, of relevant, tags] author: Name, or blank/none author_link: Twitter/Blog/etc or blank/none category: resources, pyladies ---
resources are required in for
Once done, save it in
www/_posts/ with the date and title in the name of the file, like so:
To find this resource online, you would navigate to http://pyladies.com/blog/[your_post_name]
Registering your PyLadies Chapter and onbtaining a website
Once you have obtained an official PyLadies Google account you should:
- Register your PyLadies Chapter to the Chapter Directory as active, we use this to populate the chapter options for members when registering as well as populate the PyLadies chapter map.
- Get started on building your PyLadies website, read the directions on the PyLadies Chapter Website repo.
Questions? Make sure to join us in Slack at slackin.pyladies.com and ask to join the #organizers channel!