Писане на кирилица за сайтове 6.0u rc2

Здравейте!

Това е примерен файл, който показва как известният Скрипт за писане на кирилица с латинска клавиатура може много лесно да се сложи на всеки сайт, форум, книга за гости, формуляр и т.н.

Примерна употреба

Способности

Ако искате, можете да сложите програмата на Вашия сайт, на Вашия предпочитан форум или за други цели, много е лесно. Пишете на Вашия уебмайстор: ще го направи с удоволствие за нула време.

Има няколко предимства:

• всеки може да си дефинира кирилицата, както му е удобно, включително с двойни букви и комбинации;
• инсталирането е само в добавяне на един ред;
• за всички уеб-страници/формуляри в една директория на сървъра кирилицата се дефинира само веднъж;
• предпочитанията се запазват в Cookie на компютъра на посетителя - няма нужда от бази данни и др.;
• "преводът" се извършва на компютъра на посетителя - не се хаби от ресурсите на сървъра;
• съвместим със системите за форматиране "Мета Език" или "vB Code" на многобройни програми за форуми;
• съвместима с JavaScript 1.2, теоритично работи с Netscape 4.78¹ и 6+, MSIE 5+² и всички други - Mozilla, Firefox 0.9, Opera 7.51, а това са около 97% от хората;³
• новите версии след 6.0 могат да се ползват във всички сайтове и кодировки, не само CP-1251, ами и Уникод, KOI8-R и т.н.

Можете да прочетете и помощния файл за потребителите.

За уебмайстори: изтеглете зип-архива (34 kB) с необходимите примерни и помощни файлове. Вижте и условията за ползване.

Бележки:
(1) Официално се поддържа от 6 нагоре. Преди нея, няколко знака не могат да се ползват за ограничители, иначе работи.
(2) Във версиите IE5.01 и по-стари не може да се зададе RegExp израз ".+?", затова има вероятност при команда [quote], [code] или [php], ако е последвана по-надолу от същата, целия текст между двете да се пропусне.
(3) Коства ми прекалено много усилия, за да правя още повече съвместимост, а почти няма нужда, но ако имате добри решения, давайте ги. Например Konqueror за съжаление има два бъга, един при RegExp.replace(кирилица), друг при self.opener.*.

Направил съм скрипта така, че най-лесно да се инсталира на всякакви сайтове и да се адаптира максимално. Приемам с удоволствие всякакви идеи, забележки и предложения.

начало

За дискусионни форуми

Скриптът може лесно да се ползва в/за повечето дискусионни форуми, тъй като разпознава и запазва командите за форматиране (BBcode, vBcode). Следните команди се поддържат (главни или малки букви) и са независими от избраните ограничители за латиница:

• [X]ne_se_prevejda[/X], където X може да е url, email, img, image, link, code, php, quote, quote="ne_se_prevejda"
• [X=ne_se_prevejda]превежда се[/X], където X може да е url, email, color, font, size, list
• [X]превежда се[/X], където X може да е b, i, u, list
• адреси на ел.поща и на интернет сайтове (name@site, http://site, www.site) се пропускат
• повечето картинки (smilies) се разпознават, ако изглеждат така: ":smiley:", тоест "интервал, двоеточие или точка-запетая, поредица знаци без интервал".

Можете да прочетете и помощния файл за потребителите.

начало

Инсталиране

Инсталирането е много по-лесно, отколкото при предишните версии - добавя се само 1 (словом "един") ред.

1. Копирайте файла "cyr5ko6p.js" в някоя достъпна за четене директория на сайта ви. Този файл се препоръчва да бъде в директорията, в която се намира страницата, която го вика, или евентуално в по-горна директория, примерно в "/".

2. Във вашия сайт/страница/подложка, в същия формуляр като полетата за превод, там, където трябва да се появи менюто за кирилизация, сложете тази команда:

<script src="../js/cyr5ko6p.js" type="text/javascript" language="javascript1.2"></script>

Това е всичко и ще работи за повечето сайтове ("../js/cyr5ko6p.js" е пътят до скрипта, както е обяснено в точка 1).

Внимание, разлика с предишни версии: ако не са указани полетата за превод, по подразбиране скриптът ще превежда на кирилица текстовете от всички текстови полета във формуляра (text, textarea). Ако желаете да промените това, трябва да зададете полетата, които (не*) се превеждат, вместо горната команда, по следния начин (добавят се още два реда код):

<script type="text/javascript" language="javascript1.2"><!--
var v5_formfields = "komentari"; //--></script>
<script src="../js/cyr5ko6p.js" type="text/javascript" language="javascript1.2"></script>

Където "komentari" е полето, което ще се превежда. Ако има няколко полета за превод, отделете ги със "|": "komentari|zaglavie|grad". Това са всъщност "имената" на полетата в уебстраницата, които са зададени с атрибута name="komentari" (ако не разбирате съвсем какво означава това, по-добре не инсталирайте скрипта сами, ами помолете някой по-опитен).

(*) За други настройки, вижте по-долу.

Ако подновявате предишна версия, обикновено само сменяте файла cyr5ko6p.js (за версии след 6.0u-rc1); вижте по-долу и раздела "промени във версиите".

Ако желаете да ви пращам бележка, като направя нова версия (тестова или официална), пишете ми на 5ko (à) free.fr.

начало

Условия за ползване и публикуване

Това е свободна програма; това означава, че можете да я променяте, публикувате и/или разпространявате при условията на лиценза GNU GPL, публикуван от Фондацията за свободен софтуер: или версия 3, или (по Ваш избор) някоя следваща версия.

Това означава също така, че в началото на кода ми трябва да не се маха бележката с информацията за автора и разрешението за ползване (и без това е само като коментар :-). Държа много на това.

Тази програма е създадена с надеждата, че ще бъде полезна, но без никаква гаранция за това, без дори косвена гаранция за пригодност за някаква цел. Вижте лиценза GNU GPL за повече подробности (http://www.gnu.org/copyleft/gpl.html).

Ако я намирате за полезна и Ви върши работа, ще се радвам да го разбера.

Моля пращайте ми вашите коментари и идеи за подобрения на адрес 5ko (à) free.fr.

Поздрави, --Петко

начало

Техническа информация

Следва малко техническа информация, която може да ви спести време, ако искате да правите промени и подобрения. (Ако правите, непременно ми ги пратете.)

Изходен код

Изходният програмен код може да се види във файла cyr5ko6.source.js. Той е "компресиран" до cyr5ko6p.js с версия 2.0.2 на програмата "packer" от Дийн Едуардс, с което се намалява почти наполовина.

начало

Други настройки

Няколко неща още могат да се настроят, като се добавят команди или преди извикването на скрипта (както е показано по-горе), или в началото на самия файл cyr5ko6p.js. Забележете, че ако викате скрипта от различни страници, може би за всяка от тях ще има различни настройки и е по-добре да се поставят в самата страница; друго предимство да не се пипа скрипта е, че при нова версия ще трябва само да копирате новия файл на мястото на стария.

• var v5_formfields = ".*";
  • За полетата за превод. Ако е ".*" (точка-звездичка), се превеждат всички текстови полета (text и textarea), намиращи се в същия формуляр. Това е по подразбиране.
  • Ако трябва да се преведат само едно или няколко полета, те се слагат, разделени с "|", примерно var v5_formfields = "ime|grad";
• var v5_skipfields = "skypeID";
  • (Ново!) За полетата (text и textarea), които да не се превеждат. Понякога е нужно да се преведат почти всички полета, без едно-две - така вместо горното изброяване на разрешените, тук просто се изброяват забранените.
  • Ако трябва да се забранят няколко полета, те се слагат, разделени с "|", примерно var v5_skipfields = "edno|dwe";
  • Ако дадено поле е едновременно в разрешените и в забранените, то не се превежда.
• var v5_popup = true;
  • За прозорчето с настройките. Може да е true или false.
  • По подразбиране е true, тоест подобно на тази страница, настройките се отварят в отделно прозорче, в което има и помощна информация за потребителите.
  • Ако се промени на false, настройките ще се правят на същото място, където е командното меню (подобно на страницата Писане на кирилица) без помощна информация. Също така, този вариант е добре да се прави от опитни хора, защото добавя доста нови полета в текущия формуляр, което може да разстрои някои чувствителни чужди скриптове.
• var v5_help = "http://5ko.free.fr/bg/help60rc2.html";
  • За файла с помощната информация за потребителите. Вика се в рамка (iframe) в прозорчето с настройките. Този файл е тук, на моя сайт; има и копие в архива; можете да посочите ваш собствен файл, но препоръчва се да го оставите така, защото при нова версия ще добавям по един ред с червени букви и ще бъдете автоматично уведомени. В тоя файл няма скриптове или програми, нищо не зависи от него.
• var v5_lang = 1;
  • За езика, 1 е български, 0 е английски. По подразбиране е на български. (Помощният файл не е преведен на английски.)
• var v5_skipwords = "html|Peugeot|hello";
  • (Ново) Ако държите някои (цели) думи да не се превеждат на кирилица (без значение малки-главни; не измежду командите за форуми, а в текста). По подразбиране всичко се превежда. (Заб.: bbCode и url-адреси за форуми така или иначе се пропускат, тук се въвеждат някои специфични думи за обикновен текст, за улеснение. Иначе могат да се ползват [ограничителите].)

В новата версия 6.0u-rc2 има възможност скриптът да се инсталира многократно в страницата (ако има такава нужда; и то в различните формуляри само по веднъж). Можете да въведете наново командата <script..., която е показана, но по следния начин е много по-бързо и лесно за браузърите:

<script type="text/javascript" language="javascript1.2"><!--
// тук някоя от горните команди, ако има нужда;
cyr5ko_reload(); //--></script>

(без другия код). Това презарежда скрипта (вместо да го сваля наново и да предефинира всичко) и добавя ново падащо меню.

Разните варианти ги има показани тук.

начало

Алгоритъм

Преводът от кирилица към латиница е много прост, затова съществуват доста програми, които се справят добре.

Обратният превод, от латиница към кирилица, е по-голяма играчка. Ето няколкото полезни "хватки", с които се постига това.

Преводът: най-напред се заместват със знака "таб" всички комбинации, които не трябва да се превеждат. Ако в текста има знаци "таб" (което е малко вероятно, но може да се случи при залепване), те се отбелязват. След това текстът се превежда на кирилица, след това всеки знак "таб" се замества обратно със съответната комбинация.

Буквите са сортирани според дължината на латинските съответствия и преводът започва от по-дългите към по-късите. По този начин е възможно да се преведат правилно комбинации като "sht" преди "sh" и преди "s", "iu" преди "i" или "u" и т.н. Първо се превеждат малките букви, а после главните, като SHT, Sht, SHt, или дори shT (понеже се различават от "sht"), ще дадат главна "Щ".

Бисквитката: ако не правите промени в настройките, а ги ползвате така, както са по подразбиране, нямате бисквитки. Ако направите промени, в бисквитка се записват само те, в този формат (това са моите): "..v....j...y..................w...iu/yu.ia/q/ya", тоест буквите са разделени с точки, вариантите с наклонена черта, а тези, които са както по подразбиране, са празни.

Ако имате въпроси по алгоритъма, пишете ми.

начало

Промени във версиите

Настоящата версия е 6.0u-rc2. Промени спрямо 6.0u-rc1:

• Скриптът вече може да се инсталира няколко пъти в една страница (много рядко може да се наложи);
• добавени настройки v5_skipfields и v5_skipwords;
• добавено cyr5ko_reload();
• при v5_formfields вместо запетайки, препоръчва се "|" - проверката се прави с регулярни изрази;
• доста дребни промени и подобрения;
• има нужда от още тестване.

начало

6.0u-rc1

След повече от година, ето какви промени има в новата версия 6.0u-rc1.

Това е "Release candidate", което означава, че е по-стабилна от бета-версиите, но не е изключено да се скапе. Ще ви помоля да я изпробвате с колкото можете повече браузъри и операционни системи и ако забележите нещо нередно, да ми съобщите.

• Уникод : понеже сайтът ми постепенно минава на UTF-8, се наложи да преработя скрипта така, че да работи. В момента ще превежда във всички възможни кодировки (cp1251, koi8-*, iso8859-5, utf-8).
  • Буквите се адресират по нов начин, като номерата им в Уникод; това оправя един гаден бъг за главни/малки букви.
  • Отново я няма руската буква "ё", понеже е по-сложно да се направи по тая система. Някой ден, като имам време...
• Опростяване на инсталацията: добавя се само един файл и само един ред.
• Промени в наименованията на функциите, променливите и бисквитките (може да се наложи отново да си настроите предпочитанията).
• Възможност да се избират за букви/ограничители знаците "/" и кавичка.
• Нова възможност за главни букви. Ако в избраната комбинация няма букви, а само знаци или цифри, за да се преведе като главна буква, се въвежда двукратно.
• Премахната е възможността за превод на шльокавица, въобще не виждам смисъл от такова нещо. Ако имате нужда от такава програма, идете на http://www.2cyr.com/?7, където преводът се прави по стандартните азбучни съответствия.
• Заради горното, е добавена функцията "Отмяна/Undo". При превод се запаметяват последните текстове, с тази команда могат да се възстановят (примерно при грешки).
• По подразбиране се превеждат всички текстови полета от текущия формуляр; това може да се регулира сравнително лесно.
• Възможност за настройки или в отделно прозорче (както беше преди, така остава по подразбиране), или направо в същата страница. Подобрения на функциите за запис.
• Понеже скриптът малко порастна, съм го компресирал с "packer"-а на Дийн Едуардс. Изходният код е приложен.

начало

Предишни версии

Версиите 5.x са в отделен клон, който изоставих и не са публикувани.

Версия 4.84 : няколко подобрения; по-лесна интеграция в "templates" като Smarty и други, които се ползват в някои форуми и сайтове.

Версия 4.8 : поддръжка на повечето от усмивките (:smileys:); козметични промени.

Версия 4.7 : Много подобрения в алгоритмите, стабилност, бързина. Нови възможности за форумите. Нови команди за ограничителите за латиница. Адреси на е-мейл и сайтове се разпознават и не се превеждат. Компактни команди от падащ списък. Руските букви "ы", "э", "ё".

Версия 3.04 : обратният превод от кирилица към латиница вече е възможен, със същите дефиниции.

начало