Усовершенствовать страницу плагина

Здесь можно обсудить сайт PlugRinG и предложить идеи по его дальнейшему развитию.
User avatar
Max Rusov
Posts: 3599
Joined: Wed 23 Nov, 2005 11:11
Location: Москва-Питер
Been thanked: 6 times
Contact:

Re: Новый плагринг

Postby Max Rusov » Wed 21 Nov, 2012 15:29

Latest post of the previous page:

NightRoman wrote:При добавлении файла иметь возможность добавлять аннотацию к этому добавлению

Описания обновлений должны быть независимы от файлов.
Во первых - новая версия это не один файл. С учетом всех версий FAR - может быть до 6 файлов.
Во вторых - аннотация обновлений может быть на плагринге, а файлов может не быть...

User avatar
NightRoman
Posts: 5849
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 8 times
Been thanked: 8 times
Contact:

Re: Новый плагринг

Postby NightRoman » Wed 21 Nov, 2012 15:31

В принципе логично. А как, по-твоему, технически должно выглядеть, ну просто фантазируя пока?

User avatar
Max Rusov
Posts: 3599
Joined: Wed 23 Nov, 2005 11:11
Location: Москва-Питер
Been thanked: 6 times
Contact:

Re: Новый плагринг

Postby Max Rusov » Wed 21 Nov, 2012 15:33

NightRoman wrote:А как, по-твоему, технически должно выглядеть, ну просто фантазируя пока?

Издеваешься?
http://www.dic.ru/plugring/plugin?id=72

User avatar
NightRoman
Posts: 5849
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 8 times
Been thanked: 8 times
Contact:

Re: Новый плагринг

Postby NightRoman » Wed 21 Nov, 2012 15:36

Про издеваешься не понял. Сущность - обновление плагина. Содержит аннотацию и включает 0, 1, ... файлов. Так?

User avatar
Max Rusov
Posts: 3599
Joined: Wed 23 Nov, 2005 11:11
Location: Москва-Питер
Been thanked: 6 times
Contact:

Re: Новый плагринг

Postby Max Rusov » Wed 21 Nov, 2012 15:42

NightRoman wrote:Про издеваешься не понял. Сущность - обновление плагина. Содержит аннотацию и включает 0, 1, ... файлов. Так?

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

User avatar
WARP ItSelf
Самый умный
Posts: 1011
Joined: Tue 15 Mar, 2005 23:19
Contact:

Re: Новый плагринг

Postby WARP ItSelf » Wed 21 Nov, 2012 15:45

Тут действительно вопрос. Имеется, скажем, 3 файла для трех версий Far. У каждой свой changlelog. Добавить поле changelog к файлу я могу, не вопрос. Но тогда замена файла потребуется заново указывать changelog, это неудобно. Делать changelog атрибутом плагина тоже нельзя (файлов то 3). Надо или сущность файла как-то развязывать с аннотациями/changelog'ами (что неудобно для использования) или...
Никто не знал, а я...

User avatar
NightRoman
Posts: 5849
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 8 times
Been thanked: 8 times
Contact:

Re: Новый плагринг

Postby NightRoman » Wed 21 Nov, 2012 16:00

Анонсы плагинов на форуме - это был, суть, стихийный плагринг. Работающий и неплохой, кстати. С хронологией всех обновлений, лентой новостей, ченжлогом по каждому плугу (удобным, листай, читай), хочешь - с файлами (сколько надо), хочешь - со ссылками. Это полезный практический опыт. Стоит поиметь в виду.

User avatar
CyberShadow
Posts: 194
Joined: Sun 15 Apr, 2007 17:12
Been thanked: 1 time
Contact:

Re: Новый плагринг

Postby CyberShadow » Wed 21 Nov, 2012 19:55

Залил еще один плагин. Примечания:

1. В детальном описании пропадают переносы строки. См. nl2br?
2. Как быть с архивами, содержащими сборки для всех версий FAR? Оставить поле "версия FAR" 0.0.0.0? Если сам плагин весит пару килобайт, делать 6 архивов чересчур.
3. Может, вместо списка поддерживаемых ОС - одно поле минимальной ОС? Также, если плагин ничего не импортирует (или это не DLL/EXE), он в теории вообще не зависит от операционной системы (только от платформы и FAR).

WARP ItSelf wrote:Имеется, скажем, 3 файла для трех версий Far. У каждой свой changlelog.
А зачем это нужно? Если версии плагина под разные версии Far предлагают функционал, настолько различающийся что это повод разбиения changelog-а, тогда не пора ли разбить плагин? А если нет, неужели пользователям Far 1/2 так помешают в changelog-е новости про обновления версии для Far 3?
Last edited by CyberShadow on Wed 21 Nov, 2012 20:05, edited 1 time in total.

User avatar
Max Rusov
Posts: 3599
Joined: Wed 23 Nov, 2005 11:11
Location: Москва-Питер
Been thanked: 6 times
Contact:

Re: Новый плагринг

Postby Max Rusov » Wed 21 Nov, 2012 20:00

CyberShadow wrote:1. В детальном описании пропадают переносы строки. См. nl2br?

Может вообще в описании разрешить HTML верстку?

User avatar
CyberShadow
Posts: 194
Joined: Sun 15 Apr, 2007 17:12
Been thanked: 1 time
Contact:

Re: Новый плагринг

Postby CyberShadow » Wed 21 Nov, 2012 20:04

HTML или что-то подобное также решит проблему с скринами. Можно вместо HTML использовать Markdown, он также используется на GitHub и StackOverflow.

User avatar
NightRoman
Posts: 5849
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 8 times
Been thanked: 8 times
Contact:

Re: Новый плагринг

Postby NightRoman » Wed 21 Nov, 2012 20:11

Если голосуем, то я за маркдаун, если технически возможно, конечно. Я и так хотел предложить. В топку хтмл, уж лучше простой текст тогда, но литерально, как написан, со всеми переносами.

User avatar
Max Rusov
Posts: 3599
Joined: Wed 23 Nov, 2005 11:11
Location: Москва-Питер
Been thanked: 6 times
Contact:

Re: Новый плагринг

Postby Max Rusov » Wed 21 Nov, 2012 20:26

HTML и есть простой текст. Но с ним можно делать таблицы, прикладывать скрины. И если для того чтобы поиспользовать Markdown или что-то подобное нужно что-то делать, то для того чтобы разрешить HTML - ничего делать не нужно. Только убрать вызовы несколько функций.

User avatar
CyberShadow
Posts: 194
Joined: Sun 15 Apr, 2007 17:12
Been thanked: 1 time
Contact:

Re: Новый плагринг

Postby CyberShadow » Wed 21 Nov, 2012 21:33

http://plugring.farmanager.com/plugin.php?pid=500 - Непонятно что тут делает архив NetBox.

Также:

Code: Select all

<input type="button" value="Search" onclick="submitPage('_submit');"/>
Нужен type="submit" чтобы форма отсылалась по Enter. Событие JS также лучше переместить на форму (onsubmit).

И вообще, код открыт? Может лучше патчи присылать?

User avatar
WARP ItSelf
Самый умный
Posts: 1011
Joined: Tue 15 Mar, 2005 23:19
Contact:

Re: Новый плагринг

Postby WARP ItSelf » Wed 21 Nov, 2012 22:48

1. По поводу разметки. HTML это явный оверкилл. Там такое можно повставлять, что караул. Вычищать это все ради трех тегов разметки совсем не здорово. Чем bbcode не нравится, скажем?

2. По поводу аннотаций. Вот так пока и не понял, как разрешить следующую ситуацию. У меня есть плагин. В нем 3 файла. 2 для разных версий Far и один - документация. Допустим, я решил документацию обновить и что-то там поменял. Файл заменил. Куда и что писать в аннотацию? В аннотацию к плагину? В аннотацию только к этому конкретному файлу? Т.е., скажем, пишем в аннотации плагина тупо "обновил документацию"? Про ситуацию "у плагина 2 файла для разных версий Far с разным changelog" вообще молчу.

P.S. Сразу оговорюсь, не надо писать "такой ситуации не возникнет никогда".
Никто не знал, а я...

User avatar
NightRoman
Posts: 5849
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 8 times
Been thanked: 8 times
Contact:

Re: Новый плагринг

Postby NightRoman » Wed 21 Nov, 2012 23:00

WARP ItSelf
А как бы сделали в аносах на форуме? Я предлагаю на это и ориентироваться. Добавили бы новый пост в теме плагина, в нем текст "обновил документацию", и к этому посту прикреплен один файл новой документации. Осталось обобщить в терминах и сущностях плагринга.

User avatar
NightRoman
Posts: 5849
Joined: Fri 18 Aug, 2006 13:52
Location: Cambridge, UK
Has thanked: 8 times
Been thanked: 8 times
Contact:

Re: Новый плагринг

Postby NightRoman » Wed 21 Nov, 2012 23:02

И теги типа Featured к файлам, как на гуглекоде, могли бы помочь. Тогда по тегам можно выяснить, что для данного плагина представляет текущая Featured сборка файлов.

User avatar
Alexey Samlyukov
Posts: 1757
Joined: Tue 15 Mar, 2005 17:28
Been thanked: 2 times
Contact:

Re: Новый плагринг

Postby Alexey Samlyukov » Thu 22 Nov, 2012 04:27

WARP ItSelf
по п.2: добавляем к файлу метку "Дата обновления", добавляем к плагину-топику поле "Информация", получаем:

Информация:

Code: Select all

21 ноября 2012 г. наобновлял я тут документацию.

01 ноября 2012г. написал супер-пупер плагин, пока фар 1х/2х


Code: Select all

Дата обновления: 01.11.2012
Версия плагина: 1,0,0,0
Версия фара: 1,75,0
Файл 1


Code: Select all

Дата обновления: 01.11.2012
Версия плагина: 1,0,0,0
Версия фара: 2,0,0
Файл 2


Code: Select all

Дата обновления: 21.11.2012
Версия плагина: 1,0,0,0
Версия фара: 0,0,0
Файл 3  - доки


Return to “Обсуждение PlugRinG”

Who is online

Users browsing this forum: No registered users and 1 guest