### Start Development Server

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Launch the local development server to test changes. This command is typically used after migrations and initial data setup.

```bash
./manage.py runserver
```

--------------------------------

### Serve Python.org Locally

Source: https://github.com/python/pythondotorg/blob/main/README.md

Run this command to start a local development server for python.org. Ensure you have the necessary prerequisites installed.

```bash
make serve
```

--------------------------------

### Install Project Dependencies

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Install the project's development dependencies within the activated virtual environment. The '[dev]' argument installs optional dependencies for development.

```bash
$ pip install -e '.[dev]'
```

--------------------------------

### Install Dependencies and Minify CSS

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Install Node.js dependencies and then minify CSS files for production. This is an optional step for development.

```bash
npm install
make css
```

--------------------------------

### Clone Pythondotorg Repository (Manual Setup)

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Clone the Pythondotorg repository using Git for manual setup. This command is an alternative to the SSH-based clone.

```git
$ git clone git://github.com/python/pythondotorg.git
```

--------------------------------

### Link and Anchor Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Provides an example of creating a hyperlink using the <a> tag, linking to another page or an anchor on the same page.

```html
<a href="link/to/page">link text</a>
```

--------------------------------

### Definition List Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Shows how to create a definition list using <dl>, <dt>, and <dd> tags for terms and their descriptions.

```html
<dl>
    <dt>Definition term</dt>
    <dd>Definition</dd>
    <dt>Definition term</dt>
    <dt>Another definition term</dt>
    <dd>Definition of both terms above</dd>
</dl>
```

--------------------------------

### Ordered List Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Demonstrates the structure of an ordered list with nested sub-lists using the <ol> and <li> tags.

```html
<ol>
    <li>List item one</li>
    <li>List item two
        <ol>
            <li>Nested list item one</li>
            <li>Nested list item two</li>
        </ol>
    </li>
</ol>
```

--------------------------------

### Heading - H6 Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Example of a sixth-level heading (h6) for document hierarchy.

```html
<h6>Sixth-Level Header [with a Link](#)</h6>
```

--------------------------------

### Heading - H5 Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Example of a fifth-level heading (h5) for document hierarchy.

```html
<h5>Fifth-Level Header [with a Link](#)</h5>
```

--------------------------------

### Paragraph Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Standard HTML paragraph markup.

```html
<p>This is a paragraph</p>
```

--------------------------------

### Heading - H1 Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Example of a primary importance heading (h1). Can include links.

```html
<h1>This is a heading of primary importance</h1>
```

--------------------------------

### Unordered List Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Illustrates an unordered list with nested sub-lists using the <ul> and <li> tags.

```html
<ul>
    <li>List item one</li>
    <li>List item two
        <ul>
            <li>Nested list item one</li>
            <li>Nested list item two</li>
        </ul>
    </li>
</ul>
```

--------------------------------

### Fastly Production CDN Configuration

Source: https://github.com/python/pythondotorg/blob/main/infra/cdn/README.md

Example of how to configure the Fastly production CDN service using the module. Ensure all required variables like API keys and logging configurations are provided.

```hcl
module "fastly_production" {
  source = "./cdn"

  name            = "CoolPythonApp.org"
  domain          = "CoolPythonApp.org"
  subdomain       = "www.CoolPythonApp.org"
  extra_domains   = ["www.CoolPythonApp.org"]
  backend_address = "service.CoolPythonApp.org"
  default_ttl     = 3600

  datadog_key         = var.DATADOG_API_KEY
  fastly_key          = var.FASTLY_API_KEY
  fastly_header_token = var.FASTLY_HEADER_TOKEN
  s3_logging_keys     = var.fastly_s3_logging
}
```

--------------------------------

### Heading - H3 Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Example of a third-level heading (h3) for document hierarchy.

```html
<h3>Third-Level Header [with a Link](#)</h3>
```

--------------------------------

### View Local Development Server Output

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

This output indicates that the development server has started successfully and is accessible at http://0.0.0.0:8000/. You can stop the server using CONTROL-C.

```bash
web_1       | Starting development server at http://0.0.0.0:8000/
web_1       | Quit the server with CONTROL-C.
```

--------------------------------

### Heading - H2 Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Example of a secondary level heading (h2). Suitable for sub-headers.

```html
<h2>Second-Level Header [with a Link](#)</h2>
```

--------------------------------

### Heading - H4 Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Example of a fourth-level heading (h4) for document hierarchy.

```html
<h4>Fourth-Level Header [with a Link](#)</h4>
```

--------------------------------

### Create PostgreSQL Database

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Create a new PostgreSQL database named 'pythondotorg' with UTF-8 encoding and en_US.UTF-8 collation. This command is used for manual setup.

```bash
$ createdb pythondotorg -E utf-8 -l en_US.UTF-8
```

--------------------------------

### Strong Importance Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Illustrates how to denote text with strong importance using the <strong> tag.

```html
<strong>Do not under any circumstances</strong> stick nails in the electrical outlet.
```

--------------------------------

### Stressed Emphasis Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Shows how to apply stressed emphasis to text using the <em> tag, indicating pronunciation differences.

```html
You simply <em>must</em> try the negitoro maki!
```

--------------------------------

### Blockquote Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Represents a section quoted from another source, optionally with a citation.

```html
<blockquote cite="optional link to source material">
    <p>Quoted text</p>
</blockquote>
<p>— <cite><a href="optional link to source material">Source of the Quote</a></cite></p>
```

--------------------------------

### Fastly NGWAF Activation

Source: https://github.com/python/pythondotorg/blob/main/infra/cdn/README.md

Example snippet showing how to activate the Fastly Next-Gen Web Application Firewall (NGWAF) for a Fastly service. This is an optional configuration.

```hcl
module "fastly_production" {
  source = "./cdn"

  ... 
  activate_ngwaf_service = true
  ...
}
```

--------------------------------

### Figure with Caption Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Demonstrates the use of the <figure> element to group images or other self-contained content with an optional <figcaption>.

```html
<figure>
    <img src="link/to/image" alt="Alt text displayed when image does not load">
    <figcaption>An optional caption for the content above with an optional <cite>citation</cite></figcaption>
</figure>
```

--------------------------------

### Run create_initial_data with --app-label option

Source: https://github.com/python/pythondotorg/blob/main/docs/source/commands.md

Executes the create_initial_data command to create data for a specific app. Provide the app's label to target data generation.

```bash
$ ./manage.py create_initial_data --app-label jobs
```

--------------------------------

### Create Initial Data

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Populate the database with initial data for commonly used applications. Refer to the documentation for command options.

```bash
./manage.py create_initial_data
```

--------------------------------

### Run create_initial_data with --flush option

Source: https://github.com/python/pythondotorg/blob/main/docs/source/commands.md

Executes the create_initial_data command and flushes the database first. Use this to ensure a clean slate before creating new data.

```bash
$ ./manage.py create_initial_data --flush
```

--------------------------------

### Run create_initial_data command

Source: https://github.com/python/pythondotorg/blob/main/docs/source/commands.md

Executes the create_initial_data management command to populate the application with initial data. This is the basic usage.

```bash
$ ./manage.py create_initial_data
```

--------------------------------

### Apply Migrations

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Run this command to apply database migrations to your local environment.

```bash
make migrate
```

--------------------------------

### Horizontal Rule Example

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Represents a thematic break between sections or topics.

```html
* * *
```

--------------------------------

### Configure Database with dj-database-url

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Configure the database connection in 'pydotorg/settings/local.py' using dj_database_url.parse or by setting the DATABASE_URL environment variable.

```python
DATABASES = {
    'default': dj_database_url.parse('postgres:///your_database_name'),
}
```

--------------------------------

### Create PostgreSQL Database with Postgres User

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

If the default 'createdb' command fails due to permission errors, use this command to create the 'pythondotorg' database with the 'postgres' user as the owner.

```bash
$ sudo -u postgres createdb pythondotorg -E utf-8 -l en_US.UTF-8
```

--------------------------------

### Run Tests

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Execute the project's test suite to ensure code quality and identify regressions. This command verifies the current state of the application.

```bash
./manage.py test
```

--------------------------------

### Run Database Migrations

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Apply database schema changes. This command is essential after setting up a new database or pulling changes that affect the database structure.

```bash
./manage.py migrate
```

--------------------------------

### Launch Interactive Shell

Source: https://github.com/python/pythondotorg/blob/main/templates/python/index.html

Provides a link to launch an interactive Python shell.

```html
<a href="/shell/">>__ Launch Interactive Shell</a>
```

--------------------------------

### Lint Python.org Code

Source: https://github.com/python/pythondotorg/blob/main/README.md

Apply linting to the codebase to check for style guide violations and potential errors. This command helps maintain code consistency.

```bash
make lint
```

--------------------------------

### Form Structure with <form>, <fieldset>, and <label>

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Demonstrates the basic structure of an HTML form using <form>, <fieldset> for grouping, and <label> for accessibility.

```HTML
<form>
    <fieldset>
        <legend>Input Field Types</legend>
        <label for="text-input">Text Input</label>
        <input type="text" id="text-input" placeholder="This is a sample input field of type=\"text\""><br>

        <label for="password-input">Password</label>
        <input type="password" id="password-input" placeholder="This is a sample input field of type=\"password\""><br>

        <label for="email-input">Email Address</label>
        <input type="email" id="email-input" placeholder="This is a sample input field of type=\"email\""><br>

        <label for="url-input">Web Address</label>
        <input type="url" id="url-input" placeholder="This is a sample input field of type=\"url\""><br>

        <label for="phone-input">Phone Number</label>
        <input type="number" id="phone-input" placeholder="This is a sample input field of type=\"number\""><br>

        <label for="textarea-input">Textarea</label>
        <textarea id="textarea-input" placeholder="This is a sample textarea for multi-line user input"></textarea><br>
    </fieldset>

    <fieldset>
        <legend>Selectable Option Items</legend>
        <label for="select-options">Options</label>
        <select id="select-options">
            <option>Option One</option>
            <option>Option Two</option>
            <option>Option Three</option>
        </select>
    </fieldset>

    <fieldset>
        <legend>Checkboxes</legend>
        <label><input type="checkbox"> Option 1</label><br>
        <label><input type="checkbox"> Option 2</label><br>
        <label><input type="checkbox"> Option 3</label><br>
    </fieldset>

    <fieldset>
        <legend>Radio Buttons</legend>
        <label><input type="radio" name="radio-group"> Choice A</label><br>
        <label><input type="radio" name="radio-group"> Choice B</label><br>
        <label><input type="radio" name="radio-group"> Choice C</label><br>
    </fieldset>

    <fieldset>
        <legend>Button Types</legend>
        <input type="submit" value="Preview">
        <button type="button">Button</button>
        <input type="reset" value="Cancel">
        <a href="#">Link Button</a>
    </fieldset>
</form>
```

--------------------------------

### Sample Output Representation

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Use the <samp> element to represent sample output from a program or computing system.

```HTML
The computer said <samp>Too much cheese</samp>…
```

--------------------------------

### Set SQLite Database URL Environment Variable

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Configure the project to use SQLite as the database by setting the DATABASE_URL environment variable for the current terminal session.

```bash
$ export DATABASE_URL="sqlite:///pythondotorg.db"
```

--------------------------------

### Display Upcoming Events

Source: https://github.com/python/pythondotorg/blob/main/templates/components/event-posts.html

Use the `get_events_upcoming` template tag to retrieve a specified number of upcoming events. The `iso_time_tag` formats the event's start time, and `striptags` cleans the event title. This snippet is useful for displaying event listings on a website.

```django
{% load events cms %}

{% get_events_upcoming limit=5 as events %} {% for event in events %} {% with event.next_time as next_time %}*   {% iso_time_tag next_time.dt_start %} [{{ event.title|striptags }}]({{ event.get_absolute_url }})
{% endwith %} {% endfor %}
```

--------------------------------

### Create Superuser

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Create an administrative user account for accessing the Django admin interface. This is useful for a new database.

```bash
./manage.py createsuperuser
```

--------------------------------

### Clone Pythondotorg Repository

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Clone the Pythondotorg repository from GitHub to your local machine. This is the first step in obtaining the source code.

```git
git clone git@github.com:YOUR-USERNAME/pythondotorg.git
```

--------------------------------

### Definition Highlighting

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Use the <dfn> element to highlight the first use of a term. The 'title' attribute can provide a tooltip description.

```HTML
Bob’s <dfn title="Dog">canine</dfn> mother and <dfn title="Horse">equine</dfn> father.
```

--------------------------------

### Highlighting Text with <mark>

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Demonstrates the use of the <mark> element to highlight text for reference or relevance.

```HTML
Maybe I should adopt a <mark>kitten</mark>
```

--------------------------------

### Run Tests for Python.org

Source: https://github.com/python/pythondotorg/blob/main/README.md

Execute the test suite to ensure code quality and correctness before submitting changes. This command verifies that all tests pass.

```bash
make test
```

--------------------------------

### Format Python.org Code

Source: https://github.com/python/pythondotorg/blob/main/README.md

Format the codebase according to the project's style guidelines. This command ensures consistent code formatting across the project.

```bash
make fmt
```

--------------------------------

### User Feedback Module - Success

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Use this module to confirm successful actions or operations.

```html
<div class="user-feedback level-success">
    <p role="alert"><span aria-hidden="true">&#10004;</span> Content</p>
</div>
```

--------------------------------

### User Feedback Module - General

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Use this module for general user feedback or announcements.

```html
<div class="user-feedback level-general">
    <p role="alert">Content</p>
</div>
```

--------------------------------

### Create Python Virtual Environment

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Create a new virtual environment named 'venv' using Python 3. This isolates project dependencies.

```bash
$ python3 -m venv venv
```

--------------------------------

### Display Latest Blog Posts

Source: https://github.com/python/pythondotorg/blob/main/templates/components/blog-posts.html

Fetches the 5 latest blog entries and iterates through them to display publication date, title, and a link. Ensure BLOG_URL is configured.

```html
{% load blogs cms %}

Latest News
-----------

[More]({{ BLOG_URL }} "More News")

{% get_latest_blog_entries limit=5 as entries %} {% for entry in entries %}*   {% iso_time_tag entry.pub_date %} [{{ entry.title }}]({{ entry.url }})
{% endfor %}
```

--------------------------------

### User Feedback Module - Notice

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Use this module to display notices or important information to the user.

```html
<div class="user-feedback level-notice">
    <p role="alert">Content</p>
</div>
```

--------------------------------

### Dump Database Data

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Save data from a specified application into a JSON fixture file. This is useful for backing up data before making significant changes or for seeding other environments.

```bash
./manage.py dumpdata --format=json --indent=4 $APPNAME > fixtures/$APPNAME.json
```

--------------------------------

### Check for Missing Migrations

Source: https://github.com/python/pythondotorg/blob/main/README.md

Verify if there are any ungenerated database migrations. This is a crucial step before submitting code changes to ensure database schema consistency.

```bash
make migrations
```

--------------------------------

### Displaying Sponsor Logo

Source: https://github.com/python/pythondotorg/blob/main/apps/users/templates/users/sponsor_info_update.html

Renders the current sponsor logo name and URL if available. Displays help text if provided.

```html
{% comment %} TODO: This script is almost a direct copy of the inline one from templates/sponsors/new_sponsorship_application_form.html It's likely possible that we can refactor both codes to use the same javascript instead of duplication. {% endcomment %}
// JS reference from https://medium.com/all-about-django/adding-forms-dynamically-to-a-django-formset-375f1090c2b0
```

--------------------------------

### Iterating Through Python Releases

Source: https://github.com/python/pythondotorg/blob/main/apps/downloads/templates/downloads/active-releases.html

This Jinja2 template code iterates through a list of Python releases to display their details. It constructs download links and PEP links based on release information.

```html
{% for release in releases %}
1.  {{ release.version }} {{ release.status }} [Download](/downloads/latest/python{{ release.version }}/) {{ release.first_release }} {{ release.end_of_life }} {% if release.pep %}[PEP {{ release.pep }}](https://peps.python.org/pep-{{ release.pep|stringformat:){% endif %}
{% endfor %}
```

--------------------------------

### Run Tests for a Single App

Source: https://github.com/python/pythondotorg/blob/main/docs/source/index.md

Executes tests specifically for the 'events' application. This is useful for targeted testing during development.

```bash
make manage test events
```

--------------------------------

### Keyboard Entry Representation

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Use the <kbd> element to denote user input, typically from a keyboard.

```HTML
Press the <kbd>⌘ Cmd</kbd> key…
```

--------------------------------

### Structuring Tabular Data with <table>

Source: https://github.com/python/pythondotorg/blob/main/templates/python/inner.html

Illustrates the use of the <table> element for displaying tabular data, including <caption>, <colgroup>, <col>, <thead>, <tbody>, and <th>.

```HTML
<table>
        <caption>The Very Best Eggnog</caption>
        <colgroup>
            <col style="width:50%">
            <col style="width:25%">
            <col style="width:25%">
        </colgroup>
        <thead>
            <tr>
                <th scope="col">Ingredients</th>
                <th scope="col">Serves 12</th>
                <th scope="col">Serves 24</th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td>Milk</td>
                <td>1 quart</td>
                <td>2 quart</td>
            </tr>
        </tbody>
    </table>
```

--------------------------------

### Generate Test Coverage Report

Source: https://github.com/python/pythondotorg/blob/main/docs/source/install.md

Run tests and generate a coverage report to identify untested code. An HTML report can also be generated using `coverage html`.

```bash
coverage run manage.py test
coverage report
```

--------------------------------

### Site Tree Footer Iteration

Source: https://github.com/python/pythondotorg/blob/main/templates/sitetree/footer.html

Iterates over site tree items to create footer navigation links. Renders children using a specific template if they exist.

```html
{% load sitetree %}

{% for item in sitetree_items %}*   [{{ item.title_resolved }}({% sitetree_url for item %}) {% if item.has_children %} {% sitetree_children of item for menu template "sitetree/footer_children.html" %} {% endif %}
{% endfor %}
```

--------------------------------

### Django Template for Signup Form

Source: https://github.com/python/pythondotorg/blob/main/templates/account/signup.html

This Django template renders the signup form, including CSRF token, form fields, honeypot protection, and internationalization tags. It extends a base account template.

```html
{% extends "account/base.html" %} {% load i18n %} {% load honeypot %} {% block page_title %}{% trans "Signup for Python.org" %}{% endblock %} {% block extra_js %} jQuery(window).load(function() { $('#id_username').focus(); jQuery.fn.preventDoubleSubmission = function() { var last_clicked, time_since_clicked; $(this).bind('submit', function(event) { if (last_clicked) { time_since_clicked = event.timeStamp - last_clicked; } last_clicked = event.timeStamp; return !(time_since_clicked < 2000); }); }; $('#signup_form').preventDoubleSubmission(); }); {% endblock extra_js %} {% block content_attributes %}with-right-sidebar{% endblock %} {% block content %} 
{% trans "Sign Up" %}
=====================

You do not need a python.org account to [download]({% url 'download:download' %}) or use Python.

{% csrf_token %} {{ form.as_p }} {% if redirect_field_value %}  {% endif %} {% render_honeypot_field %} {% trans "Sign Up" %} »

{% endblock %} {% block right_sidebar %} 

Already have an account?
------------------------

If you already have a Python.org account please sign in.

[Sign In]({% url 'account_login' %})

{% endblock right_sidebar %}
```

--------------------------------

### Render Site Tree Items

Source: https://github.com/python/pythondotorg/blob/main/templates/sitetree/top.html

This snippet iterates over site tree items and generates a Markdown-formatted list with links. It's used for displaying navigation structures.

```html
{% load sitetree %}

{% for item in sitetree_items %}*   [{{ item.title_resolved }}]({% sitetree_url for item %})
{% endfor %}
```