6894
Comment:
|
9800
stiletto — baaaaaaaaaaaka
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
<<Navigation(siblings)>> Добро пожаловать! В этой вики будет собираться документация по BNW. |
#acl All:read,write |
Line 4: | Line 3: |
'''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 6: | Line 7: |
Во многом аналогичным функционалом обладают и другие системы, такие как [[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 8: | Line 9: |
<<Anchor(register)>> | |
Line 9: | Line 11: |
На данный момент для того, чтобы создать аккаунт в бнваче, нужен джаббер-аккаунт. Это не большое ограничение, так как у всякого разумного пользователя интернетов он есть. В своём джаббер-клиенте добавляем контакт bnw.im (или bnw@bnw.im, если клиент ругается на неправильный screen name). Далее надо придумать себе ник, под которым вы хотите фигурировать в системе, предположим, vasya. Ники могут содержать латинские буквы и цифры, регистр не сохраняется. Далее отправляем сообщение | На данный момент для того, чтобы создать аккаунт в бнваче, нужен джаббер-аккаунт. Это не большое ограничение, так как у всякого разумного пользователя интернетов он есть. В своём джаббер-клиенте добавляем контакт [[xmpp:bnw.im|bnw.im]] (или [[xmpp:bnw@bnw.im|bnw@bnw.im]], если клиент ругается на неправильный jid). Далее надо придумать себе ник, под которым вы хотите фигурировать в системе, предположим, vasya. Ники могут содержать латинские буквы и цифры, регистр не сохраняется. Далее отправляем сообщение: |
Line 11: | Line 13: |
{{{register vasya}}} | {{{ register vasya }}} |
Line 13: | Line 17: |
своему контакту bnw.im Если этот ник ещё не занят, он будет зарегистрирован и привязан к вашему джаббер-аккаунту. Просто, правда? **ВНИМАНИЕ!** Выбирайте ник очень аккуратно, потому что на данный момент сменить ник у действующего блога невозможно и неизвестно, появится ли такая возможность когда-нибудь вообще. | своему контакту [[xmpp:bnw.im|bnw.im]]. Если этот ник ещё не занят, он будет зарегистрирован и привязан к вашему джаббер-аккаунту.<<BR>> '''ВНИМАНИЕ!''' Выбирайте ник очень аккуратно, потому что на данный момент сменить ник у действующего блога невозможно и неизвестно, появится ли такая возможность когда-нибудь вообще. |
Line 16: | Line 21: |
Постить новые сообщения, комментировать, подписываться на чужие блоги, тэги, клубы итп, отписываться, рекомендовать и добавлять в чёрный список можно, отправляя боту 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 18: | Line 23: |
{{{interface simplified}}} | {{{ interface simplified }}} |
Line 20: | Line 27: |
Каждый пост в любом блоге имеет свой уникальный идентификатор, состоящий из 6 латинских букв и цифр, например 0XYNTA. Каждый коммент к посту имеет дополнительный идентификатор из трёх букв или цифр, например 0XYNTA/F4G. Чтобы написать новый пост в красноглазом интерфейсе, (скажем, сообщение с текстом Hello, World!) нужно написать | Каждый пост в любом блоге имеет свой уникальный идентификатор, состоящий из 6 латинских букв и цифр, например {{{0XYNTA}}}. Каждый коммент к посту имеет дополнительный идентификатор из трёх букв или цифр, например, {{{0XYNTA/F4G}}}. Чтобы создать новый пост в красноглазом интерфейсе, скажем, сообщение с текстом {{{Hello, World!}}}, нужно написать: |
Line 22: | Line 29: |
{{{post Hello, World!}}} | {{{ post Hello, World! }}} |
Line 24: | Line 33: |
В упрощённом интерфейсе достаточно просто | В упрощённом интерфейсе достаточно: |
Line 26: | Line 35: |
{{{Hello, World!}}} | {{{ Hello, World! }}} |
Line 28: | Line 39: |
Чтобы ответить на пост или коммент, например на 0XYNTA/F4G, в красноглазом интерфейсе надо писать | Чтобы ответить на пост или коммент, например на {{{0XYNTA/F4G}}}, в красноглазом интерфейсе надо писать: |
Line 30: | Line 41: |
{{{comment -m 0XYNTA/F4G ответ}}} | {{{ comment -m 0XYNTA/F4G ответ }}} |
Line 34: | Line 47: |
{{{#0XYNTA/F4G ответ}}} | {{{ #0XYNTA/F4G ответ }}} |
Line 36: | Line 51: |
и так далее. Более-менее полную информацию по синтаксису команд можно получить в ответ на команду | Более-менее полную информацию по синтаксису команд можно получить в ответ на команду: |
Line 38: | Line 53: |
{{{help}}} | {{{ help }}} |
Line 40: | Line 57: |
в красноглазом интерфейсе или {{{HELP}}} в упрощённом, или в [[../Интерфейсы|соответствующих разделах]] этой вики. |
или в соответствующих разделах этой вики. |
Line 47: | Line 60: |
Самое замечательное, что для того, чтобы писать в бнвачик, даже не обязательно регистрироваться <<FootNote(ЛожЬ! post доступно только регистратам.)>. Красноглазый интерфейс позволяет постить и комментить анонимно, добавляя к командам post и comment параметр -a. Например, | Красноглазый интерфейс позволяет постить и комментить анонимно, добавляя к командам {{{post}}} и {{{comment}}} параметр {{{-a}}}. Например, |
Line 49: | Line 62: |
{{{ post -a We are the legion!}}} | {{{ post -a We are the legion! }}} |
Line 51: | Line 66: |
запостит новый пост. Автор всех анонимных постов обозначается как @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)>> |
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 /Форматирование |