awesome-django/_config.yml

title: Awesome Django
email: your-email@example.com
description: >-
  A curated list of awesome things related to Django. Maintained by
  William Vincent and Jeff Triplett
baseurl: "" # the subpath of your site, e.g. /blog
url: "https://awesomedjango.org" # the base hostname & protocol for your site, e.g. http://example.com

# Build settings
markdown: kramdown
remote_theme: pmarsceill/just-the-docs
plugins:
  - jekyll-feed
  - jekyll-optional-front-matter
  - jekyll-seo-tag
include:
  - README.md
exclude:
  - "*.md"
  - "*.py"
  - docker*
  - Gemfile*
  - justfile
  - LICENSE
  - Makefile
  - modd.conf
  - node_modules
  - package*.json
  - postcss.config.js
  - requirements.*
  - src
  - tailwind.config.js
  - vendor
defaults:
  - scope:
      path: "" # an empty string here means all files in the project
    values:
      layout: "default"
  - scope:
      path: "README.md"
    values:
      permalink: "/"
      layout: "default"

aux_links:
  "Awesome Django on GitHub":
    - "//github.com/wsvincent/awesome-django"

# Makes Aux links open in a new tab. Default is false
aux_links_new_tab: false

color_scheme: django
# color_scheme: light

heading_anchors: true

footer_content: >-
  <iframe src="https://django-news.com/embed?color1=ffffff&color2=092e20&color_bg_button=092e20&color_border=ccc&color_button=ffffff&color_links=979797&color_terms=808080&title=Subscribe+to+Django+News" width="450" height="310" frameborder="0" style="max-width: 100%"></iframe>

  <p>Please consider supporting Django by making a donation to the
  <a rel="sponsored" href="https://www.djangoproject.com/fundraising/">Django Software Foundation</a>, 
  sponsoring via <a rel="sponsored" href="https://github.com/sponsors/django">GitHub Sponsors</a>, 
  or buying <a rel="sponsored" href="https://django.threadless.com/">official merchandise</a>.</p>
  
  <p>Awesome Django is not associated with the Django Software Foundation.<br>
  Django is a registered trademark of the Django Software Foundation.</p>

# Footer last edited timestamp
last_edit_timestamp: true # show or hide edit time - page must have `last_modified_date` defined in the frontmatter
last_edit_time_format: "%b %e %Y at %I:%M %p" # uses ruby's time format: https://ruby-doc.org/stdlib-2.7.0/libdoc/time/rdoc/Time.html

# Footer "Edit this page on GitHub" link text
gh_edit_link: true # show or hide edit this page link
gh_edit_link_text: "Edit this page on GitHub."
gh_edit_repository: "https://github.com/wsvincent/awesome-django" # the github URL for your repo
gh_edit_branch: "main" # the branch that your docs is served from
# gh_edit_source: docs # the source that your files originate from
gh_edit_view_mode: "tree" # "tree" or "edit" if you want the user to jump into the editor immediately


search_enabled: false

search:
  # Split pages into sections that can be searched individually
  # Supports 1 - 6, default: 2
  heading_level: 2
  # Maximum amount of previews per search result
  # Default: 3
  previews: 3
  # Maximum amount of words to display before a matched word in the preview
  # Default: 5
  preview_words_before: 5
  # Maximum amount of words to display after a matched word in the preview
  # Default: 10
  preview_words_after: 10
  # Set the search token separator
  # Default: /[\s\-/]+/
  # Example: enable support for hyphenated search words
  tokenizer_separator: /[\s/]+/
  # Display the relative url in search results
  # Supports true (default) or false
  rel_url: true
  # Enable or disable the search button that appears in the bottom right corner of every page
  # Supports true or false (default)
  button: false


nav_external_links:
  - title: Third-Party Packages
    url: "#third-party-packages"
    hide_icon: true
  - title: Python Packages
    url: "#python-packages"
    hide_icon: true
  - title: Resources
    url: "#resources"
    hide_icon: true
  - title: Hosting
    url: "#hosting"
    hide_icon: true
  - title: Projects
    url: "#projects"
    hide_icon: true
  - title: Django REST Framework
    url: "#django-rest-framework"
    hide_icon: true
  - title: Wagtail
    url: "#wagtail"
    hide_icon: true