{"id":26457156,"url":"https://github.com/progit/progit2-be","last_synced_at":"2025-03-18T22:43:10.439Z","repository":{"id":22673694,"uuid":"26017144","full_name":"progit/progit2-be","owner":"progit","description":null,"archived":false,"fork":false,"pushed_at":"2022-07-11T21:58:46.000Z","size":172097,"stargazers_count":7,"open_issues_count":1,"forks_count":14,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-03-25T22:18:01.414Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/progit.png","metadata":{"files":{"readme":"README.asc","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.asc","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-10-31T13:26:31.000Z","updated_at":"2024-03-25T22:18:01.414Z","dependencies_parsed_at":"2022-08-29T09:32:00.427Z","dependency_job_id":null,"html_url":"https://github.com/progit/progit2-be","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/progit%2Fprogit2-be","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/progit%2Fprogit2-be/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/progit%2Fprogit2-be/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/progit%2Fprogit2-be/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/progit","download_url":"https://codeload.github.com/progit/progit2-be/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244320333,"owners_count":20434092,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-18T22:43:09.955Z","updated_at":"2025-03-18T22:43:10.432Z","avatar_url":"https://github.com/progit.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"= Pro Git, Другое Выданне\n\nВітаем у другім выданні кнігі Pro Git.\n\nГэтую ж самую кнігу можна знайсці онлайн: https://git-scm.com/book\n\nГэтае выданне, як і першае, з'яўляецца праектам з адкрытым зыходным кодам з ліцэнзіяй Creative Commons.\n\nЗ моманту публікацыі першага выдання шмат што змянілася.\nПа-першае, мы перайшлі з Markdown на AsciiDoc -- вось кароткі даведнік па сінтаксісе https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/[AsciiDoc].\n\nПа-другое, пераклады на іншыя мовы перанесены ў асобныя рэпазітары.\nПадрабязна у пункце пра пераклады.\n\n== Як прыняць удзел\n\nКаб выправіць памылку або дадаць нешта новае ў гэты рэпазітар, вам трэба адкрыць запыт на зліццё (Pull Request) на GitHub.\n\nНягледзячы на тое, што ў ангельскай версіі просяць ўстрымацца ад стылістычных змен на вялікіх участках тэксту, гэты пераклад прафесійныя рэдактары не праглядалі, будзем рады вашым праўкам.\n\n== Як сабраць кнігу\n\nЁсць два сбосабу атрымаць файл электроннай кнігі з гэтага коду.\n\nСамы просты -- даручыць гэта нам.\nРобат рэагуе на змены ў ветцы `master` рэпазітара и аутаматычна збірае кнігу ва ўсіх фарматах.\n\nАпошнюю зборку можна знайсці на старонцы https://git-scm.com/book/be/v2.\n\nІншы спосаб атрымаць кнігу -- сабраць яе самастойна з дапамогай Asciidoctor.\nВыкарыстоўваючы каманды ніжэй, вы зможаце атрымаць кнігу ў фарматах HTML, EPUB і PDF.\n\n----\n$ bundle config set --local path '.bundle/vendor'\n$ bundle install\n$ bundle exec rake book:build\nDownloading locale attributes file...\n -- Saved at attributes-ru.adoc\nConverting to HTML...\n -- HTML output at progit.html\nConverting to EPUB...\n -- EPUB output at progit.epub\nConverting to PDF...\n -- PDF  output at progit.pdf\nValidating generated files...\n -- Validate HTML file progit.html\nRunning [\"ScriptCheck\", \"LinkCheck\", \"ImageCheck\", \"HtmlCheck\"] on progit.html on *.html...\n\n\nChecking 89 external links...\nRan on 1 file.\n\n\nHTML-Proofer finished successfully.\n -- Validate EPUB output file progit.epub\nValidating using EPUB version 3.2 rules.\nNo errors or warnings detected.\nMessages: 0 fatals / 0 errors / 0 warnings / 0 infos\n\nEPUBCheck completed\n----\n\nТут выкарыстоўваюцца праекты `asciidoctor`, `asciidoctor-pdf` и `asciidoctor-epub`.\n\nПа змаўчанні, `bundle install` усталёўвае залежнасці глабальна у сістэму.\nКаб гэтага пазбегнуць, у прыкладзе вышэй менеджэр пакетаў дадаткова канфігуруецца перад усталяваннем залежнасцяў з дапамогай наступнай каманды:\n\n----\nbundle config set --local path '.bundle/vendor'\n----\n\nТаксама існуе магчымасць сабраць кнігу толькі ў адным з фарматаў.\n\nДля генерацыі толькі HTML файла:\n\n----\nbundle exec rake book:build_html\n----\n\nДля генерацыі толькі EPUB-файла:\n\n----\nbundle exec rake book:build_epub\n----\n\nДля генерацыі толькі PDF файла:\n\n----\nbundle exec rake book:build_pdf\n----\n\nДля валідацыі згенераваных файлаў прадугледжаны каманды праверкі.\n\nДля праверкі HTML файла:\n\n----\nbundle exec rake book:check_html\n----\n\nДля праверкі EPUB-файла:\n\n----\nbundle exec rake book:check_epub\n----\n\nЗвярніце ўвагу, што для запуску праверкі EPUB-файла патрабуецца наяўнасць усталяванага JRE.\n\n== Пераклады\n\nПераклады на іншыя мовы горача вітаюцца, але апрацоўваюцца некалькі інакш, чым у першым выданні.\nМы захоўваем кожны пераклад у асобным рэпазітары і аўтаматычна збіраем гатовыя файлы з дапамогай AsciiDoctor.\nГэта было рэальна складаным у мінулым выданні.\n\nРаз кожны пераклад захоўваецца ў сваім рэпазітары, зараз мы можам выбраць свайго каардынатара для кожнага з іх.\nКаманда Pro Git проста дадасць іх да сябе.\nДля аўтаматычнай зборкі рэпазітар павінен знаходзіцца ў каманды Pro Git https://github.com/progit[на GitHub].\n\n== Ілюстрацыі\n\nМалюнкі гэтай кнігі былі створаны з дапамогай https://www.sketch.com/[Sketch 3], арыгінальны https://github.com/progit/progit2/blob/master/diagram-source/progit.sketch[файл] у фармаце sketchbook даступны ў ангельскай версіі кнігі.\n\nДаданне ілюстрацыі:\n\n. Дадайце старонку ў sketchbook; па-магчымасці старайцеся выкарыстоўваць убудаваныя сімвалы.\n. Дадайце «slice» на сваю старонку; назавіце яе таксама, як PNG файл, адносна каранёвай часткі зыходнага кода кнігі.\n. Пераканайцеся, што ў наладах экспарту выстаўлены трохразовы памер.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprogit%2Fprogit2-be","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprogit%2Fprogit2-be","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprogit%2Fprogit2-be/lists"}