From 232974e331018da4f467a38558b1810b3fd6b7e6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jan=20Havr=C3=A1nek?= Date: Tue, 22 Aug 2017 20:56:22 +0200 Subject: [PATCH] Translate version 1.0.0 to Czech --- source/cs/1.0.0/index.html.haml | 268 ++++++++++++++++---------------- 1 file changed, 131 insertions(+), 137 deletions(-) diff --git a/source/cs/1.0.0/index.html.haml b/source/cs/1.0.0/index.html.haml index 3632429..8b3d999 100644 --- a/source/cs/1.0.0/index.html.haml +++ b/source/cs/1.0.0/index.html.haml @@ -1,7 +1,7 @@ --- -description: Keep a Changelog -title: Keep a Changelog -language: en +description: Udržuj Changelog +title: Udržuj Changelog +language: cs version: 1.0.0 --- @@ -18,11 +18,11 @@ version: 1.0.0 .header .title - %h1 Keep a Changelog - %h2 Don’t let your friends dump git logs into changelogs. + %h1 Udržuj Changelog + %h2 Nenech své kamarády sypat git logy do changelogů. = link_to changelog do - Version + Verze %strong= current_page.metadata[:page][:version] %pre.changelog= File.read("CHANGELOG.md") @@ -30,285 +30,279 @@ version: 1.0.0 .answers %h3#what %a.anchor{ href: "#what", aria_hidden: "true" } - What is a changelog? + Co je to changelog? %p - A changelog is a file which contains a curated, chronologically - ordered list of notable changes for each version of a project. + Changelog je soubor, který obsahuje organizovaný, chronologicky seřazený + seznam podstatných změn pro každou verzi daného projektu. %h3#why %a.anchor{ href: "#why", aria_hidden: "true" } - Why keep a changelog? + Proč udržovat changelog? %p - To make it easier for users and contributors to see precisely what - notable changes have been made between each release (or version) of - the project. + Aby uživatelé a přispěvatelé přesně věděli, jaké podstatné změny byly + provedeny mezi jednotlivými vydáními (verzemi) daného projektu. %h3#who %a.anchor{ href: "#who", aria_hidden: "true" } - Who needs a changelog? + Kdo potřebuje changelog? %p - People do. Whether consumers or developers, the end users of - software are human beings who care about what's in the software. When - the software changes, people want to know why and how. + Lidé. Ať už se jedná o spotřebitele nebo vývojáře, koncoví uživatelé + softwaru jsou lidská stvoření, kterým záleží na tom, co software obsahuje. + Když se daný software změní, lidé chtějí vědět proč a jak. .good-practices %h3#how %a.anchor{ href: "#how", aria_hidden: "true" } - How do I make a good changelog? + Jak vytvořit dobrý changelog? %h4#principles %a.anchor{ href: "#principles", aria_hidden: "true" } - Guiding Principles + Hlavní zásady %ul %li - Changelogs are for humans, not machines. + Changelogy jsou pro lidi, ne pro stroje. %li - There should be an entry for every single version. + Changelog by měl obsahovat záznam pro každou verzi. %li - The same types of changes should be grouped. + Stejné typy změn by měly být seskupené. %li - Versions and sections should be linkable. + Měla by existovat možnost odkazovat na jednotlivé verze a sekce. %li - The latest version comes first. + Poslední verze je na prvním místě. %li - The release date of each versions is displayed. + U každé verze je poznamenáno datum jejího vydání. %li - Mention whether you follow #{link_to "Semantic Versioning", semver}. + Zmiňte, zda se držíte #{link_to "Sémantického verzování", semver} %a.anchor{ href: "#types", aria_hidden: "true" } - %h4#types Types of changes + %h4#types Typy změn %ul %li %code Added - for new features. + pro nové funkce. %li %code Changed - for changes in existing functionality. + pro změny v existující funkcionalitě. %li %code Deprecated - for soon-to-be removed features. + pro funkce, které budou brzy odstraněny. %li %code Removed - for now removed features. + pro odstraněné funkce. %li %code Fixed - for any bug fixes. + pro opravy chyb. %li %code Security - in case of vulnerabilities. + v případě bezpečnostních zranitelností. .effort %h3#effort %a.anchor{ href: "#effort", aria_hidden: "true" } - How can I reduce the effort required to maintain a changelog? + Jak minimalizovat úsilí potřebné k udržování changelogu? %p - Keep an Unreleased section at the top to track upcoming - changes. + Udržováním Unreleased sekce na začátku souboru pro zaznamenávání + nadcházejících změn. - %p This serves two purposes: + %p To plní hned dva účely: %ul %li - People can see what changes they might expect in upcoming releases + Lidé uvidí, jaké změny mohou očekávat v následujících vydáních %li - At release time, you can move the Unreleased section - changes into a new release version section. + V čas vydání stačí přesunout změny z Unreleased sekce + do sekce nového vydání. .bad-practices %h3#bad-practices %a.anchor{ href: "#bad-practices", aria_hidden: "true" } - Can changelogs be bad? + Mohou být changelogy špatné? - %p Yes. Here are a few ways they can be less than useful. + %p Ano. Zde je několik případů, kdy mohou být opakem užitečného. %h4#log-diffs %a.anchor{ href: "#log-diffs", aria_hidden: "true" } - Commit log diffs + Diffy z commit logu %p - Using commit log diffs as changelogs is a bad idea: they're full of - noise. Things like merge commits, commits with obscure titles, - documentation changes, etc. + Používání diffů z commit logu jako changelogu je špatný nápad: + jsou plné šumu. Obsahují věci jako merge commity, commity s + nejasnými nadpisy, změny v dokumentaci, atd. %p - The purpose of a commit is to document a step in the evolution of - the source code. Some projects clean up commits, some don't. + Účelem commitu je zdokumentovat krok v evoluci zdrojového kódu. + Některé projekty commity pročišťují, jiné zas ne. %p - The purpose of a changelog entry is to document the noteworthy - difference, often across multiple commits, to communicate them - clearly to end users. + Účelem záznamu v changelogu je zdokumentovat podstatné změny, + často napříč několika commity, a jasně je sdělit koncovým uživatelům. %h4#ignoring-deprecations %a.anchor{ href: "#ignoring-deprecations", aria_hidden: "true" } - Ignoring Deprecations + Ignorování odstraněných funkcí + %p + Když lidé upgradují z jedné verze na druhou, mělo by jim být bolestně + jasné, když se něco rozbije. Mělo by být možné nejprve upgradovat na verzi, + která oznámí, jaké funkce budou odstraněny, dané funkce odstranit + a poté upgradovat na verzi, kde jsou zmíněné funkce již odstraněny. %p - When people upgrade from one version to another, it should be - painfully clear when something will break. It should be possible to - upgrade to a version that lists deprecations, remove what's - deprecated, then upgrade to the version where the deprecations - become removals. - - %p - If you do nothing else, list deprecations, removals, and any - breaking changes in your changelog. + Když už nic jiného, je dobré alespoň vypsat odstraněné funkce a + změny, které něco rozbíjí, do changelogu. %h4#confusing-dates %a.anchor{ href: "#confusing-dates", aria_hidden: "true" } - Confusing Dates + Matoucí data %p - Regional date formats vary throughout the world and it's often - difficult to find a human-friendly date format that feels intuitive - to everyone. The advantage of dates formatted like - 2017-07-17 is that they follow the order of largest to - smallest units: year, month, and day. This format also doesn't - overlap in ambiguous ways with other date formats, unlike some - regional formats that switch the position of month and day numbers. - These reasons, and the fact this date format is an - #{link_to "ISO standard", iso} are why it is the recommended date - format for changelog entries. + Regionální formáty dat se liší napříč světem a je často složité + najít formát, který je přátelský a intuitivní pro všechny. + Výhodou dat formátovaných jako 2017-07-17 je pořadí + jednotek od největší po nejmenší: rok, měsíc a den. Tento formát + se navíc nepřekrývá s jinými, narozdíl od některých regionálních + formátů, které prohazují pozici měsíce a dne. Díky těmto důvodům, + a také faktu, že je tento formát #{link_to "ISO standard", iso}, + je doporučeným formátem pro záznamy v changelogu. %aside - There’s more. Help me collect these antipatterns by - = link_to "opening an issue", issues - or a pull request. + Je toho však víc. Pomozte mi sesbírat tyto antipatterny + = link_to "otevřením issue", issues + nebo pull requestu. .frequently-asked-questions %h3#frequently-asked-questions %a.anchor{ href: "#frequently-asked-questions", aria_hidden: "true" } - Frequently Asked Questions + Časko kladené otázky %h4#standard %a.anchor{ href: "#standard", aria_hidden: "true" } - Is there a standard changelog format? + Existuje pro formát changelogu nějaký standard? %p - Not really. There's the GNU changelog style guide, or the two- - paragraph-long GNU NEWS file "guideline". Both are inadequate or - insufficient. + Ne. Je tu GNU stylová příručka pro changelog, nebo ta dvouodstavcová + GNU "směrnice" pro NEWS soubor. Ani jedno však není vhodné či dostačující. %p - This project aims to be - = link_to "a better changelog convention.", changelog - It comes from observing good practices in the open source - community and gathering them. + Tento projekt má za cíl být + = link_to "lepší konvencí pro changelog.", changelog + Pochází z pozorování osvědčených postupů v open source komunitě a jejich + shromažďování. %p - Healthy criticism, discussion and suggestions for improvements - = link_to "are welcome.", issues + Zdravá kritika, diskuse a návrhy na zlepšení + = link_to "jsou vítány.", issues %h4#filename %a.anchor{ href: "#filename", aria_hidden: "true" } - What should the changelog file be named? + Jak by se soubor s changelogem měl jmenovat? %p - Call it CHANGELOG.md. Some projects use - HISTORY, NEWS or RELEASES. + Pojmenujte ho CHANGELOG.md. Některé projekty + používají HISTORY, NEWS nebo RELEASES. %p - While it's easy to think that the name of your changelog file - doesn't matter that much, why make it harder for your end users to - consistently find notable changes? + Zatímco je snadné si myslet, že na názvu souboru vašeho changelogu + až tak nezáleží, proč koncovým uživatelům ztěžovat hledání významných + změn? %h4#github-releases %a.anchor{ href: "#github-releases", aria_hidden: "true" } - What about GitHub Releases? + A co GitHub Releases? %p - It's a great initiative. #{link_to "Releases", ghr} can be used to - turn simple git tags (for example a tag named v1.0.0) - into rich release notes by manually adding release notes or it can - pull annotated git tag messages and turn them into notes. + Je to skvělá iniciativa. Služba #{link_to "Releases", ghr} může být + použita na proměnu obyčejných git tagů (například tag s názvem + v1.0.0) na bohaté poznámky k vydání manuálním přidáním + daných poznámek, nebo může pullnout zprávy z anotovaných git tagů + a udělat poznámky k vydání z nich. %p - GitHub Releases create a non-portable changelog that can only be - displayed to users within the context of GitHub. It's possible to - make them look very much like the Keep a Changelog format, but it - tends to be a bit more involved. + GitHub Releases však vytvářejí nepřenosný changelog, který může být + zobrazen uživatelům jen v kontextu GitHubu. Je možné je udělat + velmi podobné formátu projektu Udržuj Changelog, ale to má + tendenci být trochu náročnější. %p - The current version of GitHub releases is also arguably not very - discoverable by end-users, unlike the typical uppercase files - (README, CONTRIBUTING, etc.). Another - minor issue is that the interface doesn't currently offer links to - commit logs between each release. + Aktuální verze GitHub Releases také pravděpodobně není příliš + objevitelná koncovými uživateli, narozdíl od typických souborů + s názvy psanými velkými písmeny (README, + CONTRIBUTING, atd.). Další menší problém je, že + Releases aktuálně nenabízí možnost odkazovat na commit logy mezi + jednotlivými vydáními. %h4#automatic %a.anchor{ href: "#automatic", aria_hidden: "true" } - Can changelogs be automatically parsed? + Mohou changelogy být automaticky parsovány? %p - It’s difficult, because people follow wildly different formats and - file names. + Je to složité, protože lidé používají mnoho rozdílných formátů a názvů + souborů. %p - #{link_to "Vandamme", vandamme} is a Ruby gem created by the - #{link_to "Gemnasium", gemnasium} team and which parses many (but - not all) open source project changelogs. + #{link_to "Vandamme", vandamme} je Ruby gem vytvořený týmem + #{link_to "Gemnasium", gemnasium}, který parsuje mnoho (ale ne všechny) + changelogy open source projektů. %h4#yanked %a.anchor{ href: "#yanked", aria_hidden: "true" } - What about yanked releases? + A co zpětně stažená vydání? %p - Yanked releases are versions that had to be pulled because of a - serious bug or security issue. Often these versions don't even - appear in change logs. They should. This is how you should display - them: + Stažená vydání jsou verze, které musely být zpětně odebrány kvůli vážné + chybě nebo bezpečnostním rizikům. Tyto verze se často v changelogu ani + neobjevují, ale měly by. Zobrazovat by se měly takto: %p ## 0.0.5 - 2014-12-13 [YANKED] %p - The [YANKED] tag is loud for a reason. It's important - for people to notice it. Since it's surrounded by brackets it's also - easier to parse programmatically. + Tag [YANKED] je křiklavý naschvál. Je důležité, aby si ho + lidé všimli. Díky tomu, že je v hranatých závorkách, je také jednodušší ho + parsovat programem. %h4#rewrite %a.anchor{ href: "#rewrite", aria_hidden: "true" } - Should you ever rewrite a changelog? + Měl by se changelog někdy přepisovat? %p - Sure. There are always good reasons to improve a changelog. I - regularly open pull requests to add missing releases to open source - projects with unmaintained changelogs. + Jistě. Vždy se najde dobrý důvod pro zlepšení changelogu. Sám často otevírám + pull requesty pro přidání chybějících vydání v open source projektech s + neudržovanými changelogy. %p - It's also possible you may discover that you forgot to address a - breaking change in the notes for a version. It's obviously important - for you to update your changelog in this case. + Je také možné, že zjistíte, že v poznámkách k verzi ve vašem projektu není + zmíněna změna, která něco rozbila. V tom případě je samozřejmě důležité, + aby byl changelog aktualizován. %h4#contribute %a.anchor{ href: "#contribute", aria_hidden: "true" } - How can I contribute? + Jak mohu přispět? %p - This document is not the truth; it’s my carefully - considered opinion, along with information and examples I gathered. + Tento dokument není čistá pravda; je to můj pečlivě + zvážený názor, společně s informacemi a příklady, které jsem shromáždil. %p - This is because I want our community to reach a consensus. I believe - the discussion is as important as the end result. + Je tomu tak proto, že chci aby naše komunita došla ke společné shodě. + Věřím, že diskuse je stejně důležitá jako konečný výsledek. %p - So please #{link_to "pitch in", gh}. + Takže prosím, #{link_to "přiložte ruku k dílu", gh}. .press - %h3 Conversations + %h3 Rozhovory %p - I went on #{link_to "The Changelog podcast", thechangelog} - to talk about why maintainers and contributors should care about changelogs, - and also about the motivations behind this project. + Zúčastnil jsem se #{link_to "podcastu The Changelog", thechangelog}, + abych promluvil o tom, proč by se správci projektů a přispěvatelé měli + starat o changelogy a také o motivaci za tímto projektem.