Добавление спеллера в FireFox: различия между версиями

Материал из Wiki FU-Lab
Перейти к навигации Перейти к поиску
Нет описания правки
 
(не показано 75 промежуточных версий этого же участника)
Строка 1: Строка 1:
Зарегистрироваться в магазине расширений firefox (если еще не).
Здесь описан алгоритм добавления разработчиком модуля проверки орфографии на своем языке в браузер FireFox на примере добавления коми (пермяцкого) спеллера от лаборатории FU-Lab.


В личном кабинете необходимо создать директорию проекта и в ней расположить файл manifest.json и директорию dictionaries
==Последовательность действий==


В директорию dictionaries необходимо поместить файлы dic, aff и readme.txt с свободным описанием расширения - это описание будет использоваться в магазине расширений
#Зарегистрироваться в [https://addons.mozilla.org/ru/developers/addons магазине расширений] FireFox (если еще не зарегистрированы).
#На своем компьютере создать папку проекта и в ней создать файл manifest.json и папку dictionaries.
#Отредактировать  файл manifest.json по образцу и положить в папку dictionaries файлы .dic и .aff, а также создать в ней файл readme.txt.
#Выделить готовый файл manifest.json и папку dictionaries и сжать их в единый zip архив.
#В центре разработчиков дополнений Mozilla нажать кнопку "Отправить новое дополнение".
#Здесь, возможно, потребуется пройти двухэтапную аутентификацию.
#Выбрать пункт в списке "Как распространять эту версию" и нажать "Продолжить".
#Загрузить подготовленный zip архив.
#Заполнить поля в форме "Опишите дополнение". Внимание: длина имени в URL расширения ограничена 30 знаками!
#Нажать кнопку "Представить версию".
#Дождаться рассмотрения вашего расширения. Оно будет одобрено (или отклонено) в течение нескольких часов. Сообщение о результате рассмотрения придет эл. письмом на адрес, который вы указывали при регистрации.
#Перейти по ссылке, указанной в письме, и установить расширение в браузер.


Структура файла manifest.json:
==Структура файла manifest.json==


{
{
   "version": "0.2.5",
   "version": "'''0.2.5'''",
   "dictionaries": {
   "dictionaries": {
     "komi-permyak": "dictionaries/koi.dic"
     "'''komi-permyak'''": "dictionaries/'''koi'''.dic"
   },
   },
   "description": "Коми (пермяцкий) словарь проверки орфографии",
   "description": "'''Коми (пермяцкий)''' словарь проверки орфографии",
   "name": "Koi spellchecking dictionary",
   "name": "'''Koi''' spellchecking dictionary",
   "manifest_version": 2,
   "manifest_version": 2,
   "applications": {
   "applications": {
     "gecko": {
     "gecko": {
       "id": "koi-spellchecker-v-0.4@fulabs"
       "id": "'''koi'''-spellchecker-v-'''0.4'''@'''fulab'''"
     }
     }
   }
   }
}
}


Подробнее:
==Описание разделов в файле manifest.json==


"version": "0.2.5"  
"version": "'''0.2.5'''"  
  - версия расширения
  - версия расширения


"dictionaries": {
  "dictionaries": {
     "komi-permyak": "dictionaries/koi.dic"
     "'''komi-permyak'''": "dictionaries/'''koi.dic'''"
   },  
   },  
- путь к файлу dic с описанием языковой локали по стандарту ISO 639-1, если языка нет в данном стандарте, можно написать название транслитом или на английском языке
  - код языка по стандарту ISO 639-1 (двухбуквенный код) и путь к файлу .dic
!!! Если код языка отсутствует в указанном стандарте (как в нашем случае), можно написать название языка транслитом или на английском языке, однако пробел, нижнее подчеркивание и верхний регистр не допускаются.
Позиция "код языка" проявляется в меню выбора языка проверки орфографии: двухбуквенный код будет преобразован в название языка (кириллицей), а в случае отсутствия двухбуквенного кода, в меню выбора языка проверки будет отображаться название языка латиницей, поставленное вами в эту позицию.


  "description": "Коми (пермяцкий) словарь проверки орфографии",  
  "description": "'''Коми (пермяцкий) словарь проверки орфографии'''",  
  - описание расширения
  - описание расширения


"name": "Koi spellchecking dictionary",  
"name": "'''Koi''' spellchecking dictionary",  
  - название расширения
  - название расширения (можно написать и полное название языка, напр. "'''Permian Komi''' spellchecking dictionary", но впоследствии надо будет сократить его в URL).


"manifest_version": 2,  
"manifest_version": '''2''',  
  - версия файла манифеста (остается без изменения 2)
  - версия файла манифеста (остается без изменения 2)


"applications": {
"applications": {
     "gecko": {
     "gecko": {
       "id": "koi-spellchecker-v-0.4@fulab"
       "id": "'''koi'''-spellchecker-v'''-0.4@fulab'''"
     }
     }
   }  
   }  
  - уникальный идентификатор в магазине расширения firefox
  - уникальный идентификатор в магазине расширения firefox


==Папка dictionaries==
В папку dictionaries необходимо поместить файлы c расширениями .dic и .aff, используемые в программе hunspell, а также файл readme.txt со свободным описанием расширения - это описание будет использоваться в магазине расширений.
==Выбрать способ распространения==
[[Файл:Mozi 3.jpg|500px|]]
==Описать дополнение==
[[Файл:Mozi_1.jpg|500px|]]
[[Файл:Mozi 4.png|500px|]]
==Ещё==


После окончания редактирования и подготовки файлов и директории проекта необходимо полученный результат поместить в zip архив без родительской директории.
В url дополнения будет автоматически проставлено его имя. Однако, если имя дополнения слишком длинное (более 30 знаков), оно будет усечено. Во избежание этого, вместо названия языка в url лучше использовать его код (например вместо "permian_komi_" использовать "koi_").

Текущая версия от 16:49, 10 декабря 2023

Здесь описан алгоритм добавления разработчиком модуля проверки орфографии на своем языке в браузер FireFox на примере добавления коми (пермяцкого) спеллера от лаборатории FU-Lab.

Последовательность действий

  1. Зарегистрироваться в магазине расширений FireFox (если еще не зарегистрированы).
  2. На своем компьютере создать папку проекта и в ней создать файл manifest.json и папку dictionaries.
  3. Отредактировать файл manifest.json по образцу и положить в папку dictionaries файлы .dic и .aff, а также создать в ней файл readme.txt.
  4. Выделить готовый файл manifest.json и папку dictionaries и сжать их в единый zip архив.
  5. В центре разработчиков дополнений Mozilla нажать кнопку "Отправить новое дополнение".
  6. Здесь, возможно, потребуется пройти двухэтапную аутентификацию.
  7. Выбрать пункт в списке "Как распространять эту версию" и нажать "Продолжить".
  8. Загрузить подготовленный zip архив.
  9. Заполнить поля в форме "Опишите дополнение". Внимание: длина имени в URL расширения ограничена 30 знаками!
  10. Нажать кнопку "Представить версию".
  11. Дождаться рассмотрения вашего расширения. Оно будет одобрено (или отклонено) в течение нескольких часов. Сообщение о результате рассмотрения придет эл. письмом на адрес, который вы указывали при регистрации.
  12. Перейти по ссылке, указанной в письме, и установить расширение в браузер.

Структура файла manifest.json

{

 "version": "0.2.5",
 "dictionaries": {
   "komi-permyak": "dictionaries/koi.dic"
 },
 "description": "Коми (пермяцкий) словарь проверки орфографии",
 "name": "Koi spellchecking dictionary",
 "manifest_version": 2,
 "applications": {
   "gecko": {
     "id": "koi-spellchecker-v-0.4@fulab"
   }
 }

}

Описание разделов в файле manifest.json

"version": "0.2.5" 
- версия расширения
 "dictionaries": {
   "komi-permyak": "dictionaries/koi.dic"
 }, 
 - код языка по стандарту ISO 639-1 (двухбуквенный код) и путь к файлу .dic
!!! Если код языка отсутствует в указанном стандарте (как в нашем случае), можно написать название языка транслитом или на английском языке, однако пробел, нижнее подчеркивание и верхний регистр не допускаются.
Позиция "код языка" проявляется в меню выбора языка проверки орфографии: двухбуквенный код будет преобразован в название языка (кириллицей), а в случае отсутствия двухбуквенного кода, в меню выбора языка проверки будет отображаться название языка латиницей, поставленное вами в эту позицию.
"description": "Коми (пермяцкий) словарь проверки орфографии", 
- описание расширения
"name": "Koi spellchecking dictionary", 
- название расширения (можно написать и полное название языка, напр. "Permian Komi spellchecking dictionary", но впоследствии надо будет сократить его в URL).
"manifest_version": 2, 
- версия файла манифеста (остается без изменения 2)
"applications": {
   "gecko": {
     "id": "koi-spellchecker-v-0.4@fulab"
   }
 } 
- уникальный идентификатор в магазине расширения firefox

Папка dictionaries

В папку dictionaries необходимо поместить файлы c расширениями .dic и .aff, используемые в программе hunspell, а также файл readme.txt со свободным описанием расширения - это описание будет использоваться в магазине расширений.

Выбрать способ распространения

Mozi 3.jpg

Описать дополнение

Mozi 1.jpg Mozi 4.png

Ещё

В url дополнения будет автоматически проставлено его имя. Однако, если имя дополнения слишком длинное (более 30 знаков), оно будет усечено. Во избежание этого, вместо названия языка в url лучше использовать его код (например вместо "permian_komi_" использовать "koi_").