PyLadies is a group of women who use and love the Python programming language. Our goal is to expand the local Python community to be 50% women.
JavaScript CSS HTML Ruby PHP ApacheConf
Latest commit f42d372 Jul 18, 2016 @econchick econchick committed on GitHub Merge pull request #277 from estherbester/upgrade_mynt_version
updated circle.yml to install mynt 0.3.1
Permalink
Failed to load latest commit information.
atl htaccess files Apr 10, 2013
berlin update berlin organisers and contacts Apr 1, 2016
blr added htaccess for blr (already deployed just not in github repo) Aug 18, 2013
boston fix meetup widget Oct 11, 2014
brazil adding coachs form Aug 20, 2014
charleston Use HTTPS for all Twitter links May 24, 2015
chicago/www changes chicago page to mynt and adds updates Jan 14, 2016
dc htaccess files Apr 10, 2013
discuss added international segment of forums Aug 19, 2013
helsinki new locations htaccess and subdomains Jun 19, 2013
london new locations htaccess and subdomains Jun 19, 2013
mtl montreal location Apr 10, 2013
munich Munich Chapter Jan 17, 2015
nyc make chapter webpage easier to maintain Nov 3, 2013
pdx local site folders Feb 14, 2013
pune Correcting indents to improve readability Apr 26, 2016
remote Add April Event Apr 2, 2016
sandiego initial for san diego Apr 1, 2013
saocarlos first commit - pyladies site from saocarlos-brazil May 1, 2015
seattle switch organizer info to correct images Jun 9, 2015
sf htaccess files Apr 10, 2013
siliconvalley changes chicago page to mynt and adds updates Jan 14, 2016
sthlm Cleaning up artefacts from merge errors Nov 11, 2013
tunisia tunisia htaccess Jun 13, 2013
tw new locations htaccess and subdomains Jun 19, 2013
vienna Use HTTPS for all Twitter links May 24, 2015
www Merge branch 'pr/285' Jul 18, 2016
.gitignore convert site to bootstrap Sep 7, 2013
CONTRIBUTING.md Fix little typo on Code School Feb 11, 2016
LICENSE Updated year Mar 14, 2014
README.md Updated README.md w/ contributing to the repo May 3, 2015
TODOs.md added todos Dec 19, 2012
circle.yml updated circle.yml to install mynt 0.3.1 Jun 12, 2016
fabfile.py fix rsync command in fabfile Jun 23, 2015
requirements.txt Use latest mynt (0.3.1) Jan 13, 2016
test_www.py Annotate circle.yml file Aug 5, 2015

README.md

Overview

This is the source code for the http://pyladies.com/ website. It uses mynt, a static site generator.

Directory Layout

This is a general overview of the top-level directory structure, which lives in the www folder. The things that aren't labeled contain content for the website.

.
├── CodeOfConduct
├── _assets        # javascript and CSS stuff goes here
├── _posts         # these are the blog posts written in markdown
├── _templates     # these are the base templates that other things use.
├── about
├── archives
├── blog
├── locations
├── resources
└── sponsor

To run locally

Note: before continuing, make sure you have headers for Python and libevent installed (e.g., on Ubuntu, python-dev and libevent-dev). Packages in requirements.txt require these to compile successfully.

  1. Fork http://github.com/pyladies/pyladies to your own github account.
  2. Clone to your machine
  3. Create a virtualenv called PyLadies and launch it (see Note below).
  4. (PyLadies) $ pip install -r requirements.txt
  5. (PyLadies) $ cd www (navigate to the pyladies/www directory of the cloned repository on your machine.)
  6. (PyLadies) $ mynt gen -f _site && mynt serve _site
  7. Copy the IP address provided once mynt has completed building the site. (It will say something like >> Serving at 127.0.0.1....), then paste the IP address into the URL bar of a browser window and load it to view the site.
  8. To view any changes you make to the site code, type ctrl+c in the terminal to stop the local server, then run the command from Step 6 again and refresh the browser window.

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 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 www/_post/todays-date-tools-resources.md.

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

If you want to write your own resources, like Barbara's beginner workshop notes or Juliana's Mac setup, in addition to CONTRIBUTING.md, you will need to add more items in the header portion, like so:

---
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
---

Notice that pyladies and resources are required in for category.

Once done, save it in www/_posts/ with the date and title in the name of the file, like so: 2013-04-21-lynns-awesome-resource.md.

To find this resource online, you would navigate to http://pyladies.com/blog/[your_post_name]

For Organizers

Your own domain/site:

You are welcome to create your own location's webspace, e.g. seattle.pyladies.com or sea.pyladies.com, or even www.pyladies.com/seattle etc. If you want your own URL, tell me:

  1. what you want your URL to be.
  2. make a pull request for your site.
  3. when you want it to go live.

If you just tell me your URL I can put dummy data - e.g. your location info etc, if you want to take your time to work on your own site.

Suggestions:

  • Play with the Meetup API to show your upcoming events, number of members, etc
  • Play with the Twitter API to show your group's latest tweets
  • A chapter blog
  • anything!

I really don't mind if you want to do a whole different design that doesn't match w/ the current homepage. Maybe keep it as mynt though

  • but your choice completely.

-your friendly administrator.