From 90d4d7a9b5acb49e520782c3b10a485711354d5c Mon Sep 17 00:00:00 2001 From: Vladislav Shapovalov Date: Sun, 5 Mar 2023 20:59:10 +0200 Subject: [PATCH 1/2] add git.uk.md & news/merge.uk.md --- site/git.uk.md | 191 ++++++++++++++++++++++++++++++++++++++++++ site/news/merge.uk.md | 86 +++++++++++++++++++ 2 files changed, 277 insertions(+) create mode 100644 site/git.uk.md create mode 100644 site/news/merge.uk.md diff --git a/site/git.uk.md b/site/git.uk.md new file mode 100644 index 0000000..74e47ed --- /dev/null +++ b/site/git.uk.md @@ -0,0 +1,191 @@ +--- +title: Огляд коду +x-toc-enable: true +... + +репозиторії libreboot +=================== + +Інформацію про те, хто працює над libreboot і хто керує проектом, можна +знайти на [who.uk.md](who.uk.md) + +Проект `libreboot` має 3 основні сховища Git: + +* Система побудови: +* Веб-сайт (+документація): +* Зображення (для веб-сайта): + +Є також ці програми, розміщені в проекті Libreboot, і libreboot +або рекомендує їх, або використовує їх: + +* Bucts (утиліта): +* ich9utils (утиліта): + +Ви можете завантажити будь-яке з цих сховищ, внести будь-які зміни, і +потім надіслати свої зміни, дотримуючись інструкцій нижче. + +Рекомендовано створювати libreboot (усі його частини) у дистрибутиві +GNU+Linux. Наприклад, система збірки (lbmk) не перевірена на системах BSD. +Встановіть `git` у вашій системі GNU+Linux, і завантажте одне із сховищ. + +Розробка libreboot виконується за допомогою системи контролю версій Git. +Зверніться до [офіційної документації Git](https://git-scm.com/doc), якщо ви не +знаєте, як користуватися Git. + +Репозиторій `bucts` розміщено в проекті libreboot, оскільки оригінальний +репозиторій на `stuge.se` більше не доступний, коли ми перевіряли останній раз. +Програма `bucts` була написана Пітером Стьюджем. Вам знадобляться `bucts`, якщо ви прошиваєте +внутрішньо libreboot ROM на ThinkPad X60 або T60, на якому зараз працює +невільний Lenovo BIOS. Інструкції щодо цього доступні тут:\ +[посібники зі встановлення libreboot](docs/install/) + +Репозиторій `ich9utils` активно використовується системою збирання `lbmk`. Однак +ви також можете завантажити `ich9utils` самостійно та використовувати його. Він генерує ICH9M +дескриптор+GbE образи для GM45 ThinkPad, які використовують південний міст ICH9M. Він +також може працювати з іншими системами, що використовують ту саму платформу/чіпсет. +Документація для `ich9utils` доступна тут:\ +[документація ich9utils](docs/install/ich9utils.md) + +lbmk (libreboot-make) +--------------------- + +Це основна система збирання в libreboot. Можна сказати, що `lbmk` *це* +libreboot! Завантажте репозиторій Git: + + git clone https://notabug.org/libreboot/lbmk + +Команда `git`, показана вище, завантажить систему збірки libreboot `lbmk`. +Потім ви можете перейти до цього так: + + cd lbmk + +Внесіть будь-які зміни, які забажаєте, або просто побудуйте. Щоб отримати вказівки щодо +збирання `lbmk`, зверніться до [інструкцій зі збирання](docs/build/). + +Інформація про саму систему збірки та про те, як вона працює, доступна в +[посібнику обслуговування lbmk](docs/maintain/). + +lbwww та lbwww-img +------------------- + +*Весь* веб-сайт і документація libreboot розміщені в репозиторії Git. +Завантажте так: + + git clone https://notabug.org/libreboot/lbwww + +Зображення розміщені на і доступні в окремому +сховищі: + + git clone https://notabug.org/libreboot/lbwww-img + +Вносьте будь-які зміни, які забажаєте. Дивіться нотатки нижче про те, як надсилати виправлення. + +Весь веб-сайт написаний у Markdown, зокрема його версія Pandoc. +Статичні сторінки HTML створюються за допомогою [Untitled](https://untitled.vimuser.org/). +Лія Роу, засновниця libreboot, також є засновницею проекту генератор статичних сайтів +Untitled. + +Якщо хочете, ви можете налаштувати локальний HTTP-сервер і створити власну локальну +версію веб-сайту. Зауважте, що зображення все одно будуть посилатися на ті, що +розміщені на , тому будь-які зображення, які ви додаєте до `lbwww-img` +не відображатимуться на вашому локальному сайті `lbwww`, якщо ви зробите, щоб посилання на зображення (для +зображень, які ви додаєте) посилались на `av.libreboot.org`. Однак необхідно, щоб такі +зображення розміщувалися на av.libreboot.org. + +Тому, якщо ви бажаєте додати зображення на веб-сайт, надішліть їх також до +репозиторія `lbwww-img`, із посиланням на них + для кожного з них. +Коли його буде поєднано на веб-сайті libreboot, ваші зображення з'являться в реальному часі. + +Для цілей розробки ви можете спочатку створити локальні посилання на зображення, а +потім налаштувати URL-адреси, коли надсилатимете документацію/патчі веб-сайту. + +На веб-сайті Untitled є інструкції щодо налаштування локальної версії +веб-сайту. Завантажте untitled, і в своєму каталозі `untitled` створіть каталог +під назвою `www/`, потім увійдіть у каталог www і клонуйте сховище `lbwww` +там. Налаштуйте локальний HTTP-сервер відповідним чином. + +Знову ж таки, інструкції для цього доступні на веб-сайті Untitled. + +Ім'я не вимагається +----------------- + +Внески, які ви робите, реєструються публічно в репозиторії Git, доступ +до якого мають всі. Це включає ім'я та електронну адресу +учасника. + +У Git для імені автора та електронної адреси вам не потрібно використовувати +ідентифікаційні дані. Ви можете використовувати `libreboot Contributor`, а свою електронну адресу можна +вказати як contributor@libreboot.org. Вам дозволено це робити, якщо +ви бажаєте зберегти конфіденційність. Ми віримо в конфіденційність. Якщо ви вирішите залишитися +анонімними, ми врахуємо це. + +Звичайно, ви можете використовувати будь-яке ім'я та/або адресу електронної пошти. + +З юридичної точки зору всі авторські права є автоматичними відповідно до Бернської конвенції +міжнародного авторського права. Немає значення, яке ім'я, чи дійсно ви навіть +заявляєте про авторське право (але ми вимагаємо наявності певного +ліцензування авторського права - докладніше про це на цій же сторінці). + +Якщо ви використовуєте інше ім'я та адресу електронної пошти у своїх комітах/патчах, то +маєте бути досить анонімним. використовуйте +[git log](https://git-scm.com/book/en/v2/Git-Basics-Viewing-the-Commit-History) +та [git show](https://git-scm.com/docs/git-show), щоб підтвердити це перед тим, як ви +надсилаєте зміни до загальнодоступного сховища Git. + +Ліцензії (для учасників) +-------- + +Обов'язково вільно ліцензуйте свою роботу, за вільною ліцензією. Libreboot більше не +встановлює довільні обмеження на те, які ліцензії приймаються, і багато +інших ліцензій вже існує. Ми перевіримо ваш внесок і розкажемо вам, якщо з ним +виникли проблеми (наприклад, немає ліцензії). + +*Завжди* декларуйте ліцензію на свою роботу! Недекларування ліцензії означає, що +за замовчуванням застосовуються обмежувальні закони про авторське право, які зроблять вашу роботу +захищеною власністю, підпадаючи під усі ті самі обмеження. + +Ліцензія MIT є хорошою для початку, і вона є бажаною ліцензією +для всіх нових робіт у Libreboot, але ми не вибагливі. Libreboot історично +використовував ліцензування GNU, таке як GPL; багато з цього залишилося, і, ймовірно, залишиться. +Це ваша робота; очевидно, якщо ви використовуєте існуючу роботу, +може мати сенс використовувати ту саму ліцензію для вашого внеску, для сумісності +ліцензії. + +Ви можете знайти типові приклади ліцензій +[тут](https://opensource.org/licenses). + +Якщо ви *виходите* на основі існуючого твору, важливо, щоб ваша ліцензія (на ваш внесок) +була сумісна з ліцензуванням твору, з якого +ваш був отриманий. Ліцензія MIT хороша, оскільки вона широко сумісна +з багатьма іншими ліцензіями та надає багато свобод (наприклад, свободу +субліцензування), яких немає в інших ліцензіях: + + + +Надсилайте виправлення +------------ + +Створіть обліковий запис на і перейдіть (увійшовши в систему) до +репозиторію, над яким ви хочете працювати. Натисніть *Fork*, і у вашому обліковому записі, +ви матимете власне сховище libreboot. Клонуйте свій репозиторій, внесіть у нього +будь-які зміни, а потім надішліть їх у свій репозиторій у своєму обліковому +записі на NotABug. Ви також можете зробити це на новій гілці, якщо хочете. + +У своєму обліковому записі Notabug, ви можете перейти до офіційного репозиторія libreboot +і надіслати запит на отримання. Принцип роботи подібний до інших популярних веб-платформ +Git, якими люди користуються сьогодні. + +Ви можете відправити свої патчі туди. Крім того, ви можете увійти на +IRC-канал libreboot і повідомити канал, які виправлення ви хочете бути переглянутими, якщо у вас +є власне сховище Git з виправленнями. + +Після того, як ви подасте Pull Request, розробники libreboot отримають сповіщення +електронною поштою. Якщо ви не отримаєте достатньо швидкої відповіді від проекту, ви +також можете повідомити проект через канал `#libreboot` на Libera Chat. + +Інший спосіб подати виправлення - це напряму надіслати Лії Роу електронною поштою: +[leah@libreboot.org](mailto:leah@libreboot.org) - це адреса електронної пошти проекту Лії. + +Однак, для прозорості процесу перевірки коду, ми рекомендуємо на даний момент +використовувати Notabug. diff --git a/site/news/merge.uk.md b/site/news/merge.uk.md new file mode 100644 index 0000000..fe8e3d9 --- /dev/null +++ b/site/news/merge.uk.md @@ -0,0 +1,86 @@ +% Osboot тепер є частиною Libreboot +% Лія Роу +% 15 листопада 2022 року + +Довго живе Libreboot! +==================== + +Минулий проект `osboot`, розпочатий тим же самим засновником, що й Libreboot, Лією +Роу, сьогодні було вимкнено; веб-сайт osboot тепер автоматично перенаправляє, через +HTTP 301, на веб-сайт libreboot. Все, що мав osboot, тепер було додано +до Libreboot, і розробка тепер буде проходити виключно в Libreboot з цього +момента. + +Результатом цього рішення є те, що Libreboot тепер підтримує (і може підтримувати) новіше +апаратне забезпечення, таке як ThinkPad X230 або T440p. + +Про це згадувалося в попередньому оголошенні про випуск Libreboot: + + + +Точний метод, запропонований у тому попередньому повідомленні, не був прийнятий. +Натомість, Libreboot, по суті, зараз *є* osboot, під іменем Libreboot. + +*Політика зменшення бінарних блобів* osboot замінила попередню +політику, яку використовував Libreboot. Це прагматична політика, спрямована на надання +якомога більшої свободи кожній платформі, але більше не дотримається лише +тих *"чистих"* платформ; тепер можна підтримувати всі платформи з coreboot, якщо +хтось бажає підтримувати плату в `lbmk`. Нова політика тут: + + (той самий URL, що і старий, але +текст було оновлено, відповідно до політики osboot) + +Щоб зрозуміти всю природу цього злиття, вам слід прочитати документ про політику, +посилання на який наведено вище. І osboot, і Libreboot були багато в чому ідентичними, і +в основному той самий проект. Щоб значно полегшити управління проектами, +їх просто об'єднали в один. + +Як було проведено злиття +--------------------------- + +З 2020 року Libreboot (і osboot) пройшли кілька перезавантажень, +відгалуджуючи один одного для підтримки синхронізації. Це почало ставати занадто +великим тягарем, що стало основною причиною злиття. + +14 листопада, я (Лія Роу) буквально зробила diff всього Libreboot, з моменту +останнього перезавантаження (репозиторія Libreboot) і перевірила кожну з osboot, +додавши те, чого не вистачає в цьому *в osboot*. Тоді проект osboot +синхронізується з Libreboot, але відповідно до osboot і з додатковими +платами (плюс сценарії і так далі) в osboot, порівняно з Libreboot до злиття. + +Те саме *потім* було застосовано *у зворотному порядку*: відмінності в osboot були перенесені +назад до Libreboot, обережно та методично. Все це відбулося +протягом 1 дня, оскільки загальна структура обох проектів була в основному +однаковою, а системи збірки в обох проектах надзвичайно модульні, що робить +таку роботу справді дуже легкою. + +Подібний процес було виконано з веб-сайтами Libreboot і osboot, +але osboot уже містив ту саму документацію, що й Libreboot, +а також додаткові. Тому відмінності було перенесено на Libreboot. + +Перенесення документації (від osboot до Libreboot) виконав +Калеб Ла Грейндж (IRC нік `shmalebx9`), і я переглянула її самостійно перед тим, як +опублікувати. + +На момент написання цього допису, одна утиліта з osboot (для зміни MAC-адрес +у регіонах Gbe на машинах Intel, які мають IFD) ще не була перенесена, +але я розглядаю можливість об'єднання всіх зовнішніх утиліт, які ми підтримуємо (bucts, +ich9gen та nvmutil) в lbmk, роблячи lbmk свого роду *монорепозиторієм*, схожим на BSD. Ми +побачимо. + +Ось і все справді. Osboot і Libreboot тепер працюють як єдиний, об'єднаний +проект, як і мало бути з самого початку. Досить нудна новина, +насправді. + +Незабаром з'явиться новий випуск Libreboot!!! +==================================== + +CrOS пристрої знову додано до Libreboot +---------------------------------- + +Документація має бути оновлена, для відображення цього і багатьох інших речей, але +засновані на ARM chromebook тепер знову підтримуються в Libreboot, використовуючи +корисне навантаження u-boot всередині coreboot. + +Цю роботу люб'язно надав Альпер Небі Ясак (`alpernebbi` на libera IRC) і це також +є частиною злиття. From b43c48c559485492e5b9a272624358a10890e1dc Mon Sep 17 00:00:00 2001 From: Vladislav Shapovalov Date: Sun, 5 Mar 2023 22:20:21 +0200 Subject: [PATCH 2/2] add docs/index.uk.md --- site/docs/index.uk.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 site/docs/index.uk.md diff --git a/site/docs/index.uk.md b/site/docs/index.uk.md new file mode 100644 index 0000000..06356bd --- /dev/null +++ b/site/docs/index.uk.md @@ -0,0 +1,36 @@ +--- +title: Документація +... + +Завжди перевіряйте [libreboot.org](https://libreboot.org/index.uk.md) для останніх оновлень +libreboot. Новини, включаючи оголошення про випуски, може бути знайдено +в [основній секції новин](../news/). + +[Відповіді на поширені запитання про libreboot](../faq.md). + +Встановлення libreboot +==================== + +- [На яких системах я можу встановлювати libreboot?](hardware/) +- [Як встановити libreboot](install/) + +Документація, яка має відношення до операційних систем +============================ + +- [Керівництва GNU+Linux](gnulinux/) +- [Як встановити BSD на x86 хостову систему](bsd/) + +Інформація для розробників +========================== + +- [Як зібрати джерельний код libreboot](build/) +- [Документація розробника системи побудови](maintain/) +- [Корисне навантаження GRUB](grub/) +- [Корисне навантаження U-Boot](uboot/) + +Інша інформація +================= + +- [Різне](misc/) +- [Список кодових назв](misc/codenames.md) +