Это документация к пакету wede_ogl (версия 0.3).
Цель данного пакета - ведение оглавлений (аннотаций) к файлам
(детали см. ниже) для последующего поиска нужного файла.
При добавлении файлов создание заготовок аннотаций автоматизировано,
но при удалении файлов или их переносе в другой каталог - аннотации
следует удалять или переносить вручную.
Вспомогательные подпрограммы вынесены в библиотечный модуль,
в данном случае - oglavl_geral.py; его рекомендуется скопировать в
каталог, в котором интерпретатор питона ищет библиотечные модули
(напр., C:\Python27\Lib).
Программа создания шаблонов аннотаций - walk_.py . Её следует
запускать (без параметров) в каталоге, в котором хранятся
инвентаризируемые файлы. При первом запуске она создаёт
в текущем каталоге и его подкаталогах "файлы оглавлений"
с именем oglavl.dat; содержимое этих файлов имеет следующий вид
(просмотр и редактирование - напр., во встроенном редакторе
файлового менеджера Far):
Stefano_Baroni_-_PWs_and_PPs.pdf
Stefano*.pdf
1794081
2007-08-09 13:42:02
--------
tutorial_wyckoff.pdf
tutoria*.pdf
208212
2007-08-09 13:39:16
--------
- для каждого файла записываются имя, "сокращённое имя" (программа
предлагает собственный вариант), длина и дата создания. Далее можно
вставить строки аннотации, как в приводимом ниже примере
(кодировка - любая, лишь бы читалась;
в данном примере русские слова набраны латиницей во избежание
проблем c несоответствием кодировки):
Stefano_Baroni_-_PWs_and_PPs.pdf
Stefano*.pdf
1794081
2007-08-09 13:42:02
Plosk. wolny i psewdopot. - teoriq.
--------
tutorial_wyckoff.pdf
tutoria*.pdf
208212
2007-08-09 13:39:16
Primery zad. geom. (almaz..Al2O3).
--------
При последующих запусках, если где-либо появились новые файлы,
walk_.py добавляет к oglavl.dat шаблоны их аннотаций, а если
ситуация требует вмешательства (отсутствуют ранее имевшиеся файлы
etc.) - выдаёт сообщение (в файл walk.out). При этом ситуацией,
требующей вмешательства, считается наличие файлов *.dat, кроме
oglavl.dat (это связано с тем, что ранее иногда создавалось несколько
файлов аннотацмй с именами вида oglavl1.dat, old.dat etc. -
их приходилось объединять вручную);
Предусмотрена возможность задавать среди аннотации списки ключевых
слов; в текущей версии предложено хранить список допустимых ключевых
слов (в модуле tags.py) и копировать их оттуда (это минимизирует риск
набивки ключевого слова с ошибкой и стимулирует тщательное продумывание
такого списка; с учётом проблем рапознавания кодировок в натоящий
момент все ключевые слова записаны латиницей). Строка ключевых слов
имеет вид
Tags: metapsihologiq, immoralizm.
. Поиск осуществляется программой poistags.py .
Ясно, что многочисленные файлы oglavl.dat в подкаталогах
неудобны для обзора содержимого в целом, поэтому предусмотрено
создание файла для просмотра человеком. Это делает программа
sozd_txt.py, а файл для просмотра человеком называется oglavl.txt .
Она может запускаться без параметров (тогда просматривается
лишь oglavl.dat в текущем каталоге) или с параметрами -
именем каталога (текущий - '.') и ключом '/r' (рекурсивно; тогда
рекурсивно просматривает все подкаталоги). Далее файлы сортируются
по дате (поздние - выше, между днями - пустые строки) и выводятся по типу
-----
Stefano*.pdf 1794081 2007-08-09 Plosk. wolny i psewdopot. - teoriq.
tutoria*.pdf 208212 2007-08-09 Primery zad. geom. (almaz..Al2O3).
-----
. (Как видим, здесь для краткости используются сокращённые имена).
Ещё пример реального содержимого файла oglavl.txt:
-----
p8190027.jpg 663146 2015-08-19 Petroz. - Onevsk. ozero.
p8190026.jpg 661470 2015-08-19 Petrozawodsk - ostatki starogo \lektr. stolba s serpom i molotom
(na ul. Pu[kinskoj).
p8120025.jpg 573252 2015-08-12 U XXX - kot.
p8120024.jpg 79116 2015-08-12 Moskwa, wozle doma XXX.
p8120023.jpg 71597 2015-08-12 Moskwa, }@lkowsk. prosp.
-----
.
Адрес для скачивания:
http://aravidze.narod.ru/u1/wede_ogl_0.3.zip .
Адрес для обратной связи:
a r a v i d z e @ y a n d e x . r u .
(Конец документации).