Текстова кутия с шаблона Цитат уеб се показва най-отгоре на страницата при активиране на букмарклета. Тук показана е английската версия

WebRef.js е скрипт улесняващ попълването на шаблона {{цитат уеб}}. Скриптът се пуска директно на страницата която искате да цитирате. За пълно попълване на шаблона (основно за името на автора и датата) са необходими предварителни настройки за всеки сайт.

Можете да редактирате тази страница. Ако не ми хареса редакцията ви просто ще я коригирам. ;)

Как работи

редактиране

Скриптът е предвидено да се зарежда от ползвателите го чрез bookmarklet - отметка (bookmark), която съдържа изпълним Джаваскрипт код вместо адрес на уебстраница. При щракване върху такава отметка, кодът се изпълнява все едно е част от каквато уебстраница в момента е показана в браузъра. Затова, за да използвате скрипта, първо трябва да създадете букмарклет с кода, който е даден в следващия раздел.

Създаване на букмарклета

редактиране

Как можете да създадете букмарклет зависи от браузъра ви.

  • Във Firefox щракнете с десния бутон върху която и да е отметка (bookmark) и изберете New Bookmark, въведете име (напр. УебРеф) в съответното поле (Name), а Джаваскрипт кода в полето за адреса (Location).
  • В Internet Explorer можете да създадете отметка на която и да е старница по обичайния начин (Add to favorites), след това щракнете с десния бутон върху нея в менюто с отметките, изберете Properties, въведете Джаваскрипт кода в полето за адреса (URL), сменете името (в раздела General) на „УебРеф“ или нещо друго подходящо.
  • В Google Chrome и Opera - натиснете Ctrl+D и след това съответно бутона Edit или Properties, сменете името и адреса както по-горе.

Кодът, който трябва да използвате при създаването на букмарклета е следният:

javascript:(function(){var d=document,s=d.createElement('script');s.src='//bg.wikipedia.org/w/index.php?title=User:V111P/js/webRef.js&action=raw&ctype=text/javascript&smaxage=0&maxage=0';d.body.appendChild(s);})();

За напреднали - вместо горния код, който извиква директно основния скрипт (webRef.js.), можете да извиквате скрипт-файл, например във вашето потребителско пространство, съдържащ настройки за сайтовете които често използвате, който от своя страна пак вика основния скрипт. Вижте Потребител:V111P/js/webRefSiteDataExample.js за пример на файл с настройки и можете да го тествате с този код за букмарклета:

javascript:(function(){var d=document,s=d.createElement('script');s.src='//bg.wikipedia.org/w/index.php?title=User:V111P/js/webRefSiteDataExample.js&action=raw&ctype=text/javascript&smaxage=0&maxage=0';d.body.appendChild(s);})();

Използване на букмарклет-а

редактиране

След като сте създали букмарклета, както е описано в предходния раздел, можете да го използвате.

  1. Отваряте статията, която искате да цитирате
  2. Избирате отметката с букмарклета от менюто с отметки както бихте направили с обикновена отметка. (При щракване на обикновена отметка страницата се сменя, но не и при щракване на букмарклет-отметка.)
  3. В горната част на страницата се появява текстова кутия с (полу-)попълнен шаблон Цитат уеб.

Тестване без създаване на букмарклет

редактиране

Има и по-прост начин за тастване на скрипта, макар че не е удобен за изполване по принцип: (първо отваряте някоя статия в някой сайт,) отваряте конзолата на браузъра (Ctrl+Shift+K в Файърфокс, F12 в IE и Гугъл Хром, Ctrl+Shift+I в Опера) и изпълнявате там този код:

(function(){var d=document,s=d.createElement('script');s.src='//bg.wikipedia.org/w/index.php?title=User:V111P/js/webRef.js&action=raw&ctype=text/javascript&smaxage=0&maxage=0';d.body.appendChild(s);})();

Маркиран с мишката текст на страницата ще бъде използват за стойност на параметъра „цитат“. Във Файърфокс например чрез задържане на клавиша Ctrl дори можете да маркирате няколко отделни цитата, които ще бъдат съединени от скрипта с (...).

Настройване - за напреднали

редактиране

За автоматично пълно попълване на шаблона е необходима настройка за всеки сайт. Това става чрез бутона „Настройване“, който зарежда друг скрипт, webRefSetup.js. При това ще се покаже друг екран, който съдържа и малко помощна информация за това как точно става „настройването“.

В края на настройката се натиска бутона „Код! От формуляра - в текстовата кутия“. Полученият код за сайта може или да се запише в локалния склад (local storage) на браузъра (чрез бутона „Записване от текстовата кутия - в локалния склад“) или да се запише в специален файл, както е описано по-горе във втория случай от „Създаване на букмарклета“.

Първото е по-лесно, но недостатъците са, че скрипт от съответния сайт може да го изтрие, а също така ще работи само в съответния браузър (докато не изтриете информацията чрез опция от вида „Delete temporary files, history, cookies...“).

Вижте също en:User:V111P/js/WebRef#Extra words or characters in the values за премахване на ненужни части от стойностите.

Вижте също

редактиране