welcome: please sign in
location: Diff for "u/Stiletto/BnW"
Differences between revisions 9 and 36 (spanning 27 versions)
⇤ ← Revision 9 as of 2012-07-09 21:57:08 →
Size: 6628
Editor: Kagami
Comment: Фиксы
← Revision 36 as of 2012-11-24 20:20:29 → ⇥
Size: 9729
Editor: anonymous
Comment: подсветка кода
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
<<Navigation(siblings)>>
Добро пожаловать! В этой вики будет собираться документация по BNW.		 = 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 4: Line 5:
'''BNW''' (aka бээнвач или бнвач) — это система блогов, постинг в которой осуществляется через [[https://en.wikipedia.org/wiki/Extensible_Messaging_and_Presence_Protocol|XMPP]] протокол, более известный как Jabber. Иными словами, можно постить, комментить и получать сообщения и рекомендации из френдленты, используя только свой джаббер-клиент. Веб-интерфейс тоже есть, на данный момент он находится на https://bnw.im, выглядит как говно и не очень много умеет, но это со временем изменится. Во многом аналогичным функционалом обладают и другие системы, такие как [[http://juick.com|Juick]] и [[http://psto.net|Psto]]. Главным отличием бнвача от них является открытость ([[https://raw.github.com/stiletto/bnw/master/COPYING|BSD-лицензия без третьего условия]]) и изначальный прицел на распределённость по нескольким серверам. Таким образом, пользователям не придётся зависеть от прихотей одного человека или коллектива разработчиков (пользователи того же Juick не понаслышке знают, каково это).
Line 6: Line 7:
Во многом аналогичным функционалом обладают и другие системы, такие как [[http://psto.net|Psto]] или [[http://juick.com|Juick]]. Главным отличием бнвача от них является открытость (система написана под [[https://raw.github.com/stiletto/bnw/master/COPYING|BSD-лицензией без третьего условия]] и исходники находятся в открытом доступе [[https://github.com/stiletto/bnw|здесь]]) и изначальный прицел на распределённость по нескольким серверам. Таким образом, пользователям не придётся зависеть от прихотей одного человека или коллектива разработчиков (пользователи того же Juick не понаслышке знают, каково это). <<Anchor(register)>>
== Регистрация ==
На данный момент для того, чтобы создать аккаунт в бнваче, нужен джаббер-аккаунт. Это не большое ограничение, так как у всякого разумного пользователя интернетов он есть. В своём джаббер-клиенте добавляем контакт [[xmpp:bnw.im|bnw.im]] (или [[xmpp:bnw@bnw.im|bnw@bnw.im]], если клиент ругается на неправильный jid). Далее надо придумать себе ник, под которым вы хотите фигурировать в системе, предположим, vasya. Ники могут содержать латинские буквы и цифры, регистр не сохраняется. Далее отправляем сообщение:
Line 8: Line 11:
== Регистрация ==
На данный момент для того, чтобы создать аккаунт в бнваче, нужен джаббер-аккаунт. Это не большое ограничение, так как у всякого разумного пользователя интернетов он есть. В своём джаббер-клиенте добавляем контакт bnw.im (или xmpp:bnw@bnw.im, если клиент ругается на неправильный jid). Далее надо придумать себе ник, под которым вы хотите фигурировать в системе, предположим, vasya. Ники могут содержать латинские буквы и цифры, регистр не сохраняется. Далее отправляем сообщение		 {{{
register vasya
}}}
Line 11: Line 15:
{{{register vasya}}}

своему контакту bnw.im. Если этот ник ещё не занят, он будет зарегистрирован и привязан к вашему джаббер-аккаунту. Просто, правда?		 своему контакту [[xmpp:bnw.im|bnw.im]]. Если этот ник ещё не занят, он будет зарегистрирован и привязан к вашему джаббер-аккаунту.<<BR>>
Line 17: Line 19:
Постить новые сообщения, комментировать, подписываться на чужие блоги, тэги, клубы и т.п., отписываться, рекомендовать и добавлять в чёрный список можно, отправляя боту bnw.im команды в соответствие с [[../Интерфейсы|интерфейсами]]. Сейчас действуют два джаббер-интерфейса, отличающиеся в основном синтаксисом команд: [[../Интерфейсы/Красноглазый|красноглазый]], имитирующий [[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 19: Line 21:
{{{interface simplified}}} {{{
interface simplified
}}}
Line 21: Line 25:
Каждый пост в любом блоге имеет свой уникальный идентификатор, состоящий из 6 латинских букв и цифр, например 0XYNTA. Каждый коммент к посту имеет дополнительный идентификатор из трёх букв или цифр, например, 0XYNTA/F4G. Чтобы написать новый пост в красноглазом интерфейсе, (скажем, сообщение с текстом Hello, World!) нужно написать Каждый пост в любом блоге имеет свой уникальный идентификатор, состоящий из 6 латинских букв и цифр, например {{{0XYNTA}}}. Каждый коммент к посту имеет дополнительный идентификатор из трёх букв или цифр, например, {{{0XYNTA/F4G}}}. Чтобы создать новый пост в красноглазом интерфейсе, скажем, сообщение с текстом {{{Hello, World!}}}, нужно написать:
Line 23: Line 27:
{{{post Hello, World!}}} {{{
post Hello, World!
}}}
Line 25: Line 31:
В упрощённом интерфейсе достаточно просто В упрощённом интерфейсе достаточно:
Line 27: Line 33:
{{{Hello, World!}}} {{{
Hello, World!
}}}
Line 29: Line 37:
Чтобы ответить на пост или коммент, например на 0XYNTA/F4G, в красноглазом интерфейсе надо писать Чтобы ответить на пост или коммент, например на {{{0XYNTA/F4G}}}, в красноглазом интерфейсе надо писать:
Line 31: Line 39:
{{{comment -m 0XYNTA/F4G ответ}}} {{{
comment -m 0XYNTA/F4G ответ
}}}
Line 35: Line 45:
{{{#0XYNTA/F4G ответ}}} {{{
#0XYNTA/F4G ответ
}}}
Line 37: Line 49:
и так далее. Более-менее полную информацию по синтаксису команд можно получить в ответ на команду  Более-менее полную информацию по синтаксису команд можно получить в ответ на команду:
Line 39: Line 51:
{{{help}}} {{{
help
}}}
Line 41: Line 55:
в красноглазом интерфейсе или

{{{HELP}}}

в упрощённом, или в [[../Интерфейсы|соответствующих разделах]] этой вики.		 или в соответствующих разделах этой вики.
Line 48: Line 58:
Красноглазый интерфейс позволяет постить и комментить анонимно, добавляя к командам post и comment параметр -a. Например, Красноглазый интерфейс позволяет постить и комментить анонимно, добавляя к командам {{{post}}} и {{{comment}}} параметр {{{-a}}}. Например,
Line 50: Line 60:
{{{post -a We are the legion!}}} {{{
post -a We are the legion!
}}}
Line 52: Line 64:
запостит новый пост. Автор всех анонимных постов обозначается как @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/fc9ffeeba13d0507ed214f5aa4f617b14c203c84|этим]] правилом<<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(siblings)>>

BnW

Главная BnW в 2012-ом году 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. В остальных джаббер-клиентах сообщение отобразится в том виде, в котором его написали. Используется следующий синтаксис:

  • //курсив//

  • **полужирный**

  • [[http://url |текст]] отображается как текст2

  • {{{#!<язык программирования> <код>}}} подсветка кода, используя highlight.js; можно не указывать язык программирования: {{{<код>}}}

См. также план по внедрению дополнительного форматирования.

HTTPS

Веб-морда доступна по HTTPS, сертификат старткомовский, есть во всех браузерах. Установите опцию baseurl в значение https, чтобы BnW выдавал вам только безопасные ссылки: 

set baseurl https

Также рекомендуется использовать расширение для браузеров HTTPS Everywhere с этим правилом3, чтобы для соединения с bnw.im всегда использовалось защищённое соединение, даже если ссылку вам дали с http.

Разработка

Прочее

/BnW   /BnW/API   /BnW/RESTfulDraft   /BnW/help_simplified   /BnW/posts_formatting_proposal   /BnW/Интерфейс_redeye   /BnW/Интерфейс_simplified   /BnW/Список_команд   /BnW/Установка_BnW_на_Linux   /BnW/Форматирование   /CarrierLocations   /FTB   /G752  

  1. Запланировано. (1)

  2. Рекомендуется ставить пробел перед «|», т.к. он входит в допустимые символы ссылки и в текстовом виде возможны проблемы с отображением. (2)

  3. Для Firefox файл с правилом следует поместить в каталог ~/.mozilla/firefox/<user profile>/HTTPSEverywhereUserRules/ (3)

u/Stiletto/BnW (last edited 2017-05-16 19:41:37 by anonymous)