|
Size: 6857
Comment:
|
Size: 8525
Comment: syntax update
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| Добро пожаловать! В этой вики будет собираться документация по BNW. | #acl All:read,write |
| Line 3: | 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 5: | 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 7: | Line 9: |
| =====Регистрация===== На данный момент для того, чтобы создать аккаунт в бнваче, нужен джаббер-аккаунт. Это не большое ограничение, так как у всякого разумного пользователя интернетов он есть. В своём джаббер-клиенте добавляем контакт bnw.im (или bnw@bnw.im, если клиент ругается на неправильный screen name). Далее надо придумать себе ник, под которым вы хотите фигурировать в системе, предположим, vasya. Ники могут содержать латинские буквы и цифры, регистр не сохраняется. Далее отправляем сообщение |
<<Anchor(register)>> == Регистрация == На данный момент для того, чтобы создать аккаунт в бнваче, нужен джаббер-аккаунт. Это не большое ограничение, так как у всякого разумного пользователя интернетов он есть. В своём джаббер-клиенте добавляем контакт [[xmpp:bnw.im|bnw.im]] (или [[xmpp:bnw@bnw.im|bnw@bnw.im]], если клиент ругается на неправильный jid). Далее надо придумать себе ник, под которым вы хотите фигурировать в системе, предположим, vasya. Ники могут содержать латинские буквы и цифры, регистр не сохраняется. Далее отправляем сообщение: |
| Line 10: | Line 13: |
| <code>register vasya</code> | {{{ register vasya }}} |
| Line 12: | Line 17: |
| своему контакту bnw.im Если этот ник ещё не занят, он будет зарегистрирован и привязан к вашему джаббер-аккаунту. Просто, правда? **ВНИМАНИЕ!** Выбирайте ник очень аккуратно, потому что на данный момент сменить ник у действующего блога невозможно и неизвестно, появится ли такая возможность когда-нибудь вообще. | своему контакту [[xmpp:bnw.im|bnw.im]]. Если этот ник ещё не занят, он будет зарегистрирован и привязан к вашему джаббер-аккаунту.<<BR>> '''ВНИМАНИЕ!''' Выбирайте ник очень аккуратно, потому что на данный момент сменить ник у действующего блога невозможно и неизвестно, появится ли такая возможность когда-нибудь вообще. |
| Line 14: | Line 20: |
| =====Постинг===== Постить новые сообщения, комментировать, подписываться на чужие блоги, тэги, клубы итп, отписываться, рекомендовать и добавлять в чёрный список можно, отправляя боту 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 23: |
| <code>interface simplified</code> | {{{ interface simplified }}} |
| Line 19: | Line 27: |
| Каждый пост в любом блоге имеет свой уникальный идентификатор, состоящий из 6 латинских букв и цифр, например 0XYNTA. Каждый коммент к посту имеет дополнительный идентификатор из трёх букв или цифр, например 0XYNTA/F4G. Чтобы написать новый пост в красноглазом интерфейсе, (скажем, сообщение с текстом Hello, World!) нужно написать | Каждый пост в любом блоге имеет свой уникальный идентификатор, состоящий из 6 латинских букв и цифр, например {{{0XYNTA}}}. Каждый коммент к посту имеет дополнительный идентификатор из трёх букв или цифр, например, {{{0XYNTA/F4G}}}. Чтобы создать новый пост в красноглазом интерфейсе, скажем, сообщение с текстом {{{Hello, World!}}}, нужно написать: |
| Line 21: | Line 29: |
| <code>post Hello, World!</code> | {{{ post Hello, World! }}} |
| Line 23: | Line 33: |
| В упрощённом интерфейсе достаточно просто | В упрощённом интерфейсе достаточно: |
| Line 25: | Line 35: |
| <code>Hello, World!</code> | {{{ Hello, World! }}} |
| Line 27: | Line 39: |
| Чтобы ответить на пост или коммент, например на 0XYNTA/F4G, в красноглазом интерфейсе надо писать | Чтобы ответить на пост или коммент, например на {{{0XYNTA/F4G}}}, в красноглазом интерфейсе надо писать: |
| Line 29: | Line 41: |
| <code>comment -m 0XYNTA/F4G ответ</code> | {{{ comment -m 0XYNTA/F4G ответ }}} |
| Line 33: | Line 47: |
| <code>#0XYNTA/F4G ответ</code> | {{{ #0XYNTA/F4G ответ }}} |
| Line 35: | Line 51: |
| и так далее. Более-менее полную информацию по синтаксису команд можно получить в ответ на команду | Более-менее полную информацию по синтаксису команд можно получить в ответ на команду: |
| Line 37: | Line 53: |
| <code>help</code> | {{{ help }}} |
| Line 39: | Line 57: |
| в красноглазом интерфейсе или | или в соответствующих разделах этой вики. |
| Line 41: | Line 59: |
| <code>HELP</code> | == Анонимный постинг == Красноглазый интерфейс позволяет постить и комментить анонимно, добавляя к командам {{{post}}} и {{{comment}}} параметр {{{-a}}}. Например, |
| Line 43: | Line 62: |
| в упрощённом, или в [[Интерфейсы|соответствующих разделах]] этой вики. | {{{ post -a We are the legion! }}} |
| Line 45: | Line 66: |
| ===== Анонимный постинг ===== Самое замечательное, что для того, чтобы писать в бнвачик, даже не обязательно регистрироваться. Красноглазый интерфейс позволяет постить и комментить анонимно, добавляя к командам post и comment параметр -a. Например, |
создаст новый пост от пользователя {{{@anonymous}}}. Таким образом, [[https://bnw.im/u/anonymous|блог анонимуса]] можно использовать, помимо прочего, в качестве некоторого подобия имиджборды. |
| Line 48: | Line 68: |
| <code> post -a We are the legion! </code> | == Рекомендации == Для того, чтобы рекомендовать пост {{{0XYNTA}}} своим подписчикам, в красноглазом интерфейсе используйте команду: |
| Line 50: | Line 71: |
| запостит новый пост. Автор всех анонимных постов обозначается как @anonymous. Таким образом, [[http://bnw.blasux.ru/u/anonymous|блог Анонимуса]] можно использовать, помимо прочего, в качестве некоторого подобия имажборды. | {{{ recommend 0XYNTA }}} или: {{{ ! #0XYNTA }}} в упрощённом. Также имеется возможность снабдить рекомендацию комментарием. См. справку в соответстующих разделах. == 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 [[/API|API]] с синтаксисом похожим на красноглазый интерфейс * [[/Установка_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
в упрощённом. Также имеется возможность снабдить рекомендацию комментарием. См. справку в соответстующих разделах.
HTTPS
Веб-морда доступна по HTTPS, сертификат старткомовский, есть во всех браузерах. Установите опцию baseurl в значение https, чтобы BnW выдавал вам только безопасные ссылки:
set --baseurl=https
Также рекомендуется использовать расширение для браузеров HTTPS Everywhere с этим правилом1 (пока его не примут в апстрим), чтобы для соединения с bnw.im всегда использовалось защищённое соединение, даже если ссылку вам дали с http.
Разработка
Идеи и отзывы на реформале (заброшено)
См. также
BnW использует JSON API с синтаксисом похожим на красноглазый интерфейс
| /API /RESTfulDraft /help_simplified /posts_formatting_proposal /Интерфейс_redeye /Интерфейс_simplified /Список_команд /Установка_BnW_на_Linux /Форматирование |
Для Firefox файл с правилом следует поместить в каталог ~/.mozilla/firefox/<user profile>/HTTPSEverywhereUserRules/ (1)