free-programming-books

Commit Graph

Author	SHA1	Message	Date
David Ordás	e091eeedf0	docs(CONTRIBUTING): complete creators guidelines with relator terms (#7102 ) * complete creators guidelines with relator terms * Update CONTRIBUTING.md minor language editing * Update CONTRIBUTING.md recover missing MARC relators URL to complete empty link * chore: copy ENG missing texts to translated files * chore: translate new texts to spanish * chore: translate new text to italian Co-authored-by: ImVector <59611597+LuigiImVector@users.noreply.github.com> Co-authored-by: Eric Hellman <eric@hellman.net> Co-authored-by: ImVector <59611597+LuigiImVector@users.noreply.github.com>	2 years ago
David Ordás	97022b79cd	chore(docs): Apply #6822 (playground definition) to the rest of CONTRIBUTING files (#6824 ) * Added playground definition Added a small definition about programming/coding playgrounds for making it understandable to beginners * Define what is a playground Via / completes: - What's a programming playground? #6107 - Added playground definition #6817 - Sentence added under playground #6819 Thanks @Suman373 for the initial idea. Co-authored-by: Suman Roy <95040233+Suman373@users.noreply.github.com> * reword playground definition as suggested Co-authored-by: Eric Hellman <eric@hellman.net> * copy #6822 playground definition into rest files * translate #6822 (playground definition) to spanish * translate #6822 (playground definition) to italian Co-authored-by: ImVector <59611597+LuigiImVector@users.noreply.github.com> * translate #6822 (playground definition) to french Thanks to @Existential-nonce Co-authored-by: nonce <77142078+Existential-nonce@users.noreply.github.com> * translate EbookFoundation#6822 (playground definition) to chinese Provided by @kang8. Thank you too much! Co-authored-by: kang <1115610574@qq.com> * Improve playground definition in `zh_TW` language Co-authored-by: Alan Syue <33183531+AlanSyue@users.noreply.github.com> * Minor improve playground definition in `fr` language Co-authored-by: lorrding <mathias.berthonneau@gmail.com> Co-authored-by: Suman Roy <95040233+Suman373@users.noreply.github.com> Co-authored-by: Eric Hellman <eric@hellman.net> Co-authored-by: ImVector <59611597+LuigiImVector@users.noreply.github.com> Co-authored-by: nonce <77142078+Existential-nonce@users.noreply.github.com> Co-authored-by: kang <1115610574@qq.com> Co-authored-by: Alan Syue <33183531+AlanSyue@users.noreply.github.com> Co-authored-by: lorrding <mathias.berthonneau@gmail.com>	2 years ago
ImVector	a75cf7641f	docs(CONTRIBUTING): Apply #6878 to the rest of the CONTRIBUTING files (#6890 ) * docs(CONTRIBUTING): Apply #6878 to the rest of the CONTRIBUTING files * Update docs/CONTRIBUTING-es.md Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * Update docs/CONTRIBUTING-es.md Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * Update docs/CONTRIBUTING-es.md Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * Update docs/CONTRIBUTING-es.md Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * doc: translate to zh_TW version * fix: add the link anchor * translate the changes to the de version * Update docs/CONTRIBUTING-fr.md Co-authored-by: lorrding <mathias.berthonneau@gmail.com> * Update docs/CONTRIBUTING-fr.md Co-authored-by: lorrding <mathias.berthonneau@gmail.com> * Update docs/CONTRIBUTING-fr.md Co-authored-by: lorrding <mathias.berthonneau@gmail.com> * Update CONTRIBUTING-fa_IR.md * Fix the wrong link Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> Co-authored-by: alansyue <b123105@gmail.com> Co-authored-by: Oliver Matla <info@lupinitylabs.com> Co-authored-by: lorrding <mathias.berthonneau@gmail.com> Co-authored-by: Amirhossein Mojiri Foroushani <amojiry@gmail.com>	2 years ago
David Ordás	47bc198769	docs(contributing): Merge #5816 with #5752 Indonesian translation (#6719 ) * Merge #5752 Indonesian CONTRIBUTING translation Vía EbookFoundation/free-programming-books#6590 Vía EbookFoundation/free-programming-books#5762 Recovered from PR EbookFoundation/free-programming-books#5752 requested by @reskimulud Co-authored-by: Reski Mulud Muchamad <63949402+reski-mulud-muchamad@users.noreply.github.com> * 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] * Homogenize `check_urls=file_to_check` * use "consistent" unordered list mark and ensure 4-spaces indent .editorconfig param Solves markdownlint rules: MD004/ul-style: Unordered list style "consistent" * Move some punctuation just before any closing brackets after it * Apply headings `2-1` empty lines lint rule * Move anchor alias to inside list items there where an anchor alias `<a name="...">` is used near to each of those list items * fix missing anchor aliases specially ones about Guidelines and Formatting * Hack highlight IDE/Editors headings+HTML It apply the hack to highlight in IDE/Editors those headings with an anchor alias just before itself * Homogenize Pull Request acronym * YouTube trademark typos * filenames in monospace font * 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 * Fix #6721 in CONTRIBUTING-id.md Co-authored-by: ImVector <59611597+LuigiImVector@users.noreply.github.com> * HTML5 anchors compilant `<a name=`>`<a id=` Co-authored-by: Reski Mulud Muchamad <63949402+reski-mulud-muchamad@users.noreply.github.com> Co-authored-by: ImVector <59611597+LuigiImVector@users.noreply.github.com>	3 years ago
David Ordás	7a8349abfe	feat: Add `docs/readme.md` + update crosslinks (#6700 ) * complete translate list with the new languages appeared since hacktoberfest * Create docs/README.md with the translations section using root README.md as source. Links are adapted to this folder Address EbookFoundation/free-programming-books#6698 * fix remaining url + translation items - Portuguese (Portugal) - Slovak / slovenčina - Slovenian / slovenščina Address EbookFoundation/free-programming-books#6698 * fix remaining url + translation items - Portuguese (Portugal) - Slovak / slovenčina - Slovenian / slovenščina Address EbookFoundation/free-programming-books#6698 * Add inclusiveness `dare to translate...` paragraph * Add inclusiveness `dare to translate...` paragraph * Move translations link target url to docs * move translation links `bs` * move translations link `en` * move translations crosslink `es` * move translations crosslink `fr` * move translations crosslink `de` * move translations crosslink `el` * move translations crosslink `fa_IR` * move translations crosslink `fil` * move translations crosslink `it` * move translations crosslink `pt_BR` * move translations crosslink `ko` * move translations crosslink `ru` * move translations crosslink `id` * move translations crosslink `zh` * move translations crosslink `hi` * move translations crosslink `pl` * move translations crosslink `uk` * move translations crosslink `vi` * move translations crosslink remaining `HOW-To's` * revert feature moved to #6688 * Remove the list from the top level. Leave `en` links * use `previous languages` in root README * Add more languages lists in root `readme.md` * fix typo * fix typo * Update docs/README.md after translations paragraph Less text is more Co-authored-by: Eric Hellman <eric@hellman.net> * Update README.md after translations paragraph Less text is more Co-authored-by: Eric Hellman <eric@hellman.net> * Update README.md preface translations paragraph Co-authored-by: Eric Hellman <eric@hellman.net> * fix CONTRIBUTING target url commited at `fd2b39151c` * Update docs/README.md preface translations paragraph Co-authored-by: Eric Hellman <eric@hellman.net> * read me! said the boss ^^, less text is more. Co-authored-by: Eric Hellman <eric@hellman.net> * remove "The inclusiveness is one of our targets, so " Co-authored-by: Eric Hellman <eric@hellman.net>	3 years ago
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`)	3 years ago
Eric Hellman	868d94730a	move the translated documentation files to a docs folder (#6614 ) * new branch for misc cleanup * add item to resolve #6319 * fix grammar * re-collate * centralize all the translation links * one more * fix link * localize labels * move files * fix links * indent in arabic Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * typos Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * remove Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * translation Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * translation Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * mixed markdown Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * period Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * missing * Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * Update docs/HOWTO-pl.md Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * Update docs/HOWTO-th.md Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * translated Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * translate Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * lower case Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * typo Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * wording Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * translations link Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * space Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * space Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * typo Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * fix link Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * fix link Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * Update CONTRIBUTING-de.md * space Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * fix link Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * fix link Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * parens not brackets * fix link Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * fix link Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * add #6619 * chore: resolve dead code CONTRIB-es Addressed at https://github.com/EbookFoundation/free-programming-books/pull/6614#commitcomment-60517997 Review suggestion: https://github.com/EbookFoundation/free-programming-books/pull/6614#discussion_r751697277 * chore: use spanish translated text for "translations" Review suggestion: https://github.com/EbookFoundation/free-programming-books/pull/6614#discussion_r751697277 * chore: DRY. Use markdown link refs as translations target Review suggestion: https://github.com/EbookFoundation/free-programming-books/pull/6614#discussion_r751697277 * fix: revert removed parens in previous commit `6276a21d85` Review suggestion: https://github.com/EbookFoundation/free-programming-books/pull/6614#discussion_r751697277 * fix link Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * lint Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * fix link Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * lint Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * lint Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * fix link Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * lint Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * fix link Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * fix link Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * space Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> * translate Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com> Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>	3 years ago
Wonjang Son	29b14ac088	Added links to korean docs (#5837 ) * Implemented code of conduct korean translation * Implemented CONTRIBUTING korean translation * Implemented HOWTO korean translation * Added English link * Reverted MD syntax formatting * Revert MD syntax * Added HOWTO-kr links * Fixed new line & anchors * Fixed CoC * chore(docs): fix all annoying markdown problems Finish review EbookFoundation/free-programming-books#5837 * chore(docs): fix all annoying markdown problems Finish review EbookFoundation/free-programming-books#5837 * Removed duplicated korean translation * Revert bad md formatting * Fixed inconsistencies * Fixed indentation * Added missing korean links Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>	3 years ago
Ricardo Hideki Hangai Kojo	a18d9b012a	add CONTRIBUTING pt-BR (#6031 ) * add reference to pt-BR on all CONTRIBUTING files Signed-off-by: Ricardo H H Kojo <ricardokojo7@gmail.com> * add CONTRIBUTING-pt_BR.md Signed-off-by: Ricardo H H Kojo <ricardo.kojo.dev@gmail.com>	3 years ago
CakKhoiron	f67b8e080f	Fixing format CONTRIBUTING-id.md (#5898 ) Enhance format CONTRIBUTING-id.md for more readable according to Git format	3 years ago
Muhammad Alif Nurfauzi	b18ff0304c	Create CONTRIBUTING-id.md (#5816 ) Contibuting on Indonesian language	3 years ago

7 Commits (110c549fc8d0514841e379dfbb2c71aab725d6ca)