free-programming-books/docs
David Ordás 84438cb1df
docs(contributing): Homogenize format across translated files (#6625)
* docs(contributing): remove trailing spaces

* docs(contributing): Apply headings `2-1` empty lines lint rule

* docs(contributing): Apply headings `2-1` empty lines lint rule

forgotten in previous commit: e83220aa4c

* docs(contributing): Move anchor alias to inside list items

... there where an anchor alias `<a name="...">` is used near to each of those list items

This solves markdownlint `MD032/blanks-around-lists` issue

* docs(contributing): Homogenize `1` blank line in nutshell enumeration

* docs(contributing): Homogenize `1` blank line inside Formatting section

* docs(contributing): Ensure `4-spaces` indent `.editorconfig` param

* docs(contributing): Homogenize format & indent of code blocks

- Format using fenced style.
- Well indent in those placed inside list enumerations.
- Simulate `Good` - `Bad` monospace double colon indent inside each one.

- Examples highlighting as `text-plain`. The `md, markdown` style doesn't work very well since blocks has mixed syntax.
- `check_urls` code block highlighted as `properties` style (key-value pair).

Solves markdownlint rules:
- MD040/fenced-code-language: Fenced code blocks should have a language specified
- MD046/code-block-style: Code block style [Expected: indented; Actual: fenced]

* docs(contributing): Ensure `4-spaces` indent `.editorconfig` param

Forgotten in commit: 31c776cb52

* docs(contributing): Homogenize format & indent of code blocks

- Simulate `Good` - `Bad` monospace double colon indent inside each one.

Revert commit f9dc719aef only in this file after check non-needs in a deployed web snapshot

* docs(contributing): Use "consistent" unordered list mark

Solves markdownlint rules:
MD004/ul-style: Unordered list style "consistent"

* docs(contributing): Solve `no-space-in-*` lint rules

markdownlint rules:
MD037/no-space-in-emphasis: Spaces inside emphasis
MD038/no-space-in-code: Spaces inside code span elements
MD039/no-space-in-links: Spaces inside link text

* docs(contributing): Move some punctuation just before any closing brackets after it

* docs(contributing): Hack highlight IDE/Editors headings+HTML

It apply the hack to highlight in IDE/Editors those headings with an anchor alias just before itself

* docs(contributing): Homogenize Pull Request acronym

* docs(contributing): Fix `GitHub` trademark typos

* docs(contributing): ALLCAPS

* docs(contributing): Git trademark

* docs(contributing): YouTube trademark

* docs(contributing): ISBN acronym

* fix: flag emoji code `en` > `us`

Resolves d775cb34fb (commitcomment-59537594)

#5831: `:en:` emoji flag markup doesn't work. Use `🇺🇸` 🇺🇸 or `🇬🇧` 🇬🇧

d775cb34fb (diff-b35eb40c148657d4ea1361c44496e11c5625f484a4c6040c022770e88cbcfdccR8-R10)

* docs(contributing): Fix fa_IR broken anchors

* docs(contributing): filenames in monospace font

* docs(contributing): Homogenize `check_urls=file_to_check`

* docs(contributing): literals/markup texts in monospace font

- `et al.`
- File extensions `.md`
- Protocols: `http`, `https`...
- Notes: LeanPub, require email, StackOverflow, in process, archived

trailing dots in that lines

* docs(contributing): linkify wayback machine

* docs(contributing): Fix `Leanpub` trademark typos

* chore: Rename `master` to `main` #blacklivesmatter

Resolves EbookFoundation/free-programming-books#5803

* docs(contributing): fix broken ref link to `programming-playgrounds`

Fix over EbookFoundation/free-programming-books#5449 and commit 3c42c3629e

(cherry picked from commit 59ebfe3f97e318fa43d58877cbc5bfdd8b0c7426)

* docs(contributing): fix repo urls on initial FR translation

- `ElivreFoundation` -> `EbookFoundation`
- `free-programming-livres` ->`free-programming-books`

PR: #5554
Commit: e629db6b05

Affected lines: 
- 18bb745c90 (diff-d6fa57ebb070f7f05f8c686a2fe92110652f48886774460ffee08d4be4cd5f27R4) // e629db6b05 (diff-d6fa57ebb070f7f05f8c686a2fe92110652f48886774460ffee08d4be4cd5f27R4)
- 18bb745c90 (diff-d6fa57ebb070f7f05f8c686a2fe92110652f48886774460ffee08d4be4cd5f27R7) // e629db6b05 (diff-d6fa57ebb070f7f05f8c686a2fe92110652f48886774460ffee08d4be4cd5f27R7)
- 18bb745c90 (diff-d6fa57ebb070f7f05f8c686a2fe92110652f48886774460ffee08d4be4cd5f27R13) // e629db6b05 (diff-d6fa57ebb070f7f05f8c686a2fe92110652f48886774460ffee08d4be4cd5f27R13)
- 18bb745c90 (diff-d6fa57ebb070f7f05f8c686a2fe92110652f48886774460ffee08d4be4cd5f27R45) // e629db6b05 (diff-d6fa57ebb070f7f05f8c686a2fe92110652f48886774460ffee08d4be4cd5f27R45)

* docs(contributing): use relative urls EN

Via #6614

* docs(contributing): greek. place translations link in right place

Via #6614

* Merge EbookFoundation/free-programming-books#6631 upstream/main commit into docs/contributing/sync/1

* Add repo badges (see EbookFoundation/free-programming-books#5983)

(cherry picked from a16a79b12d solving merge conflict)

* Merge EbookFoundation/free-programming-books#6662 upstream/main commit into docs/contributing/sync/1

* Apply centering proposed at #5983 but not implemented in #6631

(cherry picked from commit f36fd03c06)

* format(contributing): Bold 5th nutshell equal zh

* Merge #6677 upstream/main commit into docs/contributing/sync/1

fix(docs): Use Kramdown processor (#6677)
* Update _config.yml
* add markdown="1"
* update url
* complete removing spaces?
* explicitly use kramdown

(cherry picked from commit de2f31976f)
2022-02-02 20:39:27 -05:00
..
CODE_OF_CONDUCT-bs.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CODE_OF_CONDUCT-de.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CODE_OF_CONDUCT-el.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CODE_OF_CONDUCT-es.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CODE_OF_CONDUCT-fa_IR.md fix(docs): Use Kramdown processor (#6677) 2022-01-31 11:58:31 -05:00
CODE_OF_CONDUCT-fil.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CODE_OF_CONDUCT-fr.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CODE_OF_CONDUCT-hi.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CODE_OF_CONDUCT-id.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CODE_OF_CONDUCT-it.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CODE_OF_CONDUCT-ko.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CODE_OF_CONDUCT-pl.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CODE_OF_CONDUCT-pt_BR.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CODE_OF_CONDUCT-ru.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CODE_OF_CONDUCT-uk.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CODE_OF_CONDUCT.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
CONTRIBUTING-de.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
CONTRIBUTING-el.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
CONTRIBUTING-es.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
CONTRIBUTING-fa_IR.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
CONTRIBUTING-fil.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
CONTRIBUTING-fr.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
CONTRIBUTING-id.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
CONTRIBUTING-it.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
CONTRIBUTING-ko.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
CONTRIBUTING-pt_BR.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
CONTRIBUTING-ru.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
CONTRIBUTING-vi.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
CONTRIBUTING-zh_TW.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
CONTRIBUTING-zh.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
CONTRIBUTING.md docs(contributing): Homogenize format across translated files (#6625) 2022-02-02 20:39:27 -05:00
HOWTO-ar.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-bn.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-bs.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-de.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-el.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-es.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-fa_IR.md fix(docs): Use Kramdown processor (#6677) 2022-01-31 11:58:31 -05:00
HOWTO-fil.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-fr.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-hi.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-id.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-it.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-km.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-ko.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-nl.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-pl.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-pt_BR.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-ru.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-sl.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-sv.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-th.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-tr.md chore: complete review of #6567 HOWTO in Turkish (#6618) 2021-11-23 09:25:37 -05:00
HOWTO-uk.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-vi.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-zh_TW.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO-zh.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00
HOWTO.md move the translated documentation files to a docs folder (#6614) 2021-11-20 13:25:15 -05:00