diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..751553b --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +*.bak diff --git a/docs/img/GMJ.png b/docs/img/GMJ.png index 35c59ee..2d1ff47 100644 Binary files a/docs/img/GMJ.png and b/docs/img/GMJ.png differ diff --git a/docs/img/GMJ_01.png b/docs/img/GMJ_01.png index 45422e5..997c08a 100644 Binary files a/docs/img/GMJ_01.png and b/docs/img/GMJ_01.png differ diff --git a/docs/img/GMJ_02.png b/docs/img/GMJ_02.png index 6b4f76f..3e48eba 100644 Binary files a/docs/img/GMJ_02.png and b/docs/img/GMJ_02.png differ diff --git a/docs/img/GMJ_03.png b/docs/img/GMJ_03.png index 15d741f..b0878d9 100644 Binary files a/docs/img/GMJ_03.png and b/docs/img/GMJ_03.png differ diff --git a/docs/img/GMJ_04.png b/docs/img/GMJ_04.png index 917475c..b0c80f2 100644 Binary files a/docs/img/GMJ_04.png and b/docs/img/GMJ_04.png differ diff --git a/docs/img/GMJ_05.png b/docs/img/GMJ_05.png deleted file mode 100644 index 32e1b72..0000000 Binary files a/docs/img/GMJ_05.png and /dev/null differ diff --git a/docs/index.md b/docs/index.md index e3ee1c6..7c3582f 100644 --- a/docs/index.md +++ b/docs/index.md @@ -36,17 +36,20 @@ зеркала. Контент тот же, но, благодаря возможностям мессенджера во многих записях исправлены старые ошибки и огрехи форматирования. -Кроме того, мы создали простой клиент для сообщества, позволяющий извлекать записи в случайном порядке из всего -архива сообщества, исключая повторения, а также быстро и просто ими делиться. +Кроме того, мы создали приложение-клиент для этого сообщества. Его главная особенность – способность извлекать +записи в случайном порядке из всего архива сообщества, исключая повторения, а также быстро и просто ими делиться. +Оно исключает необходимость ручного пролистывания новостной ленты. ***Итак, добро пожаловать в Grammar must joy!*** +--- + Пара моментов: 1. Да, контент не всегда будет (читайте: почти никогда не будет) оригинальным. И если он вдруг окажется на пути -чьего-нибудь копирайта, прошу нас об этом извещать. Такой контент нам... будет изыматься из ленты. +чьего-нибудь копирайта, мы просим извещать нас об этом. Такой контент нам... будет изыматься из ленты. 2. Записи могут быть разными. Конечно, без шока, браззерс и прочей неразрешёнки. Но всё-таки `18+`! -3. Если мы всё же где-то ошибёмся (что вероятно), просим также нам об этом сообщать. При таком названии группы +3. Если мы всё же где-то допускаем ошибки (что вероятно), просим также нам об этом сообщать. При таком названии группы не хочется ударять в грязь лицом. 4. Мы следуем [Политике социальных сообществ](https://adslbarxatov.github.io/SCP/ru). Поэтому рекламы в обозримом будущем здесь не будет. Да и комментарии тут ни к чему. Но советы, пожелания и конструктивная критика приветствуются @@ -54,7 +57,7 @@ Очень надеемся, что Вам понравится юмор, который почти не подчёркивается Word’ом! ---- +  @@ -63,9 +66,12 @@ Мы уже достаточно давно сопровождаем сообщество Grammar must joy. И на данный момент результатом его существования стала не только возможность собрать некоторые выводы о том, какими могли бы быть идеальная шутка или анекдот. Дело в том, что в процессе наполнения сообщества мы успешно создали и испытали механизм, который и поныне существует в качестве -кнопки в приложении uNot. Как же он работает? +кнопки в приложении [uNot](https://adslbarxatov.github.io/UniNotifier/ru) и в качестве самостоятельного клиента, на приветственной +странице которого Вы сейчас находитесь. -- Сначала было создано сообщество ВКонтакте, которое наполнялось вручную из различных источников. В качестве наполнения +Как же он работает? + +- Сначала было создано сообщество ВКонтакте, которое наполнялось вручную из различных источников. В качестве источников использовались *текстовые записи*, как правило, *не превышающие тысячи символов в длину*. Публиковались они либо сразу, либо с отсрочкой (но это не особо важно). Во время активного наполнения участие в этом сообществе имело смысл; сейчас же публикации в нём случаются значительно реже, из-за чего оно носит больше вспомогательный характер. @@ -75,31 +81,32 @@ с порядковыми номерами всех «живых» записей*, который и сейчас используется в приложении для ускорения работы, т.к. исключает обращение к несуществующим записям. -- Наконец, в приложение была добавлена функция *запроса к GMJ*. Она позволяет, *периодически обновляя диапазон доступных записей, +- Далее, в приложение uNot была добавлена функция *запроса к GMJ*. Она позволяет, *периодически обновляя диапазон доступных записей, случайным образом выбирать одну из них* и отображать в журнале новостей. При этом выбранная запись *вычёркивается из списка доступных*, что исключает повторы. Список сбрасывается, когда достигается конец диапазона. Следовательно, *весь архив постов непрерывно ротируется, оставаясь полностью доступным для пользователя*. +- Наконец, эта функция была выделена в самостоятельное приложение. + В таком виде данный механизм исправно работает уже более трёх лет. Он потенциально может быть применён к любому контенту с определёнными ***критичными характеристиками***: -- Текстовые записи должны быть *дискретными*, то есть, не связанными друг с другом логически или хронологически; -- Текстовые записи должны быть *автономными*: каждая из них должна иметь самостоятельный смысл и практическую ценность; +- Текстовые записи должны быть *дискретными*, то есть, не связанными друг с другом логически или хронологически. +- Текстовые записи должны быть *автономными*: каждая из них должна иметь самостоятельный смысл и практическую ценность. - Текстовые записи *не должны превышать тысячи символов*: таково техническое ограничение механизма в его текущей форме. - По крайней мере, *80% записей не должны полностью терять актуальность* с течением времени (становиться бесполезными). Как Вы понимаете, анекдоты под эти характеристики попадают легко – в общем-то, концепция под них и разрабатывалась. Но какие-либо прогнозы погоды или котировки – уже нет. Мы [уже пробовали](https://vk.com/upsilon_one) реализовать данный -метод для контента иного рода. Но эти попытки пока не увенчались успехом +метод для контента иного рода. Но эти попытки пока не увенчались успехом. ---- +  ### Начало работы -Канал Grammar must joy, как Вы знаете, изначально был реализован на базе соцсети ВКонтакте, и весь его контент содержится +Информационный канал Grammar must joy изначально был реализован на базе соцсети ВКонтакте, и весь его контент содержится на «стене» сообщества. Это удобно для просмотра новых записей. Однако с этим же связаны некоторые недостатки, а именно: - - Реклама. - Снова реклама (напомним, что GMJ, согласно Политике социальных сообществ, – полностью бесплатное сообщество, поэтому реклама в данном случае поддерживает... непонятно, кого; возможно, саму платформу, но это не точно). @@ -108,60 +115,49 @@ - Делиться записями со стен можно. Но мы не уверены, что это будет удобным, если нужно поделиться ею в другой соцсети или по другому каналу. -Что ж, это можно исправить. Ведь нам удалось правильно настроить наш супервизор веб-ресурсов, а также перенести контент +Что ж, это можно исправить. Ведь нам удалось реализовать выделенный мини-клиент, а также перенести контент сообщества на другую платформу. Последнее потребовалось из-за требования ВК использовать совершенно лишние методы опознавания пользователей при обычном, казалось бы, просмотре стены публичного канала. -Вышеназванный супервизор – это, конечно же, ***uNot*** и встроенная в него функция GMJ. Это – мощный инструмент для создания +Функция GMJ также доступна в составе супервизора веб-ресурсов [uNot](https://adslbarxatov.github.io/DPArray/ru#unot-uninotifier). +Это – мощный инструмент для создания управляемых новостей и оповещений. Но его же можно использовать как обычный клиент для нашего паблика. Если у Вас возникнет -интерес к полной функциональности, Вы сможете найти всё необходимое на домашней странице этого руководства. Мы же сейчас -рассмотрим самый простой вариант его применения. +интерес к полной функциональности, Вы сможете найти всё необходимое на его домашней странице. + -Один момент. Если нижеизложенная инструкция покажется Вам слишком сложной, Вы можете воспользоваться отдельным клиентом -[Grammar must joy](https://adslbarxatov.github.io/DPArray/ru#grammar-must-joy). Он работает аналогичным образом, -но содержит только те функции, которые нужны для контакта с сообществом GMJ. Итак, чтобы получить вышеописанные возможности, делаем следующее: -- Загружаем приложение из [Google play](https://adslbarxatov.github.io/DPArray/ru#unot-uninotifier) или в виде APK. -В соответствии с [Политикой разработки приложений](https://adslbarxatov.github.io/ADP/ru), uNot не требует платежей, не содержит рекламы -и скрытых функций и полностью безопасен в использовании. +- Загружаем приложение из [Google play](https://adslbarxatov.github.io/DPArray/ru#grammar-must-joy) или в виде APK. +В соответствии с [Политикой разработки приложений](https://adslbarxatov.github.io/ADP/ru), приложение не требует платежей, не содержит рекламы +и скрытых функций и полностью безопасно в использовании. -- Запускаем. При первом старте служба предложит ознакомиться с Политикой, а также даст краткую инструкцию по использованию. +- Запускаем. При первом старте клиент предложит ознакомиться с Политикой, а также даст краткую инструкцию по использованию. Жмём `Принять` и `Далее`. -- В первый раз приложение запустится на странице настроек оповещений. **Для взаимодействия с GMJ здесь ничего делать не нужно**. -Смахиваем экран влево. - -
- -- На экране **`О приложении`** доступна полная инструкция и обратная связь с нами на случай непредвиденных ситуаций. Убедитесь, -что язык интерфейса – русский. Иначе ничего не получится. - -
+- В первый раз приложение запустится на странице настроек оповещений. В дальнейшем этот раздел будет доступен через кнопку меню (≡). +Здесь можно выбрать необходимые параметры работы приложения. -- Смахиваем экран вправо пару раз до раздела **`Настройки приложения`**. В самом низу раздела обязательно потребуется указать -функцию центральной кнопки журнала – `Получить запись из Grammar must joy`. Также могут пригодиться `Тёмная тема` и `Размер шрифта`. -Остальное оставляем, как есть. +
-
+- На экране **`О приложении`** доступна полная инструкция и обратная связь с нами на случай непредвиденных ситуаций. -- Можно также включить функцию `Оставить службу активной`. В этом случае, даже закрыв приложение, Вы сможете оперативно его вызвать -через закреплённое оповещение в верхней части экрана. +
-- Смахиваем экран ещё раз вправо. **`Журнал оповещений`** – основной раздел приложения, который теперь будет первым появляться +- Системная кнопка Назад позволяет вернуться в главный журнал из любого раздела. +***Журнал оповещений*** – основной раздел приложения, который теперь будет первым появляться при его запуске. Под ним расположена центральная кнопка с семафором. Первое нажатие отобразит вступительное слово, а каждое -последующее будет запрашивать одну случайную запись со всей стены (более 2900 уникальных постов на 1.02.23). +последующее будет запрашивать одну случайную запись из сообщества (более 3500 уникальных постов на 1.07.2024). -
+
-- Первый запрос может занять чуть больше времени, т.к. приложение формирует список существующих записей. -Так оно обеспечивает неповторяемость отображаемых постов на всём «протяжении» стены. +- Первый запрос может занять чуть больше времени, т.к. приложение формирует список доступных записей. +Так оно обеспечивает неповторяемость отображаемых постов на всём «протяжении» архива сообщества. - Нажав на текст записи в журнале, можно быстро перейти в Telegram-канал GMJ или поделиться текстом любым доступным на устройстве способом. -
+
Собственно, всё. Использование приложения требует лишь наличия подключения к интернету и версии Android не ниже 5.0. Всё остальное – по Вашему усмотрению.