===================================================================== AJPapps - Tumblr post generator 3.05 Линда Кайе 2011-2016. Посвящается Ариэль ===================================================================== Эта программа родилась из заглушки, с помощью которой я генерировала посты для дайриков, в которых были обойки, лежащие на Тумблере в соответствующем блоге. На самом деле она мало отличается от той заглушки, но позволяет автоматизировать процесс получения XML с постами и обладает симпатичным интерфейсом. История создания ---------------- Собственно, история создания рассказана в описании программы. Скажу только, что это нечто вроде побочного продукта Агехи, в которой мне так и не удалось прикрутить поддержку скриптинга. Ну лень мне, да и много картинок, с которыми хочется сделать пост, я отправляю в Тумблер не напрямую, поэтому их может не быть в базе Агехи. История изменений ----------------- • 1.00.0010 Первый публичный релиз. • 1.00.0011 [+] Добавила историю хостов. [+] Теперь сгенерированный пост можно копировать через Ctrl+Ins в любом месте. • 1.00.0012 [+] Новый метод - Debug pictures list. Нужен чтобы легче при предпросмотре удалять ненужные картинки по номерам. • 1.00.0014 [-] В нерусских версиях Windows возникали проблемы с кодировкой. • 1.00.0015 [+] Теперь можно выбирать записи с определённым тэгом. • 1.00.0016 [+] Появился новый метод генерации - "Hentai gallery, one per line". Он похож на "Debug pictures list", но не содержит номеров. • 1.00.0017 [+] Убрала DIV тэги в методах, которые генерируют по одной картинке на строку. [+] Добавила версии методов, которые генерируют предпросмотры шириной 500 пикселей вместо 250. [+] Полученный XML теперь хранится в кодировке UTF-8. • 1.00.0018 [+] Три новых метода генерации: "Direct links to 1280px pictures", "Links to posts" и "Links to posts, no slug". Они создают простые списки URL. • 2.00.0023 [+] Появилась возможность использовать сохранённый XML файл. [+] Между запусками программы, XML, скаченный программой, не сохраняется. [+] Новые методы генерации, а также дополненные старые. [+] Фильтрация постов по строке в photo-caption. [+] При генерации поста программа сообщает о прогрессе. [+] Генерацию поста можно отменить. • 3.00.0024 [+] Предпросмотр XML теперь учитывает, что получаемые данные содержатся в кодировке UTF-8. [-] Полученный XML портился при сохранении. [+] Снова немного изменены методы генерации. [+] Генерация постов HTML формате. [+] Генерация постов XHTML формате. [+] Генерация постов формате Live Journal. [+] Окно настроек дополнительных параметров генерации. [+] Можно задать текст, который добавляется к MORE и lj-cut. [+] Фильтрация осуществляется также и по тэгам постов. [+] Формат ссылки на пост выбирается в настройках и действует на все методы генерации. [+] Доступно копирование готового поста в HTML формате (для вставки в визуальные редакторы). [+] Дополнительная возможность вырезать из сохранённого XML файла все посты без GUID в заголовках и тэгах для ускорения повторной обработки. [+] Теперь при создании картинки со ссылкой, ссылка не создаётся, если её адрес совпадает с адресом картинки. • 3.00.0025 [-] Справка вызывалась по Ctrl+F1 вместо F1. [+] Теперь при обрезании XML файла программа сразу спрашивает имя исходного файла и имя куда файл следует сохранить. [+] Теперь при обрезании XML файла программа выводит время в статистике. • 3.00.0026 [+] Появилась возможность форсировать формат генерации не меняя настройки. [+] При обрезании XML файла перед выводом итоговых результатов программа освобождает память. • 3.00.0027 [-] Программа не переключалась в режим использования сохранённого XML файла при помощи меню. • 3.00.0028 [+] Добавлен автоповтор при ошибках получения XML с сайта. • 3.00.0029 [-] При очень большом времени работы системы генерация отменялась сразу же после запуска. • 3.01.0031 [+] Новые версии существующих методов генерации для предпросмотров по 75 пикселей. [+] Размеры предпросмотров теперь указаны во всех методах. • 3.02.0033 [-] Метод "Links to posts, plain" был не определён. [+] Выводится количество элементов в сгенерированном посте. • 3.03.0039 [+] Базовая поддержка командной строки. [+] В списке методов генерации теперь выводятся их номера. • 3.04.0040 [+] Появилась поддержка фотосетов. • 3.05.0042 [+] Новые методы генерации: "Ruby hash" и "Ruby hash ADS" с разными размерами картинок. Они генерируют массив хэшей на языке Ruby. Потом этот код можно использовать в каком-нибудь HAML. [+] Все HTML тэги для формата LiveJournal теперь в нижнем регистре. • 3.05.0043 [+] В методах "Ruby hash" и "Runy hash ADS" вставляется заголовок Руби скрипта и информация о файле. На всякий пожарный. • 3.05.0045 [-] Обновила XML библиотеку, поскольку со старой могли наблюдаться странные ошибки. Зависимости ----------- Для работы этой программы нужны следующие компоненты: • AJPapps - AJPapps support library 1.00 Файл AJPappsSupport0100.DLL • AJPapps - Библиотека общих функций 3.01 Файл CommonFunctions0301.DLL • AJPapps - File I/O support 1.02 Файл FileIOSupport0101.DLL • AJPapps - XML helper library 1.02 Файл XMLHelper0102.DLL • AJPapps - Ageha history 1.00 Файл AgehaHistory0100.DLL • AJPapps - Panel control 1.00 Файл Panel0100.OCX • MSXML 4.0 Файл MSXML4.DLL • Microsoft Visual Basic Virtual Machine Файл MSVBVM60.DLL Эти компоненты обязательны. Они уже включены в программу установки ^_^ Информация о разработке ----------------------- Язык: Microsoft Visual Basic 6.0 SP6 Платформа: Windows XP Professional SP3 Установка --------- Просто запустите Setup.TumblrPostGenerator.EXE, и программа установки сама создаст все необходимые ярлыки. Использование ------------- После запуска программы откроется окно программы, в котором достаточно выполнить два простых шага для получения готового поста для вставки в блог или на форум. Вот они: 1. Получение XML с постами из Тумблера. 2. Генерация нового поста на основе полученного XML. Первый шаг можно выполнить двумя способами: 1. XML можно скачать с сайта. 2. Можно использовать уже сохранённый XML. Выбрать способ получения XML можно при помощи пунктов меню программы или клавишами Ctrl+PgUp и Ctrl+PgDown. До версии 3.00 программа поддерживала генерирование поста с BB кодами, поскольку изначально ориентировалась на использование в сервисе Diary.ru. Но, начиная с версии 3.00 программа может генерировать пост в разных форматах: 1. BB кодах для вставки на форумах. 2. HTML и XHTML для вставки в код сайта. 3. Live Journal. Подробности читайте в разделе настроек. Шаг 1а. Получение XML с сайта ----------------------------- При получении XML с сайта требуется указать несколько параметров, а всё остальное программа сделает сама. Плюсом такого подхода является то, что ничего заранее скачивать не надо. А вот недостаток заключается в том, что за раз можно загрузить не более 50 постов. Впрочем, если в постах используются тэги, можно указать, посты с какими тэгами необходимо получить. Аутентификация пока не поддерживается. Блоги, защищённые паролем, программа также читать не умеет, хотя это может быть добавлено в будущем. Для начала нужно указать следующие параметры: 1. Host name. Здесь вы указываете адрес блога, например, staff.tumblr.com. Заметьте, что нужно указать только имя хоста, без всяких "http://". 2. Tag name. Здесь нужно указать тэг, посты с которым следует получить, либо оставить поле пустым, чтобы программа запрашивала посты с любыми тэгами. 3. Start from - это индекс поста, с которого нужно начать чтение. Самый последний (самый свежий) имеет индекс 0, предпоследний - 1 и так до самого первого. 4. Num read указывает, сколько постов нужно прочитать за один запрос. Максимум - 50, по умолчанию - 20. Посты читаются от самого свежего к более старым. После того как вы указали все стартовые данные, нажмите Get XML, и XML с постами будет загружен. Первые 10 килобайт для информации будут помещены в текстбокс ниже, а полная копия полученных данных будет сохранена в каталог данных программы под именем Received.XML. Шаг 1б. Использование сохранённого XML -------------------------------------- Этот вариант позволяет обработать хоть весь блог целиком, не обращаясь к сайту, лишь бы был соответствующий XML файл. Его можно получить, например, программой AJPapps - Tumblr backup. XML файл может содержать не только фото-посты, но программа обработает только их. Достаточно нажать кнопку Choose XML file, и выбрать нужный файл в появившемся диалоге. Имя выбранного файла появится с поле File name. И всё! Шаг 2. Генерация поста ---------------------- Далее вам нужно выбрать скрипт с помощью которого вы будете генерировать пост. Для этого предназначен выпадающий список Generation method. А потом нужно нажать Generate! Во время генерации в центре окна будет отображаться прогресс: что программа делает, сколько постов обработано, и сколько их всего. Кнопочка Cancel позволяет отменить затянувшийся процесс в любой момент, что особенно актуально при больших XML фалах. Первые 10Кб готового поста попадут в текстбокс ниже. Чтобы скопировать весь текст целиком, достаточно нажать Copy или клавиши Ctrl+Ins. После этого текст попадёт в буфер обмена, откуда его можно вставить в дневник или на форум. Чтобы форсировать какой-либо формат генерации, можно нажать кнопку Generate! правой кнопкой мыши или нажать Shift+Enter на клавиатуре. В результате появится контекстное меню, где и нужно выбрать подходящий формат. Например, это может быть полезно, если вы обычно генерируете пост в BB кодах, но иногда нужно сделать тоже самое в HTML формате. Чтобы не залезать в настройки без конца, я и добавила такое меню. Фильтрация постов ----------------- Если посты нужно отфильтровать по тексту в подписи к картинке (photo-caption) и/или тэгам, то ниже есть поле Search for. Сюда нужно ввести текст, который программа будет искать в каждом посте. Если в очередном такого нет, программа проигнорирует пост, и не будет для него генерировать элементы. Регистр символов при этом учитываться не будет. Например, я выгружаю кучу скриншотов из анимэ Berserk. В подписи к картинкам я указываю "Berserk". Однако картинки выгружаются не всей кучей сразу, а по одной в день. В итоге в блоге они перемешиваются с другими картинками. После того как все картинки были выгружены, я сохраняю XML всего блога и передаю этой программе. В поле Search for я указываю "Berserk". В итоге программа обработает только посты с таким словом и сгенерирует мне пост только с картинками из анимэ Berserk. Обратите внимание, что программа не настолько умна чтобы понять, что вы ищите только анимэ Berserk и не ищите скриншоты из игры Doom, помеченные как "I'm in berserk mode!" Так как тут тоже присутствует слово "Berserk", программа обработает и такие посты. Если же нужно точно выделить группу постов, чтобы потом не перепутать, я могу посоветовать ещё при загрузке их в Тумблер в подписи как-нибудь вставить свежесгенерированный GUID. GUID - строка уникальная, поэтому попадётся только в нужных вам постах. Настройка генерации постов -------------------------- Ниже кнопки Generate! находится кнопка Settings, которая открывает диалоговое окно настроек, где вы можете указать как именно будут генерироваться посты. Эти настройки влияют на все методы генерации сразу. Search where. Этот параметр указывает, где программа будет искать строку Search for при генерации поста: в подписи к картинке, в тэгах или и там, и там. До версии 3.00 программа искала только в подписи, но это оказалось серьёзным упущением. Теперь по умолчанию программа ищет везде. Post format. Здесь указывается формат, в котором будет генерироваться пост: 1. BB коды. Этот формат применим к форумам и блог сервисам вроде Diary.ru. Текст форматируется тэгами вида [B], [IMG], [MORE]. 2. HTML. Это обычная HTML разметка, которую можно вставить в любую страницу на сайте. Тэги пишутся в верхнем регистре и выглядят примерно так: , . Аналога BB коду MORE здесь нет. 3. XHTML. Разметка подобная HTML, но в нижнем регистре и по правилам XML. Например: , . Аналога BB кода MORE здесь тоже нет. 4. Live Journal. Подобно формату HTML, только в качестве аналога BB кода MORE используется тэг . Line breaks. Эта настройка действует только для HTML и XHTML форматов. Она указывает, как программа будет разрывать строки, каким тэгом это делать. На выбор доступны тэги BR, P и DIV. Link to post format. Эта настройка указывать, использовать ли длинную форму ссылки на пост (with slug) или короткую (no slug). Ссылки в обеих формах эквивалентны, всё зависит от эстетических предпочтений. Copy post as. Эта настройка определяет, в каком формате копировать пост. Она не меняет волшебным образом тэги в сгенерированном посте, она просто определяет, как пост будет выглядеть для других программ при вставке из буфера обмена. Вот варианты: 1. Text only. Простой текст, тут всё понятно. 2. Text and HTML. Пост будет скопирован как простой текст, а также как HTML фрагмент, как если бы вы скопировали его из окна браузера. При вставке в визуальный редактор вроде Word или редактора SeaMonkey, оный выведет пост с картинками и ссылками в готовом виде. Default MORE label. Эта настройка определяет текст, который будет добавлен к тэгам MORE и lj-cut, если генератор не укажет свой. В принципе, пока генераторы свой не указывают, поэтому введённый здесь текст появится во всех сгенерированных постах. Пустая строка предоставляет блог сервису право самостоятельно выбирать подпись. Командная строка ---------------- Программа позволяет генерировать посты прямо из командной строки. В этом случае используется только заранее сохранённый XML файл. Вот формат командной строки: TumblrPostGenerator[.EXE] InFileName MethodIndex SearchFor PostFormat OutFileName InFileName - имя сохранённого XML файла с постами. MethodIndex - индекс метода генерации от 0 до 20. Данное число можно посмотреть в списке методов генерации в главном окне программы. SearchFor - строка, по которой необходимо фильтровать посты. Эквивалентна одноимённому полю в главном окне программы. PostFormat - индекс формата поста 0 до 3. Соответственно это: 0 - BB коды, 1 - HTML, 2 - XHTML, 3 - Live Journal. OutFileName - имя текстового файла, в который будет сохранён сгенерированный пост. Файл будет сохранён в кодировке UTF-8. Сообщения об ошибках выводятся в окнах сообщений. В случае успеха не выводится ничего. Удаление -------- Удаление самой программы производится обычным способом - через Установку и удаление программ. Маленький копирайт ------------------ 1. Программа распространяется бесплатно. 2. Вы имеете право распространять её на тех же условиях. 3. При распространении вы не имеете права менять авторство программы, присваивать его себе или каким-либо иным способом искажать его. 4. Разрешено коммерческое использование программы (в офисе, на производстве) за исключением её платного распространения или сдачи в аренду. 5. Программа распространяется как есть. Автор не несёт ответственности за любые трагедии или несчастные случаи, вызванные использованием программы. 6. Вы имеете право использовать ActiveX компоненты, поставляемые с программой, в собственных программах. При этом автор не гарантирует совместимость будущих версий компонентов. 7. Для любого пункта данного соглашения может быть сделано исключение с разрешения автора программы. 8. По любым вопросам, связанным с данной программой, обращайтесь по адресу lindaoneesama@gmail.com Загружено с http://purl.oclc.org/Linda_Kaioh/Homepage/