ENGLISH (coming soon)
Я планирую заняться переводом на английский язык, как только будет оформлена основная часть документации на русском языке.
Описание параметров config.plist - начал оформлять
Когда я начал знакомится с загрузчиком Opencore, то начал искать официальную документацию этого загрузчика и, на мое удивление, нашел ее прямо в репозитории загрузчика в формате TeX и в формате PDF, а так же есть вроде как неофициальная веб версия этой документация на сайте dortania.
Меня очень порадовала такое количество полезной информации по настройке загрузчика от официальных разработчиков. Есть сам описание всех параметров файла конфигурации загрузчика, есть описание спорных моментов и даже файл, в котором показана разница в документах за предыдущую и настоящую версии загрузчика. А наличие веб версии (хоть и не официальной), позволяет поисковым системам проиндексировать эту документацию и, если кто-то будет искать информацию по определенному параметру в файле config.plist, то поисковые системы могут показать, что эта информация есть в официальной документации.
К сожалению, в отличие от загрузчика Opencore, у загрузчика Clover дела с документацией немного хуже. В настоящий момент информация по настройке загрузчика Clover распространяется в виде книги в формате PDF, под названием "Кловер цвета хаки" (или "Клевер цвета хаки"). Эта книга пишется и публикуется разработчиком загрузчика Clover в разделе релизов на странице его репозитория. Публикуется она не с каждым релизом, а только в том случае, если в ней произошли какие-то изменения.
Дело в том, что "Кловер цвета хаки" это, на мой взгляд, все же больше книга, чем документация. Без сомнения она безгранично полезна для настройки загрузчика Clover, но написана она во многих местах очень неформальным языком из-за чего автоматический перевод этой книги на английский язык дает некорректные результаты. Так же (возможно это звучит как придирка) в ней нет единого стиля оформления в плане отступов и описания пунктов и часто трудно понять к какому пункту относиться написанный текст.
Здесь, я бы хотел создать документацию по загрузчику Clover, в которой бы, как минимум были бы описаны все пункты файла config.plist для загрузчика Clover, их возможные значения и значения по-умолчанию, может быть примеры кода и другое.
В общем я хочу сделать документацию для загрузчика Clover наподобие такой, как она выглядит у загрузчика Opencore.
Наверное не все знают, но раньше код загрузчика Clover и его релизы находились в сервисе SourceForge и, наверное, начиная с ревизии 5071 загрузчик Clover начал официально публиковаться на GitHub (потому что ревизия 5071 первая в списке релизов на Github странице репозитория загрузчика) и страница загрузчика Clover на SourceForge теперь заброшена. Дело в том, что на этой странице есть раздел "Wiki" в котором как-раз таки описывались параметры файла config.plist и как раз на английском языке, но та документация давно перестала обновляться. Так же некоторые пункты файла конфигурации описываются на странице на форуме insanelymac со списком изменений в новых версиях загрузчика Clover.
В общем вот список сайтов, с которых я буду брать информацию при составлении документации:
- https://www.insanelymac.com/forum/topic/304530-clover-change-explanations/
- https://sourceforge.net/p/cloverefiboot/wiki/Home/
- https://github.com/RehabMan/Clover
- https://github.com/CloverHackyColor/CloverBootloader/releases/download/5129/Clover_Of_Khaki_Color_rus_5129.pdf
Кстати, раньше был сайт-вики по настройке config.plist для загрузчика Clover, который, на мой взгляд, полностью повторял информацию из раздела Wiki на странице Sourceforge. Этот сайт почему-то закрылся и его адрес https://clover-wiki.zetam.org/