This is the source code for the http://pyladies.com/ website. It uses
mynt, a static site generator.
This is a general overview of the top-level directory structure. The things that aren't labeled contain content for the website.
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.
- Fork http://github.com/pyladies/pyladies to your own github account.
- Clone to your machine
- Create a virtualenv called PyLadies
- (PyLadies) $
pip install -r requirements.txt
mynt gen -f _site && mynt serve _site
- 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).
See CONTRIBUTING.md for instructions and guidelines.
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 ---
--- 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]
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:
- what you want your URL to be.
- make a pull request for your site.
- 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.
- 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
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.