mkdocs.yml

site_name: Python для мережевих інженерів
site_url: https://pyneng.io/
# Copyright
# copyright: Copyright © 2015 - 2023 Nataliya Samoylenko


# Repository
#repo_name: natenka/pyneng.io
#repo_url: https://github.com/natenka/pyneng.io
theme:
  name: material
  language: uk
  icon:
    logo: material/book-open-outline
  features:
    - announce.dismiss
    - content.action.edit
    - content.action.view
    - content.code.annotate
    - content.code.copy
    # - content.code.select
    # - content.tabs.link
    - content.tooltips
    # - header.autohide
    - navigation.tabs
    # - navigation.tabs.sticky
    - navigation.tracking
    - navigation.instant
    - navigation.path
    # - navigation.prune
    - navigation.sections
    - navigation.footer
    - navigation.indexes
    - navigation.top
    # - navigation.expand
    - search.highlight
    - search.share
    - search.suggest
    - toc.follow
  palette:
    # Palette toggle for automatic mode
    - media: "(prefers-color-scheme)"
      toggle:
        icon: material/brightness-auto
        name: Switch to light mode
    # Palette toggle for light mode
    - media: '(prefers-color-scheme: light)'
      scheme: default
      primary: teal
      accent: amber
      toggle:
        icon: material/weather-night
        name: Switch to dark mode
    # Palette toggle for dark mode
    - media: '(prefers-color-scheme: dark)'
      scheme: slate
      primary: teal
      accent: amber
      toggle:
        icon: material/weather-sunny
        name: Switch to light mode


# Plugins
plugins:
  - blog
  - search
  - git-revision-date-localized:
      enable_creation_date: true
#- with-pdf:
  #- extra-sass
  #- with-pdf:
  #    ordered_chapter_level: 0
  #    output_path: site/pdf/document.pdf
  #    author: Nataliya Samoylenko
  #    toc_level: 3
  #    exclude_pages:
  #      - blog/
  #      - reference/
  #      - course/
  #    cover_subtitle: Книга, курс та завдання з основ Python
  #    # render_js: true
  #    # headless_chrome_path: chromium

# Customization
extra:
  social:
    - icon: fontawesome/brands/youtube
      link: https://www.youtube.com/@pynenguk
    - icon: fontawesome/brands/github
      link: https://github.com/natenka
  analytics:
    provider: google
    property: G-3WX9XBK91Y



# Extensions
markdown_extensions:
  - abbr
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - toc:
      permalink: true
  - pymdownx.arithmatex:
      generic: true
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.details
  - pymdownx.emoji:
      emoji_generator: !!python/name:materialx.emoji.to_svg
      emoji_index: !!python/name:materialx.emoji.twemoji
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.keys
  - pymdownx.magiclink:
      repo_url_shorthand: true
      user: squidfunk
      repo: mkdocs-material
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.tilde

# Page tree
nav:
  - " ": index.md
    #- keyboard_shortcuts.md
    #- todo.md
  - Книга:
    - book/index.md
    - Підготовка:
      - 1. Підготовка до роботи:
        - book/01-intro/index.md
        - book/01-intro/work_env.md
        - book/01-intro/os_and_editor.md
        - book/01-intro/pip.md
        - book/01-intro/venv.md
        - book/01-intro/check_python.md
        - book/01-intro/further_reading.md
      - 2. Робота із завданнями:
        - book/02-git-github-tasks/index.md
        - Завдання: tasks/index.md
        - Використання Git та GitHub:
          - book/02-git-github-tasks/git/index.md
          - book/02-git-github-tasks/git/basics.md
          - book/02-git-github-tasks/git/basics-bash-status.md
          - book/02-git-github-tasks/git/basics-commands.md
          - book/02-git-github-tasks/git/basics-additional.md
          - book/02-git-github-tasks/git/github-auth.md
          - book/02-git-github-tasks/git/github-changes.md
          - book/02-git-github-tasks/git/code-examples.md
        - book/02-git-github-tasks/further_reading.md
    - Основи Python:
      - 3. Початок роботи з Python:
        - book/03-python-intro/index.md
        - book/03-python-intro/syntax.md
        - book/03-python-intro/ipython.md
        - book/03-python-intro/ipython_magic.md
        - book/03-python-intro/variables.md
      - 4. Типи даних у Python:
        - book/04-data-structures/index.md
        - book/04-data-structures/numbers.md
        - Рядки (Strings):
          - book/04-data-structures/string/index.md
          - book/04-data-structures/string/methods.md
          - book/04-data-structures/string/literal_concatenation.md
        - Список (List):
          - book/04-data-structures/list/index.md
          - book/04-data-structures/list/methods.md
        - Словник (Dictionary):
          - book/04-data-structures/dict/index.md
          - book/04-data-structures/dict/methods.md
          - book/04-data-structures/dict/create.md
        - book/04-data-structures/tuple.md
        - book/04-data-structures/set.md
        - book/04-data-structures/boolean.md
        - book/04-data-structures/string_format.md
        - book/04-data-structures/convert_type.md
        - book/04-data-structures/check_type.md
        - book/04-data-structures/method_chaining.md
        - book/04-data-structures/sorting.md
        - book/04-data-structures/further_reading.md
      - 5. Створення базових скриптів:
        - book/05-basic-scripts/index.md
        - book/05-basic-scripts/executable.md
        - book/05-basic-scripts/args.md
        - book/05-basic-scripts/user-input.md
      - 6. Контроль перебігу програми:
        - book/06-control-structures/index.md
        - book/06-control-structures/if-else.md
        - book/06-control-structures/for.md
        - book/06-control-structures/for-in-for.md
        - book/06-control-structures/for-if.md
        - book/06-control-structures/while.md
        - book/06-control-structures/break-continue-pass.md
        - book/06-control-structures/for-while-else.md
        - book/06-control-structures/exceptions.md
        - book/06-control-structures/further-reading.md
      - 7. Робота з файлами:
        - book/07-files/index.md
        - book/07-files/open.md
        - book/07-files/read.md
        - book/07-files/write.md
        - book/07-files/close.md
        - book/07-files/with.md
        - book/07-files/working-with-files.md
        - book/07-files/further-reading.md
      - 8. Корисні можливості та інструменти:
        - book/08-useful-basics/index.md
        - book/08-useful-basics/f-string.md
        - book/08-useful-basics/variable-unpacking.md
        - book/08-useful-basics/x-comprehensions.md
        - book/08-useful-basics/debug.md
        - book/08-useful-basics/further-reading.md
    - Функції та модулі:
      - 9. Функції. Основи:
        - book/09-functions/index.md
        - book/09-functions/create-func.md
        - book/09-functions/namespace.md
        - Параметри та аргументи:
          - book/09-functions/params-args.md
          - book/09-functions/params-types.md
          - book/09-functions/args-types.md
        - book/09-functions/common-gotchas.md
        - book/09-functions/further-reading.md
      - 10. Корисні вбудовані функції:
        - book/10-useful-functions/index.md
        - book/10-useful-functions/print.md
        - book/10-useful-functions/range.md
        - book/10-useful-functions/sorted.md
        - book/10-useful-functions/zip.md
        - book/10-useful-functions/enumerate.md
        - book/10-useful-functions/all-any.md
      - 11. Модулі:
        - book/11-modules/index.md
        - book/11-modules/import.md
        - book/11-modules/create.md
        - book/11-modules/if-name-main.md
        - book/11-modules/module-search.md
        - book/11-modules/code-structure.md
        - book/11-modules/further-reading.md
      - 12. Корисні модулі:
        - book/12-useful-modules/index.md
        - book/12-useful-modules/subprocess.md
    #- 13. Функції. Продовження. Зірочка в аргументах та параметрах, аннотація
        #- book/10-useful-functions/lambda.md
        #- book/10-useful-functions/map.md
        #- book/10-useful-functions/filter.md
    - Додаткова інформація:
      - book/appendix/index.md
      #- Ітератор, ітерований об'єкт: book/appendix/iterator-iterable.md
  - Курс:
    - course/index.md
    - Лекції:
      #- course/pynenguk.md
      - course/schedule.md
      - course/theory.md
      - course/theory-details.md
    - Теми:
      - course/topics/00-preparation.md
      - course/topics/01-course-env.md
      - course/topics/02-git-github-tasks.md
      - course/topics/03-python-intro.md
      - course/topics/04-data-types.md
      - course/topics/05-basic-scripts.md
      - course/topics/06-control-structures.md
      - course/topics/debug.md
      - course/topics/07-files.md
      - course/topics/08-useful-basics.md
      - course/topics/09-functions.md
      - course/topics/10-useful-functions.md
    - Корисні посилання:
      - course/schedule-tasks.md
      - course/links.md
  - Завдання:
    - tasks/index.md
    - tasks/pyneng.md
    # - tasks/pyneng-output.md
    - tasks/task-topic-table.md
    - Запитання: tasks/quiz.md
    - Підготовка вм/хоста:
      - Linux: tasks/linux.md
      - Windows: tasks/windows.md
      - tasks/windows-gotchas.md
    - Редактори:
      - tasks/editors/index.md
      - tasks/editors/prepare.md
      - tasks/editors/thonny.md
      - tasks/editors/vim.md
  - Довідник Python:
    - reference/index.md
    - Синтаксис Python:
      - reference/syntax/index.md
    - Типи даних у Python:
      - reference/data_types/index.md
      - Рядки (Strings):
        - reference/string/index.md
        - Методи:
          - reference/string/methods/index.md
          - reference/string/methods/join.md
          - reference/string/methods/rsplit.md
          - reference/string/methods/split.md
        - Форматування рядків:
          - reference/string/format/index.md
          - reference/string/format/format.md
          - reference/string/format/f-string.md
      - Список (List):
        - reference/list/index.md
        - Створення списку:
          - reference/list/literal.md
          - reference/list/list.md
        - reference/list/methods.md
      - Словник (Dictionary):
        - reference/dict/index.md
      - Множини (Sets):
        - reference/set/index.md
        - Методи:
          - reference/set/methods/index.md
          - reference/set/methods/add.md
          - reference/set/methods/intersection.md
          - reference/set/methods/difference.md
          - reference/set/methods/symmetric_difference.md
          - reference/set/methods/union.md
    - Comprehensions, generator expression:
      - reference/comprehensions/index.md
      - reference/comprehensions/list.md
    - Винятки:
      - reference/exceptions/index.md
    - Вбудовані функції:
      - reference/functions/index.md
      - reference/functions/input.md
      - reference/functions/isinstance.md
      - reference/functions/iter.md
      - reference/functions/open.md
      - reference/functions/sorted.md
      - reference/functions/type.md
    - Протоколи:
      - reference/protocols/index.md
      - reference/protocols/iterable.md
    - Глосарій:
      - reference/glossary/index.md
  - Блог:
    - blog/index.md
  #- Придбати курси, перевірку завдань, консультацію:
  #  - https://learning.pyneng.io/