diff --git a/.markdownlint.jsonc b/.markdownlint.jsonc new file mode 100644 index 000000000..fc58fe464 --- /dev/null +++ b/.markdownlint.jsonc @@ -0,0 +1,286 @@ +// +// markdownlint config file. +// +// Each rule parameters are setted according to FBP-lint and EditorConfig values +// + +/** To override them in a some file... + + +**/ + +{ + // Default state for all rules + "default": false, + + // MD001/heading-increment/header-increment - Heading levels should only increment by one level at a time + "MD001": true, + + // MD002/first-heading-h1/first-header-h1 - First heading should be a top-level heading + "MD002": { + // Heading level + "level": 1 + }, + + // MD003/heading-style/header-style - Heading style + // (sync with .fpb) + "MD003": { + // Heading style + "style": "atx" + }, + + // MD004/ul-style - Unordered list style + // (sync with .fpb) + "MD004": { + // List style + "style": "asterisk" + }, + + // MD005/list-indent - Inconsistent indentation for list items at the same level + "MD005": true, + + // MD006/ul-start-left - Consider starting bulleted lists at the beginning of the line + "MD006": true, + + // MD007/ul-indent - Unordered list indentation + "MD007": { + // Spaces for indent (sync with .editorconfig) + "indent": 4, + // Whether to indent the first level of the list + "start_indented": false + }, + + // MD009/no-trailing-spaces - Trailing spaces + "MD009": { + // Spaces for line break (sync with .editorconfig) + "br_spaces": 4, + // Allow spaces for empty lines in list items + "list_item_empty_lines": false, + // Include unnecessary breaks + "strict": false + }, + + // MD010/no-hard-tabs - Hard tabs + "MD010": { + // Include code blocks + "code_blocks": true, + // Number of spaces for each hard tab + "spaces_per_tab": 4 + }, + + // MD011/no-reversed-links - Reversed link syntax + "MD011": true, + + // MD012/no-multiple-blanks - Multiple consecutive blank lines + // (sync with fpb) + "MD012": { + // Consecutive blank lines + "maximum": 2 + }, + + // MD014/commands-show-output - Dollar signs used before commands without showing output + "MD014": true, + + // MD018/no-missing-space-atx - No space after hash on atx style heading + "MD018": true, + + // MD019/no-multiple-space-atx - Multiple spaces after hash on atx style heading + "MD019": true, + + // MD020/no-missing-space-closed-atx - No space inside hashes on closed atx style heading + "MD020": true, + + // MD021/no-multiple-space-closed-atx - Multiple spaces inside hashes on closed atx style heading + "MD021": true, + + // MD022/blanks-around-headings/blanks-around-headers - Headings should be surrounded by blank lines + // (sync with fpb) + "MD022": { + // Blank lines above heading + "lines_above": 2, + // Blank lines below heading + "lines_below": 1 + }, + + // MD023/heading-start-left/header-start-left - Headings must start at the beginning of the line + // (sync with fpb) + "MD023": true, + + // MD024/no-duplicate-heading/no-duplicate-header - Multiple headings with the same content + // (sync with fpb) + "MD024": { + // Only check sibling headings + "allow_different_nesting": false, + // Only check sibling headings + "siblings_only": false + }, + + // MD025/single-title/single-h1 - Multiple top-level headings in the same document + // (sync with fpb) + "MD025": { + // Heading level + "level": 1, + // RegExp for matching title in front matter + "front_matter_title": "^\\s*title\\s*[:=]" + }, + + // MD026/no-trailing-punctuation - Trailing punctuation in heading + "MD026": { + // Punctuation characters + "punctuation": ".,;:!。,;:!" + }, + + // MD027/no-multiple-space-blockquote - Multiple spaces after blockquote symbol + "MD027": true, + + // MD028/no-blanks-blockquote - Blank line inside blockquote + "MD028": true, + + // MD029/ol-prefix - Ordered list item prefix + "MD029": { + // List style + "style": "one_or_ordered" + }, + + // MD030/list-marker-space - Spaces after list markers + "MD030": { + // Spaces for single-line unordered list items + "ul_single": 1, + // Spaces for single-line ordered list items + "ol_single": 1, + // Spaces for multi-line unordered list items + "ul_multi": 1, + // Spaces for multi-line ordered list items + "ol_multi": 1 + }, + + // MD031/blanks-around-fences - Fenced code blocks should be surrounded by blank lines + "MD031": { + // Include list items + "list_items": true + }, + + // MD032/blanks-around-lists - Lists should be surrounded by blank lines + "MD032": true, + + // MD033/no-inline-html - Inline HTML + "MD033": { + // Allowed elements + "allowed_elements": [ + // for anchor alias + "a", + // for abbreviations (and acronyms) + "abbr", + // for RTL or aligned blocks + "div", + // for coloring + "span", + // for collapsed blocks + "details", + "summary" + ] + }, + + // MD037/no-space-in-emphasis - Spaces inside emphasis markers + "MD037": true, + + // MD038/no-space-in-code - Spaces inside code span elements + "MD038": true, + + // MD039/no-space-in-links - Spaces inside link text + "MD039": true, + + // MD040/fenced-code-language - Fenced code blocks should have a language specified + "MD040": true, + + // MD041/first-line-heading/first-line-h1 - First line in a file should be a top-level heading + "MD041": { + // Heading level + "level": 1, + // RegExp for matching title in front matter + "front_matter_title": "^\\s*title\\s*[:=]" + }, + + // MD042/no-empty-links - No empty links + "MD042": true, + + // MD043/required-headings/required-headers - Required heading structure + "MD043": { + // List of headings. Array of string | null + "headings": null, + // List of headers. Array of string | null + "headers": null + }, + + // MD044/proper-names - Proper names should have the correct capitalization + "MD044": { + // List of proper names + "names": [ + ".github", + ".gitlab", + ".markdown", + ".mega", + ".html", + ".css", + ".sass", + ".html", + ".json", + ".yaml", + "align=", + "dir=", + "markdown=", + "próximo", + "GitHub", + "GitLab", + "Bitbucket", + "Pull Request", + "PRÓXIMO", + "PR", + "Google", + "Google Drive", + "YouTube", + "Dropbox", + "Mega", + "Scribd", + "Issuu", + "Leanpub", + "StackOverflow", + "Markdown", + "HTML", + "CSS", + "Sass", + "JavaScript", + "JSON", + "YAML" + ], + // Include code blocks + "code_blocks": true + }, + + // MD046/code-block-style - Code block style + "MD046": { + // Block style + "style": "fenced" + }, + + // MD047/single-trailing-newline - Files should end with a single newline character + // (sync with fpb & .editorconfig) + "MD047": true, + + // MD048/code-fence-style - Code fence style + "MD048": { + // Code fence style + "style": "backtick" + } +} diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 000000000..1074a7e7b --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,46 @@ +{ + "files.insertFinalNewline": true, + "files.trimFinalNewlines": true, + "markdown.extension.list.indentationSize": "inherit", + "markdown.extension.orderedList.autoRenumber": true, + "markdown.extension.orderedList.marker": "ordered", + "markdown.extension.syntax.decorations": true, + "markdown.extension.tableFormatter.enabled": true, + "markdown.extension.toc.downcaseLink": true, + "markdown.extension.toc.levels": "1..4", + "markdown.extension.toc.omittedFromToc": { + "**": ["# Index", "## Index", "### Index"] + }, + "markdown.extension.toc.plaintext": false, + "markdown.extension.toc.orderedList": false, + "markdown.extension.toc.slugifyMode": "github", + "markdown.extension.toc.unorderedList.marker": "*", + "markdown.extension.toc.updateOnSave": false, + "markdown-checkboxes.enable": true, + "markdown-checkboxes.label": true, + "markdown-pdf.highlightStyle": "github.css", + "markdown-pdf.includeDefaultStyles": true, + "markdown-preview-enhanced.breakOnSingleNewLine": true, + "markdown-preview-enhanced.codeBlockTheme": "github.css", + "markdown-preview-enhanced.enableEmojiSyntax": true, + "markdown-preview-enhanced.enableLinkify": true, + "markdown-preview-enhanced.enableScriptExecution": false, + "markdown-preview-enhanced.enableWikiLinkSyntax": true, + "markdown-preview-enhanced.mathRenderingOnlineService": "https://latex.codecogs.com/svg.latex", + "markdown-preview-enhanced.mathRenderingOption": "KaTeX", + "markdown-preview-enhanced.previewTheme": "github-light.css", + "markdown-preview-enhanced.scrollSync": true, + "markdown-preview-enhanced.singlePreview": true, + "markdown-preview-enhanced.useGitHubStylePipedLink": true, + "markdownShortcuts.bold.marker": "**", + "markdownShortcuts.bullets.marker": "*", + "markdownShortcuts.italics.marker": "*", + "github.preferedMergeMethod": "squash", + "githubIssues.issueBranchTitle": "${user}/${issueNumber}/${sanitizedIssueTitle}", + "githubIssues.useBranchForIssues": "on", + "githubPullRequests.defaultMergeMethod": "squash", + "githubIssues.workingIssueFormatScm": "${issueTitle}\n\nPatch over commit: ${sha}\nFixes #${issueNumber}\nCo-authored-by: octocat ", + "prettier.enable": false, + "prettier.requirePragma": true, + "prettier.useEditorConfig": true +}