Pages are individual entire pages of markup content. They are require
Content to be acceptable in the system. Note that Pages are implemented using a fall through system of URL routing so a user cannot override an existing defined Django URL on accident with a Page.
Fields and Descriptions
|Title:||Title of the Page. Will also be used as the
|Keywords:||HTML META keywords for search engines|
|Description:||HTML META description for search engines|
|Path:||Relative URL path where the page will reside, excluding the initial slash. Example:
|Content:||The actual content of the page.|
|Markup Type:||Type of markup contained in the Content field. Options are: HTML, plain text, ReStructured Text, and Markdown|
|Is Published:||Controls whether or not the page is visible on the site.|
|Template Name:||By default Pages use the template
Pages are automatically purge from Fastly.com upon save.
Boxes are re-usable bits of HTML markup that are used throughout the site. Things like sidebar info and specific areas of areas of pages with a richer design (i.e. landing pages) that would be cumbersome to edit as one large content textarea.
There are special boxes that are automatically rebuilt using templates, see Supernavs.
Downloads and Releases¶
downloads app stores all of the structured data regarding Python releases. Each
Release object has associated
ReleaseFile objects that contain information on the various download formats Python.org
If the version you are creating should be considered the “latest” release for the major version in question (Python 2.x.x, 3.x.x, etc)
then check the ‘Is this the latest release’ checkbox. When the
Release is saved, the previous version will be automatically
demoted for you and the new version will be used prominently on the site. For example the download buttons and supernav links.
If you make a mistake here, no worries you can just check the box and save on ANY version and promote it to being the latest release.
To create a release you simply need to fill in the appropriate information. Currently if a
Release has an associated
Release Page the system redirects to that to accommodate legacy content, but if the
Content field is filled they are taken to the Release Detail page which shows the content and lists all of the associated downloadable files.
Release Files have a checkbox named ‘Download button’ that determines which binary/source package download link to display for a given OS. This information is used by the OS detection JS on the site so pick the package in most widespread use. On Source distributions be sure to check the ‘Download button’ for the .tgz version for widest compatibility.
The jobs application is using to display Python jobs on the site. The data items should be fairly self explanatory. There are a couple of things to keep in mind. Logged in users of the site can submit jobs for review.
|Status:||Jobs enter the system in ‘review’ status after the submitter has entered them. Only jobs in the ‘approved’ state are displayed on the site.|
|Featured:||Featured jobs are displayed more prominently on the landing page.|
|Comments:||Users who have submitted a job and admin reviewers can make comments on a job. Emails will be sent to the other party in order to foster communication about job description and data.|
The Sponsors app is a place to store PSF Sponsors. Sponsors have to be associated to a Company model from the companies app. If they are marked as is_published they will be shown on the main sponsor page which is located at /sponsors/.
If a Sponsor is marked as featured they will be included in the sponsor rotation on the main PSF landing page. In the fourth “Sponsors” column.