Originally posted by [info]igrick at Инструкция по применению LJ-тегов

Folks, когда мы запустили lj-like, некоторые пользователи попросили сделать описание всех доступных LJ-тегов, и я пообещал его сделать. К сожалению, руки дошли только сейчас, но я надеюсь, что еще не поздно и оно будет вам полезно.


Итак, с помощью различных lj-тегов вы можете:


Скрыть часть записи для френдленты и дневника, или убрать под кат


 

<lj-cut [text="Заголовок"]> ... Скрываемый текст ... [</lj-cut>]

 


Данная конструкция позволяет убрать часть записи из отображения во френдленте и дневнике с установкой ссылки внутрь записи, где она отображается полностью, или, если говорить проще - lj-cut позволяет делать ссылку «подробнее», разделяя запись на ее анонс и полную версию. Самое распространенное применение — перенос «под кат» всех, кроме первой, фотографий в каком-нибудь репортаже или отчете от путешествии. При длинных записях крайне рекомендуется к применению, так как значительно упрощает чтение дневника и френдлент для друзей.


Особенности:



  • применение возможно только в записях;

  • не имеет эффекта на странице самой записи;

  • при переходе на определенную ветку комментариев в записи (thread) текст самой записи отображается до первого lj-cut, если он имеется.


Примеры:


 

<lj-cut />
Скрывает весь текст, идущий после тега, а сама ссылка будет называться «Читать далее» (или «Read more» в английской локализации);

 


 

<lj-cut text="Все фотографии, 20Мб" />
Скрывает весь текст, идущий после тега, а сама ссылка будет называться «Все фотографии, 20Мб»;

 


 

<lj-cut text="Подробности">скрываемая часть записи</lj-cut>
Скрывает часть записи, идущую после открывающего и до закрывающего тегов, ссылка при этом будет называться «Подробности»;

 



Упомянуть пользователя или сообщество LiveJournal


 

<lj user="username" [title="альтернативное имя"] />

 


Наболее правильный способ сделать ссылку на другой журнал или сообщество, так как LiveJournal в данном случае выведет ее со всеми вспомогательными элементам, а именно с головастиком и ссылкой на профиль, правильным именем и ссылкой на журнал, контекстным меню и памяткой (доступно только платным аккаунтам), если она установлена у читающего. Также с помощью параметра title можно заменить название дневника на произвольный текст.


Особенности:



  • применение возможно в записях, комментариях, профиле, стилях S2 и в личных сообщениях;

  • при переименовании дневника автоматически заменяется на новое имя во всех предыдущих упоминаниях;

  • закрывающий тег не требуется.


Примеры:


 

<lj user="igrick" /> — [info]igrick

 


 

<lj user="igrick" title="Илья" /> — [info]Илья

 


 

<lj user="ridus-news" /> — [info]ridus_news

 


 

<lj user="ridus-news" title="Сообщество гражданской журналистики" /> — [info]Сообщество гражданской журналистики

 



Вставить кнопку для быстрой публикации копии записи, т.е. для создания «репостов»


 

<lj-repost [button="название кнопки"]> [ ... текст записи </lj-repost>]

 


Позволяет вставить кнопку быстрого создания копии записи у читателя, а если проще — кнопку репоста, которая будет содержать весь или выбранный автором текст исходной записи и ссылку на оригинал. При включенной опции PingBack в исходную запись автора будут приходит комментарии с указанием ссылок на «репосты».


Особенности:



  • применение возможно только в записях;

  • кнопка устанавливается в месте закрывающего тега, если выбран фрагмент записи;

  • кнопка устанавливает в месте открывающего тега, если фрагмент не определен, т.е. для «репоста» выбрана вся запись;

  • если фрагмент не определен, тогда каждый «репост» публикуется вместе с самой кнопкой, сохраняющей адрес оригинала;

  • не все lj-теги могут наследоваться при «репостах».


Примеры:


 

<lj-repost />
Вставляет кнопку с именем «repost» для «репоста» записи целиком;

 


 

<lj-repost button="Поделиться с друзьями" />
Вставляет кнопку с текстом «Поделиться с друзьями» для «репоста» записи целиком;

 


 

Начало-Записи... <lj-repost button="Поделиться"> ...Середина-Записи...</lj-repost> ...Конец-Записи
Вставляет кнопку с текстом «Поделиться» для «репоста» части записи, в данном случае текста «Середина-Записи», при этом кнопка будет вставлена между «Середина-Записи» и «Конец-Записи»

 




Вставить в запись кнопки от социальных сетей


 

<lj-like [buttons="facebook, google, vkontakte, twitter1, livejournal1, ..."] />

 


Позволяет вставить популярные кнопки от различных социальных сетей, а именно, на момент написание данной записи (в скобках указано имя для параметра buttons):



  • «Recommend» от FaceBook (facebook или fb);

  • «+1» от Google (google или go);

  • «♥» от vKontakte (vkontakte или vk);

  • «Tweet» от Twitter1 (twitter или tw);

  • «+10 ЖЖетонов» от LiveJournal1 (livejournal или lj);


Особенности:



  • применение возможно только в записях;

  • порядок упоминания в параметре buttons влияет на порядок вывода кнопок;

  • при отсутствии параметра buttons будут выведены все кнопки, доступные для региона автора, т.е. при внедрении новых кнопок в последующих обновлениях LiveJournal они автоматически появятся в старых записях;

  • закрывающий тег не требуется.


Примеры:


 

<lj-like />
Вставит все доступные по умолчанию кнопки для региона автора записи;

 


 

<lj-like buttons="vkontakte" />
Вставит только одну кнопку от vKontakte независимо от региона автора;

 


 

<lj-like buttons="google, facebook" />
Вставит две кнопки — «+1» от Google и «Recommend» от FaceBook, именно в данной последовательности и независимо от региона автора;

 


1 — станет доступно начиная с обновления LiveJournal v.81, текущую версию смотрите в подвале главной страницы.



Вставить в запись интерактивную карту


 

<lj-map url="адрес-карты" [width="W"] [height="H"] />

 


Позволяет встроить в запись интерактивную карту от Яндекс или Google. Для вставки необходимо зайти на один из вышеупомянутых сервисов и сгенерировать ссылку на требуемый фрагмент карты.


Особенности:



  • на момент написания этой записи поддерживается только Яндекс и Google;

  • не все персональные настройки карты могут быть перенесены в запись, так как это зависит от способа формирования URL-фрагмента конкретного сервиса;

  • применимо как в записях, так и в комментариях;

  • закрывающий тег не требуется.


Примеры:


 

<lj-map url="maps.google.com/maps?saddr=%D0%BA%D0%B8%D0%BD%D...; width="800" height="600" />

Вставит карту от Google, показывающую пеший маршрут от кинотеатра «Пушкинский» до станции метро «Арбатская», а именно:

</lj-map>

 



Вставить в запись разрешенный embed


 

<lj-embed [width="W"] [height="H"]>embed-код</lj-embed>

 


Позволяет вставить любой разрешенный embed, использующий iFrame или Flash. Применять тег имеет смысл только в том случае, если необходимо проконтролировать ширину и высоту embed'а, т.е. задать параметры width и height. Во всех остальных случаях, т.е. когда embed вставляется без обрамляющих тегов, данные теги добавляются автоматически с автоопределением ширины и высоты.


 

<lj-embed width="640" height="390"><iframe  src="www.youtube.com/embed/WdVT0EWBtW8"; frameborder="0" allowfullscreen></iframe></lj-embed>

Вставит в ЖЖ клип «Потап и Настя - Чумачечая Весна», т.е.:
 

 



Создать и вставить в запись опрос


 


<lj-poll [name="имя опроса"] [whovote="кто может голосовать"] [whoview="кто может видеть результаты"]>

    <lj-pq type="тип опроса">

    Текст вопроса

        <lj-pi>1-ый вариант ответа</lj-pi>

        <lj-pi>2-й вариант ответа</lj-pi>

        <lj-pi>3-ый вариант ответа</lj-pi>

        <lj-pi>...</lj-pi>

        <lj-pi>N-ый вариант ответа</lj-pi>

    </lj-pq>

</lj-poll>

 


Позволяет вставить в запись новый опрос (доступно только платным пользователям и в платных сообществах). Ввиду того, что построить опрос вручную, т.е. путем конфигурации тегов, достаточно сложно, я не буду останаливаться подробно на их типах, но крайне рекомендую использовать для его этого специальный визард — www.livejournal.com/poll/create.bml


Пример:


 

<lj-poll whovote="all" whoview="all"><lj-pq type="radio">Есть ли жизнь на Марсе?<lj-pi>Есть</lj-pi><lj-pi>Нет</lj-pi><lj-pi>Науке это еще неизвестно</lj-pi></lj-pq></lj-poll>


Вставит в запись риторический вопрос про жизнь на Марсе.

 




Отключить автоформатирование для всей записи или ее части


 

<lj-raw>текст</lj-raw>

 


Позволяет отключить автоформатирование, что в основном касается переносов строк, для всего текста записи или его части, помещенной между открывающим и закрывающим тегом. Полезно для тех пользователей, которые используют HTML для оформления своих записей, так как дает контроль над тем, что LiveJournal попытается преобразовать, а что нет. Вся данная запись написано с lj-raw от начала и до конца.




Создать запись на нескольких языках


 


<lj-lang-container>

    [<lj-lang include="буквенный код языка, ...">текст для выбранного языка</lj-lang>]

    ...

    <lj-lang otherwise>текст по умолчанию при отсутствии определенного языка</lj-lang>

</lj-lang-container>

 


Позволяет создавать локализованные под выбранные языки записи, т.е. текст записи или его часть будет выводиться в зависимости от настроек языка интерфейса читающего для авторизованного и региона и настроек браузера неавторизованного пользователя. Для составления тега необходимо определить текст по умолчанию, т.е. тот, что будет показан в случае, если контейнер не содержит определение языка, с которым пришел пользователь, и опционально перечислить все поддерживаемые. Если проще — пример — для русскоязычных авторов правильно определять кирилические языки в основном теге и английский в otherwise (см. пример ниже).


Внимание! Данная возможность находится в разработке и на данный момент не готова к массовому и публичному использованию. Запросы по ее некорректной работы Службой поддержки LiveJournal не принимаются, так что использовать ее можно только на свой страх и риск. О том, когда данный тег станет официально поддерживаться в LiveJournal, я сообщу отдельно.


Пример:


 


<lj-lang-container>

    <lj-lang include="ru, ua">Добро пожаловать!</lj-lang>

    <lj-lang include="en">Welcome!</lj-lang>

    <lj-lang include="de">Willkommen!</lj-lang>

    <lj-lang include="it">Benvenuto!</lj-lang>

    <lj-lang include="ch">



@темы: помощь, faq, LJ-теги