template-python-package/template/_quarto.yml.jinja at d3fcc5c023b4fb609fc73bc7838f274868d4ee2e · seedcase-project/template-python-package · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
project:
  type: website
  # Delete auto-generated files from `quartodoc`
  post-render: rm -f docs/reference/*.qmd
  render:
    - "docs/*"
    - "index.qmd"
    - "404.qmd"
    - "CONTRIBUTING.md"

website:
  # TODO: Fill in the title of the website.
  title: ""
  {% if hosting_provider == "gh-pages" -%}
  site-url: "https://{{ github_user }}.github.io/{{ github_repo }}/"
  {%- elif hosting_provider == "netlify" -%}
  # TODO: Set the Netlify custom domain URL
  site-url: "{{ homepage }}"
  {%- endif %}
  repo-url: "https://github.com/{{ package_github_repo }}"
  page-navigation: true
  navbar:
    pinned: true
    title: false
    {%- if is_seedcase_project %}
    logo: "_extensions/seedcase-project/seedcase-theme/logos/navbar-logo-{{ package_name }}.svg"
    logo-alt: "{{ package_name }} logo: Main page"
    {%- else %}
    # TODO: add logo
    logo: ""
    logo-alt: "{{ package_name }} logo: Main page"
    {%- endif %}
    left:
      - text: "Guide"
        href: docs/guide/index.qmd
      - text: "Design"
        href: docs/design/index.qmd
    tools:
      - icon: github
        href: "https://github.com/{{ package_github_repo }}"
        aria-label: "GitHub icon: Source code"
      {%- if is_seedcase_project %}
      - icon: house
        href: "https://seedcase-project.org"
        aria-label: "House icon: Main website for the Seedcase Project"
      {%- endif %}
  sidebar:
    - id: design
      pinned: true
      style: "floating"
      contents:
        - text: "Design"
          href: docs/design/index.qmd
    - id: guide
      contents:
        - section: "Guide"
          href: docs/guide/index.qmd

quartodoc:
  sidebar: "docs/reference/_sidebar.yml"
  style: "pkgdown"
  dir: "docs/reference"
  package: "{{ package_name_snake_case }}"
  parser: google
  dynamic: true
  renderer:
    style: _renderer.py
    table_style: description-list
    show_signature_annotations: true

metadata-files:
  - docs/reference/_sidebar.yml

format:
  {{ "seedcase-theme-html" if is_seedcase_project else "html" }}:
    include-before-body:
      - "docs/site-counter.html"

editor:
  markdown:
    wrap: 72
    canonical: true