zmnv-views
v1.7.6
Published
Simple html gallery generator. It takes image files in current directory and return simple html page with that images.
Downloads
6
Readme
zmnv-views
Генератор простой HTML галереи из обычных картинок и папок.
Текущая рабочая версия
- 1.7.4, март 2019.
Описанный ниже функционал работает, ожидаются улучшения.
Осторожно: обращайте внимание в какой папке выполняете команды.
Особенности
- Название папки = текст заголовка для группы фотографий внутри неё.
- Допустима любая вложенность, в разумных пределах.
- Формат используемых файлов:
jpeg | jpg | png | svg | gif
- Есть возможность выполнять работу одной кнопкой
В каких случаях полезно?
- Собрать несколько макетов в одну оболочку и поделиться ей с другими людьми.
- Организовать хранение коллекций изображений с доступом из сети.
- ?...
Установка
Данная программа представляет из себя командный интерфейс для терминала (cli) и устанавливается глобально с помощью менеджера пакетов npm
в среде Node JS. Подробнее: Что такое Node JS?
Установить zmnv-views:
npm i -g zmnv-views
Требует доступ? Запустите терминал с правами администратора, или:
sudo npm i -g zmnv-views
Как этим пользоваться?
- Подготовьте папку с изображениями, которые хотите «склеить» в одностраничную галерею.
- Откройте терминал по адресу этой папки (как это сделать?).
- Введите нужные команды.
Сгенерировать галерею из файлов и папок текущей директории
zmnv-views build
После этого в текущей директории вы сможете найти папку build
следующей структуры:
[build]
-- [images] Папка с вашими изображениями
-- index.html Страница с вёрсткой галереи
-- style-initial.css Стили, задающие оформление галереи
Разместить галерею в общем доступе
Сгенерируйте галерею. Поделиться своим творчеством с другими можно некоторыми способами:
- Скопировать содержимое папки
build
на любой сервер статики. - Запустить свой локальный сервер внутри сети. Введите:
zmnv-views serve
Разместить галерею сразу в сетевой папке
Допустим, у вас есть доступ к сетевой папке, которая используется еще и сервером статики.
Определите переменные окружения:
export ZMNV_VIEWS_DEPLOY=/Volumes/servername Путь к сетевой папке
export ZMNV_VIEWS_HOSTNAME=https://servername.domain.ru Url сервера
export ZMNV_VIEWS_USERPATH=/zmnv/gallery Папка сохранения галереи
Сгенерируйте галерею с помощью:
zmnv-views build -d -o
-d, --deploy определяет место генерации галереи из окружения
-o, --open открывает вкладку в браузере с получившейся галереей
После выполнения команды файлы галереи появятся в сетевой папке и станут доступны по адресу:
ZMNV_VIEWS_HOSTNAME/ZMNV_VIEWS_USERPATH
например:
https://servername.domain.ru/zmnv/gallery/название
Например
Ожидаемые улучшения
Галерея:
- [x] ~~Адаптивная вёрстка галереи.~~
- [x] ~~Фиксация текущей даты.~~
- [x] ~~Можно задать свой заголовок страницы.~~
- [ ] Темы оформления (светлая/тёмная тема, другие темы).
- [ ] «Как сделать свою тему?».
- [ ] Выбор размера сетки с изображениями.
- [ ] Открыть изображения в формате lightbox с меню.
- [ ] ?...
Под капотом:
- [x] ~~Поддержка SEO заголовка~~
- [x] ~~Транслитерация заголовка для использования его как название папки с галереей.~~
- [x] ~~Предупреждать пользователя, если он запускает zmnv-views внутри папки с «невероятным» количеством файлов внутри (например, в папке «Загрузки»).~~
- [ ] Переписать некоторые методы, улучшить архитектуру.
- [x] ~~Терминал zmnv-views поддерживает языки: English, Русский (зависит от языка в системе).~~
- [ ] Привести в порядок описания в терминале на русском и английском языках.
- [x] ~~Копирование галереи в сетевую папку.~~
- [ ] Проверить поддержку копирования галереи через FTP.
- [ ] Разобраться с комбинаторикой опций и условиями.
- [ ] Возможность простой организации middlewares для сканирования и копирования файлов.
Непонятное:
- [ ] Сервера IIS не поддерживают символы
ё
ий
. Подумать.
Другие похожие проекты
- adauru-cli — собери ассеты от Google Web Designer и т.д. в 1 html файл.