zmnv-views

1.7.6 • Public • Published

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

 

Как этим пользоваться?

  1. Подготовьте папку с изображениями, которые хотите «склеить» в одностраничную галерею.
  2. Откройте терминал по адресу этой папки (как это сделать?).
  3. Введите нужные команды.

 

Сгенерировать галерею из файлов и папок текущей директории

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 файл.

Readme

Keywords

none

Package Sidebar

Install

npm i zmnv-views

Weekly Downloads

1

Version

1.7.6

License

MIT

Unpacked Size

122 kB

Total Files

37

Last publish

Collaborators

  • zmnv