mkdocs-material/.github/ISSUE_TEMPLATE/04-add-translations.yml

name: Add a translation
description: Missing support for your language? Add a translation
title: Add translations for ...
labels:
  - change request
body:

  - type: markdown
    attributes:
      value: >-
        **Important**: Before creating a new translation, please check if
        Material for MkDocs already supports your language. Review the list of
        [available languages](https://squidfunk.github.io/mkdocs-material/setup/changing-the-language/#site-language),
        pick your language to add new or improve existing translations.

  - type: textarea
    id: translations
    attributes:
      label: Translations
      description: >-
        Please translate the labels on the right. For new languages, translate
        each line. For existing languages, only translate lines containing the
        icon :arrow_left: and remove the icon before submitting.
        [More](https://squidfunk.github.io/mkdocs-material/contributing/adding-translations/#translations_1)
      value: |-
        {% macro t(key) %}{{ {
          "language": "en",
          "direction": "ltr",
          "action.edit": "Edit this page",
          "action.skip": "Skip to content",
          "action.view": "View source of this page",
          "announce.dismiss": "Don't show this again",
          "blog.archive": "Archive",
          "blog.categories": "Categories",
          "blog.categories.in": "in",
          "blog.continue": "Continue reading",
          "blog.draft": "Draft",
          "blog.index": "Back to index",
          "blog.meta": "Metadata",
          "blog.references": "Related links",
          "clipboard.copy": "Copy to clipboard",
          "clipboard.copied": "Copied to clipboard",
          "consent.accept": "Accept",
          "consent.manage": "Manage settings",
          "consent.reject": "Reject",
          "footer": "Footer",
          "footer.next": "Next",
          "footer.previous": "Previous",
          "header": "Header",
          "meta.comments": "Comments",
          "meta.source": "Source",
          "nav": "Navigation",
          "readtime.one": "1 min read",
          "readtime.other": "# min read",
          "rss.created": "RSS feed",
          "rss.updated": "RSS feed of updated content",
          "search": "Search",
          "search.placeholder": "Search",
          "search.share": "Share",
          "search.reset": "Clear",
          "search.result.initializer": "Initializing search",
          "search.result.placeholder": "Type to start searching",
          "search.result.none": "No matching documents",
          "search.result.one": "1 matching document",
          "search.result.other": "# matching documents",
          "search.result.more.one": "1 more on this page",
          "search.result.more.other": "# more on this page",
          "search.result.term.missing": "Missing",
          "select.language": "Select language",
          "select.version": "Select version",
          "source": "Go to repository",
          "source.file.contributors": "Contributors",
          "source.file.date.created": "Created",
          "source.file.date.updated": "Last update",
          "tabs": "Tabs",
          "toc": "Table of contents",
          "top": "Back to top"
        }[key] }}{% endmacro %}
      render: Jinja
    validations:
      required: true

  - type: input
    id: country-flag
    attributes:
      label: Country flag
      description: >-
        This field is optional. Please add the flag of the country when adding a
        new language. Go to our [emoji search](https://squidfunk.github.io/mkdocs-material/reference/icons-emojis/#search)
        and enter `flag` to find all available shortcodes. If your flag is not
        included, please choose the most appropriate available flag.
        [More](https://squidfunk.github.io/mkdocs-material/contributing/adding-translations/#country-flag)
      placeholder: |-
        Country flag shortcode, e.g. :flag_en:

  - type: checkboxes
    id: checklist
    attributes:
      label: Before submitting
      description: >-
        Please ensure that your translation fulfills the following requirements.
      options:
        - label: >-
            I've checked the list of [available languages](https://squidfunk.github.io/mkdocs-material/setup/changing-the-language/#site-language) for existing translations.
          required: true
        - label: >-
            I assure that the translations are accurate to the best of my knowledge.
          required: true
        - label: >-
            __Optional__: I want to integrate this translation myself and create a
            pull request following the [contribution guide](https://github.com/squidfunk/mkdocs-material/blob/master/CONTRIBUTING.md).