6868
Comment:
|
9878
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
Добро пожаловать! В этой вики будет собираться документация по BNW. | #acl All:read,write <<Navigation(children)>> Когаме слоны ебут батогами! |
Line 3: | Line 5: |
'''BNW''' (aka бээнвач или бнвач) - это система блогов, постинг в которой осуществляется через [[http://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol|XMPP]] протокол, более известный как Jabber. Иными словами, можно постить, комментить и получать сообщения и рекомендации из френдленты, используя только свой джаббер-клиент. Веб-интерфейс тоже есть, на данный момент он находится на http://bnw.im, выглядит как говно и не очень много умеет, но это со временем изменится. | = BnW = [[attachment:bnw.png|{{attachment:bnw_thumb.png|Главная BnW в 2012-ом году|align=right}}]] '''BnW''' (''бээнвач'', ''бнвач'') — это система блогов, постинг в которой осуществляется через протокол [[https://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol|XMPP]], более известный как Jabber. Иными словами, можно постить, комментить и получать сообщения и рекомендации из френдленты, используя только свой джаббер-клиент. Веб-интерфейс тоже есть, на данный момент он находится на https://bnw.im, выглядит как говно и не очень много умеет, но это со временем изменится. |
Line 5: | Line 9: |
Во многом аналогичным функционалом обладают и другие системы, такие как [[http://psto.net|Psto]] или [[http://juick.com|Juick]]. Главным отличием бнвача от них является открытость (система написана под [[http://git.blasux.ru/gw?p=bnwach.git;a=blob;f=COPYING|BSD-лицензией без третьего условия]] и исходники находятся в открытом доступе [[http://git.blasux.ru/gw?p=bnwach.git|здесь]]) и изначальный прицел на распределённость по нескольким серверам. Таким образом, пользователям не придётся зависеть от прихотей одного человека или коллектива разработчиков (пользователи того же Juick не понаслышке знают, каково это). | Во многом аналогичным функционалом обладают и другие системы, такие как [[http://juick.com|Juick]] и [[http://psto.net|Psto]]. Главным отличием бнвача от них является открытость ([[https://raw.github.com/stiletto/bnw/master/COPYING|BSD-лицензия без третьего условия]]) и изначальный прицел на распределённость по нескольким серверам. Таким образом, пользователям не придётся зависеть от прихотей одного человека или коллектива разработчиков (пользователи того же Juick не понаслышке знают, каково это). |
Line 7: | Line 11: |
<<Anchor(register)>> | |
Line 8: | Line 13: |
На данный момент для того, чтобы создать аккаунт в бнваче, нужен джаббер-аккаунт. Это не большое ограничение, так как у всякого разумного пользователя интернетов он есть. В своём джаббер-клиенте добавляем контакт bnw.im (или bnw@bnw.im, если клиент ругается на неправильный screen name). Далее надо придумать себе ник, под которым вы хотите фигурировать в системе, предположим, vasya. Ники могут содержать латинские буквы и цифры, регистр не сохраняется. Далее отправляем сообщение | На данный момент для того, чтобы создать аккаунт в бнваче, нужен джаббер-аккаунт. Это не большое ограничение, так как у всякого разумного пользователя интернетов он есть. В своём джаббер-клиенте добавляем контакт [[xmpp:bnw.im|bnw.im]] (или [[xmpp:bnw@bnw.im|bnw@bnw.im]], если клиент ругается на неправильный jid). Далее надо придумать себе ник, под которым вы хотите фигурировать в системе, предположим, vasya. Ники могут содержать латинские буквы и цифры, регистр не сохраняется. Далее отправляем сообщение: |
Line 10: | Line 15: |
{{{register vasya}}} | {{{ register vasya }}} |
Line 12: | Line 19: |
своему контакту bnw.im Если этот ник ещё не занят, он будет зарегистрирован и привязан к вашему джаббер-аккаунту. Просто, правда? **ВНИМАНИЕ!** Выбирайте ник очень аккуратно, потому что на данный момент сменить ник у действующего блога невозможно и неизвестно, появится ли такая возможность когда-нибудь вообще. | своему контакту [[xmpp:bnw.im|bnw.im]]. Если этот ник ещё не занят, он будет зарегистрирован и привязан к вашему джаббер-аккаунту.<<BR>> '''ВНИМАНИЕ!''' Выбирайте ник очень аккуратно, потому что на данный момент сменить ник у действующего блога невозможно и неизвестно, появится ли такая возможность когда-нибудь вообще. |
Line 15: | Line 23: |
Постить новые сообщения, комментировать, подписываться на чужие блоги, тэги, клубы итп, отписываться, рекомендовать и добавлять в чёрный список можно, отправляя боту bnw.blasux.ru команды в соответствие с [[../Интерфейсы|интерфейсами]]. Сейчас действуют два джаббер-интерфейса, отличающиеся в основном синтаксисом команд: [[../Интерфейсы/Красноглазый|красноглазый]], имитирующий [[http://en.wikipedia.org/wiki/Unix_shell|Unix Shell]], и [[../Интерфейсы/Juick-like|упрощённый]], с синтаксисом, привычным пользователям Juick и Psto. По умолчанию, после регистрации вы попадаете в красноглазый интерфейс. Чтобы переключиться в упрощённый, напишите боту | Постить новые сообщения, комментировать, подписываться на чужие блоги, тэги, клубы и т.п., отписываться, рекомендовать и добавлять в чёрный список можно, отправляя боту [[xmpp:bnw.im|bnw.im]] команды в соответствие с интерфейсами. Сейчас действуют два интерфейса, отличающиеся в основном синтаксисом команд: [[../BnW/Интерфейс_redeye|красноглазый]], имитирующий [[https://en.wikipedia.org/wiki/Unix_shell|Unix shell]], и [[../BnW/Интерфейс_simplified|упрощённый]], с синтаксисом привычным пользователям Juick и Psto. По умолчанию, после регистрации вы попадаете в красноглазый интерфейс. Чтобы переключиться в упрощённый, напишите боту: |
Line 17: | Line 25: |
{{{interface simplified}}} | {{{ interface simplified }}} |
Line 19: | Line 29: |
Каждый пост в любом блоге имеет свой уникальный идентификатор, состоящий из 6 латинских букв и цифр, например 0XYNTA. Каждый коммент к посту имеет дополнительный идентификатор из трёх букв или цифр, например 0XYNTA/F4G. Чтобы написать новый пост в красноглазом интерфейсе, (скажем, сообщение с текстом Hello, World!) нужно написать | Каждый пост в любом блоге имеет свой уникальный идентификатор, состоящий из 6 латинских букв и цифр, например {{{0XYNTA}}}. Каждый коммент к посту имеет дополнительный идентификатор из трёх букв или цифр, например, {{{0XYNTA/F4G}}}. Чтобы создать новый пост в красноглазом интерфейсе, скажем, сообщение с текстом {{{Hello, World!}}}, нужно написать: |
Line 21: | Line 31: |
{{{post Hello, World!}}} | {{{ post Hello, World! }}} |
Line 23: | Line 35: |
В упрощённом интерфейсе достаточно просто | В упрощённом интерфейсе достаточно: |
Line 25: | Line 37: |
{{{Hello, World!}}} | {{{ Hello, World! }}} |
Line 27: | Line 41: |
Чтобы ответить на пост или коммент, например на 0XYNTA/F4G, в красноглазом интерфейсе надо писать | Чтобы ответить на пост или коммент, например на {{{0XYNTA/F4G}}}, в красноглазом интерфейсе надо писать: |
Line 29: | Line 43: |
{{{comment -m 0XYNTA/F4G ответ}}} | {{{ comment -m 0XYNTA/F4G ответ }}} |
Line 33: | Line 49: |
{{{#0XYNTA/F4G ответ}}} | {{{ #0XYNTA/F4G ответ }}} |
Line 35: | Line 53: |
и так далее. Более-менее полную информацию по синтаксису команд можно получить в ответ на команду | Более-менее полную информацию по синтаксису команд можно получить в ответ на команду: |
Line 37: | Line 55: |
{{{help}}} | {{{ help }}} |
Line 39: | Line 59: |
в красноглазом интерфейсе или {{{HELP}}} в упрощённом, или в [[../Интерфейсы|соответствующих разделах]] этой вики. |
или в соответствующих разделах этой вики. |
Line 46: | Line 62: |
Самое замечательное, что для того, чтобы писать в бнвачик, даже не обязательно регистрироваться <<FootNote(ЛожЬ! post доступно только регистратам.)>. Красноглазый интерфейс позволяет постить и комментить анонимно, добавляя к командам post и comment параметр -a. Например, | Красноглазый интерфейс позволяет постить и комментить анонимно, добавляя к командам {{{post}}} и {{{comment}}} параметр {{{-a}}}. Например, |
Line 48: | Line 64: |
{{{ post -a We are the legion!}}} | {{{ post -a We are the legion! }}} |
Line 50: | Line 68: |
запостит новый пост. Автор всех анонимных постов обозначается как @anonymous. Таким образом, [[http://bnw.im/u/anonymous|блог Анонимуса]] можно использовать, помимо прочего, в качестве некоторого подобия имажборды. | создаст новый пост от пользователя {{{@anonymous}}}. Таким образом, [[https://bnw.im/u/anonymous|блог анонимуса]] можно использовать, помимо прочего, в качестве некоторого подобия имиджборды. == Рекомендации == Для того, чтобы рекомендовать пост {{{0XYNTA}}} своим подписчикам, в красноглазом интерфейсе используйте команду: {{{ recommend 0XYNTA }}} или: {{{ ! #0XYNTA }}} в упрощённом. Также имеется возможность снабдить рекомендацию комментарием. См. справку в соответстующих разделах. <<Anchor(formatting)>> == Форматирование == Форматирование постов доступно в вебе и клиентах, поддерживающих [[http://xmpp.org/extensions/xep-0071.html|XHTML-IM XEP]]<<FootNote(Запланировано.)>>. В остальных джаббер-клиентах сообщение отобразится в том виде, в котором его написали. Используется следующий синтаксис: * ''//курсив//'' * '''**полужирный**''' * {{{[[http://url |текст]]}}} отображается как [[http://url|текст]]<<FootNote(Рекомендуется ставить пробел перед «|», т.к. он входит в допустимые символы ссылки и в текстовом виде возможны проблемы с отображением.)>> * `{{{#!язык_программирования код}}}` подсветка кода, используя [[http://softwaremaniacs.org/soft/highlight/|highlight.js]]; можно не указывать язык программирования: `{{{код}}}` См. также [[../BnW/posts_formatting_proposal|план по внедрению дополнительного форматирования]]. == HTTPS == Веб-морда доступна по HTTPS, сертификат старткомовский, есть во всех браузерах. Установите опцию {{{baseurl}}} в значение {{{https}}}, чтобы BnW выдавал вам только безопасные ссылки: {{{ set baseurl https }}} Также рекомендуется использовать расширение для браузеров [[https://www.eff.org/https-everywhere/|HTTPS Everywhere]] с [[https://github.com/Kagami/https-everywhere/commit/1baa47ebaa80db23275a228f2a004e47474ef313|этим]] правилом<<FootNote(Для Firefox файл с правилом следует поместить в каталог {{{~/.mozilla/firefox/<user profile>/HTTPSEverywhereUserRules/}}})>> (пока его не примут в апстрим), чтобы для соединения с bnw.im всегда использовалось защищённое соединение, даже если ссылку вам дали с http. == Разработка == * [[https://github.com/stiletto/bnw|Репозиторий проекта]] * [[https://github.com/stiletto/bnw/issues?state=open|Багтрекер]] * [[http://bnw.reformal.ru/|Идеи и отзывы на реформале]] (заброшено) == Прочее == * BnW использует JSON [[../BnW/API|API]] с синтаксисом похожим на красноглазый интерфейс * [[../BnW/Установка_BnW_на_Linux|Установка BnW на Linux]] <<Navigation(children)>> |
/API /RESTfulDraft /help_simplified /posts_formatting_proposal /Интерфейс_redeye /Интерфейс_simplified /Список_команд /Установка_BnW_на_Linux /Форматирование |
BnW
BnW (бээнвач, бнвач) — это система блогов, постинг в которой осуществляется через протокол XMPP, более известный как Jabber. Иными словами, можно постить, комментить и получать сообщения и рекомендации из френдленты, используя только свой джаббер-клиент. Веб-интерфейс тоже есть, на данный момент он находится на https://bnw.im, выглядит как говно и не очень много умеет, но это со временем изменится.
Во многом аналогичным функционалом обладают и другие системы, такие как Juick и Psto. Главным отличием бнвача от них является открытость (BSD-лицензия без третьего условия) и изначальный прицел на распределённость по нескольким серверам. Таким образом, пользователям не придётся зависеть от прихотей одного человека или коллектива разработчиков (пользователи того же Juick не понаслышке знают, каково это).
Регистрация
На данный момент для того, чтобы создать аккаунт в бнваче, нужен джаббер-аккаунт. Это не большое ограничение, так как у всякого разумного пользователя интернетов он есть. В своём джаббер-клиенте добавляем контакт bnw.im (или bnw@bnw.im, если клиент ругается на неправильный jid). Далее надо придумать себе ник, под которым вы хотите фигурировать в системе, предположим, vasya. Ники могут содержать латинские буквы и цифры, регистр не сохраняется. Далее отправляем сообщение:
register vasya
своему контакту bnw.im. Если этот ник ещё не занят, он будет зарегистрирован и привязан к вашему джаббер-аккаунту.
ВНИМАНИЕ! Выбирайте ник очень аккуратно, потому что на данный момент сменить ник у действующего блога невозможно и неизвестно, появится ли такая возможность когда-нибудь вообще.
Постинг
Постить новые сообщения, комментировать, подписываться на чужие блоги, тэги, клубы и т.п., отписываться, рекомендовать и добавлять в чёрный список можно, отправляя боту bnw.im команды в соответствие с интерфейсами. Сейчас действуют два интерфейса, отличающиеся в основном синтаксисом команд: красноглазый, имитирующий Unix shell, и упрощённый, с синтаксисом привычным пользователям Juick и Psto. По умолчанию, после регистрации вы попадаете в красноглазый интерфейс. Чтобы переключиться в упрощённый, напишите боту:
interface simplified
Каждый пост в любом блоге имеет свой уникальный идентификатор, состоящий из 6 латинских букв и цифр, например 0XYNTA. Каждый коммент к посту имеет дополнительный идентификатор из трёх букв или цифр, например, 0XYNTA/F4G. Чтобы создать новый пост в красноглазом интерфейсе, скажем, сообщение с текстом Hello, World!, нужно написать:
post Hello, World!
В упрощённом интерфейсе достаточно:
Hello, World!
Чтобы ответить на пост или коммент, например на 0XYNTA/F4G, в красноглазом интерфейсе надо писать:
comment -m 0XYNTA/F4G ответ
В упрощённом:
#0XYNTA/F4G ответ
Более-менее полную информацию по синтаксису команд можно получить в ответ на команду:
help
или в соответствующих разделах этой вики.
Анонимный постинг
Красноглазый интерфейс позволяет постить и комментить анонимно, добавляя к командам post и comment параметр -a. Например,
post -a We are the legion!
создаст новый пост от пользователя @anonymous. Таким образом, блог анонимуса можно использовать, помимо прочего, в качестве некоторого подобия имиджборды.
Рекомендации
Для того, чтобы рекомендовать пост 0XYNTA своим подписчикам, в красноглазом интерфейсе используйте команду:
recommend 0XYNTA
или:
! #0XYNTA
в упрощённом. Также имеется возможность снабдить рекомендацию комментарием. См. справку в соответстующих разделах.
Форматирование
Форматирование постов доступно в вебе и клиентах, поддерживающих XHTML-IM XEP1. В остальных джаббер-клиентах сообщение отобразится в том виде, в котором его написали. Используется следующий синтаксис:
//курсив//
**полужирный**
{{{#!язык_программирования код}}} подсветка кода, используя highlight.js; можно не указывать язык программирования: {{{код}}}
См. также план по внедрению дополнительного форматирования.
HTTPS
Веб-морда доступна по HTTPS, сертификат старткомовский, есть во всех браузерах. Установите опцию baseurl в значение https, чтобы BnW выдавал вам только безопасные ссылки:
set baseurl https
Также рекомендуется использовать расширение для браузеров HTTPS Everywhere с этим правилом3 (пока его не примут в апстрим), чтобы для соединения с bnw.im всегда использовалось защищённое соединение, даже если ссылку вам дали с http.
Разработка
Идеи и отзывы на реформале (заброшено)
Прочее
BnW использует JSON API с синтаксисом похожим на красноглазый интерфейс
/API /RESTfulDraft /help_simplified /posts_formatting_proposal /Интерфейс_redeye /Интерфейс_simplified /Список_команд /Установка_BnW_на_Linux /Форматирование |