Contribute Content
So you want to make a PR
GREAT! We love pull requests. The easiest way to get involved is to write about your experiences with Python and PyLadies on our blog. Here are a few steps to help you get started:
-
Decide what you will write. It may be helpful to draft it out in your word processor or text editor of choice first.
-
Fork this repo!
-
Clone your fork to a directory on your machine so that you can develop in your text editor of choice.
-
Add a .md file with your post in the 'content' folder on branch master. Blog posts and articles both show up on the main stream, files in the
pages
directory are for the sidebar pages only. Your file needs to have a line with the titleTitle: {{ your awesome title here }}
and may have any/all of the following metadata:
Date: 2010-12-03 10:20
Modified: 2020-12-05 19:30
Category: Blog # PLEASE CHOOSE AN EXISTING CATEGORY - We may edit your category if it does not match our menu bar.
Tags: pelican, publishing # Choose any tags you like! Tag it up!
Slug: my-super-post # Defaults to your title, but you may set it directly.
Authors: Cleveland PyLadies, Floaty McFloatFace # Own it, lady!
Summary: Short version for index and feeds # Again all of these are optional.
Your super content goes below your metadata block. Remember to commit changes with meaningful messages before moving on!
Current category options:
-
Blog
-
PyLady Profiles
-
Anything other than these needs to be discussed before approval
You can preview changes you've saved locally with the following steps:
-
open a terminal and run
cd pyladies-official
(the location of your cloned fork) -
run
python -m venv myvenv
if you haven't already done so in that directory -
run
source myvenv/bin/activate
to activate the virtual environment you created for this project -
run
pip install --upgrade pip
and thenpip install -r requirements.txt
if this is the first time you've activated this virtual environment -
run
pelican content
to generate the site html files locally -
run
./develop_server.sh start
to make your version of the site available locally -
preview your version of the site by opening
http://localhost:8000
in your internet browser of choice.
When you are satisfied with the look of your article or other change:
-
Check to see if your fork is behind the main repo by any number of commits. These may cause problems if merge commits emerge between fork and PR. Contact us on Slack or Twitter if you are unsure.
-
Make a new pull request from the main repo. There is a green "New pull request" button to start this process. On the next page, select
compare across forks
, set your fork master as the head, give your PR a meaningful title/description, and submit your request (green "Create pull request" button). -
BOOM! You're officially an open-source contributor. We may ask for changes before merging your fork, but you've successfully gotten started! Shoot us an email or get at us on social if more than a week goes by and we haven't addressed your PR. We are very encouraging of new contributors, so give it a shot!