diff --git a/.github/ISSUE_TEMPLATE/bug.md b/.github/ISSUE_TEMPLATE/bug.md deleted file mode 100644 index d6bc1b520..000000000 --- a/.github/ISSUE_TEMPLATE/bug.md +++ /dev/null @@ -1,77 +0,0 @@ ---- -name: Bug -about: Report a bug -title: '' -assignees: '' ---- - - - -- [ ] I've read the [contribution guidelines][1] and agree with them - -__I've found a bug and checked that ...__ - -- [ ] ... the problem doesn't occur with the default MkDocs template -- [ ] ... the problem is not in any of my customizations (CSS, JS, template) -- [ ] ... the documentation does not mention anything about my problem -- [ ] ... there are no open or closed issues that are related to my problem - -## Description - - - -### Expected behavior - - - -### Actual behavior - - - -### Steps to reproduce the bug - - - -1. ... -2. ... -3. ... - -### Package versions - - - -* Python: `python --version` -* MkDocs: `mkdocs --version` -* Material: `pip show mkdocs-material | grep -E ^Version` - -### Project configuration - - - -``` yaml -The contents of your mkdocs.yml -``` - -### System information - - - -* OS: ... -* Browser: ... - - [1]: https://github.com/squidfunk/mkdocs-material/blob/master/CONTRIBUTING.md diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml new file mode 100644 index 000000000..a4dfdf5ab --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug.yml @@ -0,0 +1,95 @@ +name: Bug Report +description: Report a bug +body: +- type: markdown + attributes: + value: |- + ### ⚠️ WARNING + + Half of all issues created do not contain enough to help or are not appropriate for the issue tracker (i.e. one-line questions). + If you think you found a bug, follow the steps outlined below closely. + Any issue that does not meet these conditions may be closed unnoticed. + + Why? Because the maintainers of this project are wasting a lot of time answering questions that are not directly related to this project. + If you have a question, please ask your question over in [Discussions](https://github.com/squidfunk/mkdocs-material/discussions), so other users can help you work towards a solution. +- type: checkboxes + attributes: + label: Read and understand the Contributing guidelines + description: You need to have read the contributing guidelines in order to proceed. + options: + - label: I've read the [contribution Guidelines](https://github.com/squidfunk/mkdocs-material/blob/master/CONTRIBUTING.md) and agree with them + required: true +- type: checkboxes + attributes: + label: I've found a bug and checked that ... + description: Make sure that your request fulfills ALL of the following requirements. If one requirement cannot be satisfied, please explain in detail why. + options: + - label: ... the problem doesn't occur with the default MkDocs template + - label: ... the problem is not in any of my customizations (CSS, JS, template) + - label: ... the documentation does not mention anything about my problem + - label: ... there are no open or closed issues that are related to my problem. +- type: textarea + attributes: + label: Description + description: Please provide a breif description of the bug. + placeholder: Material for MkDocs does ... + validations: + required: true +- type: textarea + attributes: + label: Expected behaviour + description: Please describe what you expect to happen. + placeholder: Material for MkDocs should... + validations: + required: true +- type: textarea + attributes: + label: Actual Behaviour + description: Please describe what is actually happening. + placeholder: Material for MkDocs instead does ... + validations: + required: true +- type: textarea + attributes: + label: Steps to reproduce + description: Please provide the steps to reproduce the issue. + placeholder: |- + 1. ... + 2. ... + 3. ... + validations: + required: true +- type: textarea + attributes: + label: Package versions + description: |- + Please provide all required package versions. + + - For Python, run `python --version` + - For MkDocs, run `mkdocs --version` + - For Material for MkDocs, run `pip show mkdocs-material | grep -E ^Version` + value: |- + - Python: `` + - MkDocs: `` + - Material: `` + validations: + required: true +- type: textarea + attributes: + label: Configuration + description: Please provide your mkdocs.yml to a reasonable amount of detail. + placeholder: |- + site_name: My Docs + site_url: https://example.com/docs + render: yaml + validations: + required: true +- type: textarea + attributes: + label: System information + description: Please provide your operating system and browser type and version. + value: |- + - OS: `` + - Browser: `` + validations: + required: true diff --git a/.github/ISSUE_TEMPLATE/feature.md b/.github/ISSUE_TEMPLATE/feature.md deleted file mode 100644 index 98a6908e5..000000000 --- a/.github/ISSUE_TEMPLATE/feature.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -name: Feature -about: Suggest an idea -title: '' -assignees: '' ---- - - - -- [ ] I've read the [contribution guidelines][1] and agree with them - -__I want to suggest an idea and checked that ...__ - -- [ ] ... to my best knowledge, my idea wouldn't break something for other users -- [ ] ... the documentation does not mention anything about my idea -- [ ] ... there are no open or closed issues that are related to my idea - -## Description - - - -### Use Cases - - - -### Screenshots / Mockups - - - - [1]: https://github.com/squidfunk/mkdocs-material/blob/master/CONTRIBUTING.md diff --git a/.github/ISSUE_TEMPLATE/feature.yml b/.github/ISSUE_TEMPLATE/feature.yml new file mode 100644 index 000000000..0bc115647 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature.yml @@ -0,0 +1,48 @@ +name: Feature +description: Suggest an idea +body: +- type: markdown + attributes: + value: |- + ### ⚠️ WARNING + + Half of all issues created do not contain enough to help or are not appropriate for the issue tracker (i.e. one-line questions). + If you would like to suggest a feature, follow the steps outlined below closely. + Any issue that does not meet these conditions may be closed unnoticed. + + Why? Because the maintainers of this project are wasting a lot of time answering questions that are not directly related to this project. + If you have a question, please ask your question over in [Discussions](https://github.com/squidfunk/mkdocs-material/discussions), so other users can help you work towards a solution. +- type: checkboxes + attributes: + label: Read and understand the Contributing guidelines + description: You need to have read the contributing guidelines in order to proceed. + options: + - label: I've read the [contribution Guidelines](https://github.com/squidfunk/mkdocs-material/blob/master/CONTRIBUTING.md) and agree with them + required: true +- type: checkboxes + attributes: + label: I want to suggest an idea and checked that ... + description: Make sure that your request fulfills ALL of the following requirements. If one requirement cannot be satisfied, please explain in detail why. + options: + - label: ... to my best knowledge, my idea wouldn't break something for other users + - label: ... the documentation does not mention anything about my idea + - label: ... there are no open or closed issues that are related to my idea +- type: textarea + attributes: + label: Description + description: Please provide a breif description of the bug. + placeholder: My feature would ... + validations: + required: true +- type: textarea + attributes: + label: Use Cases + description: Please describe how your suggestion would benefit you and other users. + placeholder: My feature is beneficial because ... + validations: + required: true +- type: textarea + attributes: + label: Screenshots / Mockups + description: If applicable, provide some mockups or screenshots. + placeholder: "https://i.imgur.com/cat.jpg" diff --git a/.github/ISSUE_TEMPLATE/translate.md b/.github/ISSUE_TEMPLATE/translate.md deleted file mode 100644 index e7a0040d4..000000000 --- a/.github/ISSUE_TEMPLATE/translate.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -name: Translate -about: 'Help translate Material into more languages ' -title: 'New translation: {Insert language}' -labels: enhancement -assignees: '' ---- - -## Instructions - -1. Check, if your language is already available: [here](https://bit.ly/33vFDD0) -2. If it isn't, please translate the labels on the right: - -``` jinja -{% macro t(key) %}{{ { - "language": "en", - "direction": "ltr", - "clipboard.copy": "Copy to clipboard", - "clipboard.copied": "Copied to clipboard", - "edit.link.title": "Edit this page", - "footer.previous": "Previous", - "footer.next": "Next", - "footer.title": "Footer", - "header.title": "Header", - "meta.comments": "Comments", - "meta.source": "Source", - "nav.title": "Navigation", - "search.config.lang": "en", - "search.config.pipeline": "trimmer, stopWordFilter", - "search.config.separator": "[\s\-]+", - "search.placeholder": "Search", - "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.title": "Select language", - "select.version.title": "Select version", - "skip.link.title": "Skip to content", - "source.link.title": "Go to repository", - "source.file.date.updated": "Last update", - "source.file.date.created": "Created", - "tabs.title": "Tabs", - "toc.title": "Table of contents", - "top.title": "Back to top" -}[key] }}{% endmacro %} -``` - - diff --git a/.github/ISSUE_TEMPLATE/translate.yml b/.github/ISSUE_TEMPLATE/translate.yml new file mode 100644 index 000000000..93ce7c133 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/translate.yml @@ -0,0 +1,64 @@ +name: Translate +description: 'Help translate Material into more languages' +title: 'New translation: {Insert language}' +labels: [enhancement] +body: +- type: markdown + attributes: + value: |- + ## Instructions + + 1. Check, if your language is already available: [here](https://bit.ly/33vFDD0) + 2. If it isn't, please translate the labels on the right: + + ```jinja + {% macro t(key) %}{{ { + "language": "en", + "direction": "ltr", + "clipboard.copy": "Copy to clipboard", + "clipboard.copied": "Copied to clipboard", + "edit.link.title": "Edit this page", + "footer.previous": "Previous", + "footer.next": "Next", + "footer.title": "Footer", + "header.title": "Header", + "meta.comments": "Comments", + "meta.source": "Source", + "nav.title": "Navigation", + "search.config.lang": "en", + "search.config.pipeline": "trimmer, stopWordFilter", + "search.config.separator": "[\s\-]+", + "search.placeholder": "Search", + "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.title": "Select language", + "select.version.title": "Select version", + "skip.link.title": "Skip to content", + "source.link.title": "Go to repository", + "source.file.date.updated": "Last update", + "source.file.date.created": "Created", + "tabs.title": "Tabs", + "toc.title": "Table of contents", + "top.title": "Back to top" + }[key] }}{% endmacro %} + ``` +- type: textarea + attributes: + label: Translation + description: Put your translated file here. The text is automatically formatted as Jinja code + placeholder: |- + {% macro t(key) %}{{ { + "language": "en", + "direction": "ltr", + ... + }[key] }}{% endmacro %} + render: jinja + validations: + required: true