[#] Немного обновил документацию на Гитхабе
vit01(mira, 1) — All
2016-02-18 10:23:16


https://github.com/vit1-irk/new-docs/blob/master/main.md

Добавил наши емейлы, адреса станций, ссылки на клиенты и прочую контактную информацию.

С документацией требуется помощь! Одному её делать, во-первых, скучновато, во-вторых, слишком однобоко.

[#] Re: Немного обновил документацию на Гитхабе
Andrew Lobanov(station13, 1) — vit01
2016-02-18 10:22:10


vit01> https://github.com/vit1-irk/new-docs/blob/master/main.md

Круто.

vit01> Добавил наши емейлы, адреса станций, ссылки на клиенты и прочую контактную информацию.

Предлагаю начать вести нодлисты и поинтлисты с необходимой информацией.

vit01> С документацией требуется помощь! Одному её делать, во-первых, скучновато, во-вторых, слишком однобоко.

После 20-го числа буду плотнее заниматься документацией. В данный момент пытаюсь выкроить время на игру к семилетию instead.

[#] Re: Немного обновил документацию на Гитхабе
vit01(mira, 1) — Andrew Lobanov
2016-02-18 10:39:10


vit01> Добавил наши емейлы, адреса станций, ссылки на клиенты и прочую контактную информацию.
AL> Предлагаю начать вести нодлисты и поинтлисты с необходимой информацией.

Абсолютно полный нодлист есть на http://ii-net.tk/station.html

Из поинтов же мне просто некого упомянуть. На mira station только Денис пишет, но он как бы не совсем поинт.
Двух друзей-гитаристов из irk39.tk тоже как-то не очень (у них собственный набор эх, да и пишут нечасто).
Товарищ Rush_Pon вообще у меня в поинтах не числится (он даунлинк и пишет через своё болото).

[#] Re: Немного обновил документацию на Гитхабе
Andrew Lobanov(station13, 1) — vit01
2016-02-18 11:00:02


vit01> Абсолютно полный нодлист есть на http://ii-net.tk/station.html

Знаю. Просто я имел в виду некий текстовый формат и всё такое.

vit01> Из поинтов же мне просто некого упомянуть. На mira station только Денис пишет, но он как бы не совсем поинт.
vit01> Двух друзей-гитаристов из irk39.tk тоже как-то не очень (у них собственный набор эх, да и пишут нечасто).
vit01> Товарищ Rush_Pon вообще у меня в поинтах не числится (он даунлинк и пишет через своё болото).

Но тем не менее. Я понимаю, что мы не фидо и вообще не имеем такой чёткой структуры (в этом сила и ii и наша), но тем не менее хотя бы для сисопов такая инфа может оказаться полезной.

[#] Re: Немного обновил документацию на Гитхабе
vit01(mira, 1) — Andrew Lobanov
2016-02-18 11:36:13


AL> Знаю. Просто я имел в виду некий текстовый формат и всё такое.

Предлагаю подобный формат

Nodename: mira station
Client: http://ii-net.tk/ii/ii-point.php?q=/
Web: http://ii-net.tk/ii/ii-web.php
Contacts: vit01 (mailto:me@ii-net.tk; https://github.com/vit1-irk; tel:+7xxxyyyzzzz)
Description: Станция мира и дружбомагии. Что-нибудь ещё сюда написать надо.
Uplinks: station13; Difrex; lenina; mtest; mlp
Downlinks: lenina; station13; Difrex; mtest; mlp
MaxFetchInterval: 10min

Nodename: station13
// и дальше, ну ты понял

А для поинтов можно взять вот это:

Pointname: Рома
Virtuals: 51t; Рома Бибек; Roman Yakovlev
Fullname: Роман Яковлев
TimeZone: UTC+9
Contacts: http://gk11.ru; me@51t.ru
Information: Просто Рома.
	Можно ещё больше текста
	Даже в несколько строк.

Pointname vit01
// ну вы поняли

[#] Re: Немного обновил документацию на Гитхабе
vit01(mira, 1) — vit01
2016-02-18 11:56:13


Нет, поторопился. Поле Downlinks надо убрать (его можно достроить самостоятельно и MaxFetchInterval тоже.
А вот аплинков оформить так:
Uplinks: station13 (10min), Difrex (10min), lenina (10min), mtest (30min), mlp (20min)

Лучше вообще выбрать какой-нибудь JSON, чтобы парсить можно было на раз-два.

[#] Re: Немного обновил документацию на Гитхабе
Andrew Lobanov(station13, 1) — vit01
2016-02-18 11:49:50


vit01> Предлагаю подобный формат

Не взирая на его объёмность, мне понравилось. Я пытался вести нечто вроде фидошных листов, но это не так удобно. Надо подумать над этим отдельно, но предложенный тобой формат весьма полезен.

[#] Re: Немного обновил документацию на Гитхабе
Andrew Lobanov(station13, 1) — vit01
2016-02-18 13:33:53


vit01> Лучше вообще выбрать какой-нибудь JSON, чтобы парсить можно было на раз-два.

Давай уж сразу xml =)

Не надо тащить JSON туда, где он не нужен. Тут просто ключ-значения же. Это можно в plain text упихать.

[#] Re: Немного обновил документацию на Гитхабе
vit01(mira, 1) — Andrew Lobanov
2016-02-18 14:10:21


AL> Давай уж сразу xml =)
AL> Не надо тащить JSON туда, где он не нужен. Тут просто ключ-значения же.

Ну так а я про что =)

import json
f=open("base.json")
config=json.load(f)

print(config[0]["Nodename"])

И всё, в config уже готовая информация в списке, которую можно рассовывать туда-сюда.

В PHP json тоже полностью загружается в 2 строчки. И ничего сверх этого накручивать не надо.

[#] Re: Немного обновил документацию на Гитхабе
vit01(mira, 1) — vit01
2016-02-18 14:17:38


Ах да, по сабжу. Сделал скриншоты наших клиентов и выложил в документации.

Посмотри, как оно.

[#] Re: Немного обновил документацию на Гитхабе
Andrew Lobanov(station13, 1) — vit01
2016-02-18 14:18:57


vit01> И всё, в config уже готовая информация в списке, которую можно рассовывать туда-сюда.

vit01> В PHP json тоже полностью загружается в 2 строчки. И ничего сверх этого накручивать не надо.

Ладно. Как хотите. SQLite тоже в две строки прикручивается. Предлагаю лепить его.

[#] Re: Немного обновил документацию на Гитхабе
vit01(mira, 1) — Andrew Lobanov
2016-02-18 15:08:37


sqlite требует библиотеки всякие (особенно для похапе).

// А так шутка плохая, не оценил

JSON крут тем, что его можно и читать вручную, и править вручную, хоть через блокнот. А затем в готовом виде скормить любой программе.

[#] Re: Немного обновил документацию на Гитхабе
Difrex(mira, 14) — Andrew Lobanov
2016-02-18 15:20:22


>SQLite тоже в две строки прикручивается
В sqlite придется делать дурацкие запросы.
А из JSON в python ты получишь dict, в perl hash, и.т.д. В любом языке.

А вот для этого:
Nodename: mira station
Client: http://ii-net.tk/ii/ii-point.php?q=/
Web: http://ii-net.tk/ii/ii-web.php
Contacts: vit01 (mailto:me@ii-net.tk; https://github.com/vit1-irk; tel:+7xxxyyyzzzz)
Description: Станция мира и дружбомагии. Что-нибудь ещё сюда написать надо.
Uplinks: station13; Difrex; lenina; mtest; mlp
Downlinks: lenina; station13; Difrex; mtest; mlp
MaxFetchInterval: 10min

нужно писать свой парсер. Велосипед не всегда означает простоту :)

На самом деле я за JSON потому что в моей уберноде используется он для межсерверного взаимодействия.

[#] Re: Немного обновил документацию на Гитхабе
Andrew Lobanov(station13, 1) — Difrex
2016-02-18 15:45:29


Difrex> А из JSON в python ты получишь dict, в perl hash, и.т.д. В любом языке.

Просто зачем для плоской структуры дерево? А делать древовидные листы это уже как-то совсем стрёмно. Хотя, кому как нравится. Если большинство за JSON, то пусть будет JSON. Если XML, то давайте XML. Но нафиг это надо, когда у нас всё в plain text?

// Так то можно и сообщения в JSON хранить. Удобнее, чем строчки разгребать.

[#] Re: Немного обновил документацию на Гитхабе
Andrew Lobanov(station13, 1) — Andrew Lobanov
2016-02-18 16:02:11


Difrex>> А из JSON в python ты получишь dict, в perl hash, и.т.д. В любом языке.

Ладно. Фиг с ним. Пусть будет json. Я его потыкал и решил, что это не самое ужасное решение.

[#] Re: Немного обновил документацию на Гитхабе
vit01(mira, 1) — Andrew Lobanov
2016-02-18 16:18:08


AL> // Так то можно и сообщения в JSON хранить. Удобнее, чем строчки разгребать.

При 10000 сообщениях бандлы будут занимать гораздо больше. А ещё клиенту на каком-нибудь bash или Си сложнее с ними возиться будет. Всё имеет свою цену.

[#] Re: Немного обновил документацию на Гитхабе
Andrew Lobanov(station13, 1) — vit01
2016-02-18 16:14:36


vit01> А для поинтов можно взять вот это:

vit01> ====
vit01> Pointname: Рома
vit01> Virtuals: 51t; Рома Бибек; Roman Yakovlev
vit01> Fullname: Роман Яковлев
vit01> TimeZone: UTC+9
vit01> Contacts: http://gk11.ru; me@51t.ru
vit01> Information: Просто Рома.
vit01> Можно ещё больше текста
vit01> Даже в несколько строк.

vit01> Pointname vit01
vit01> // ну вы поняли
vit01> ====

TimeZone заменить на Location, виртуалов и информацию выкинуть, добавить флаги для дополнительной информации =)