Giter Site home page Giter Site logo

zmnv / zmnv-views Goto Github PK

View Code? Open in Web Editor NEW
0.0 1.0 0.0 1.16 MB

Сканирует директорию и генерирует HTML-файл с отображением картинок внутри папок

License: MIT License

JavaScript 87.80% CSS 12.20%

zmnv-views's Introduction

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/название

 

Например

 

Ожидаемые улучшения

Галерея:

  • Адаптивная вёрстка галереи.
  • Фиксация текущей даты.
  • Можно задать свой заголовок страницы.
  • Темы оформления (светлая/тёмная тема, другие темы).
  • «Как сделать свою тему?».
  • Выбор размера сетки с изображениями.
  • Открыть изображения в формате lightbox с меню.
  • ?...

Под капотом:

  • Поддержка SEO заголовка
  • Транслитерация заголовка для использования его как название папки с галереей.
  • Предупреждать пользователя, если он запускает zmnv-views внутри папки с «невероятным» количеством файлов внутри (например, в папке «Загрузки»).
  • Переписать некоторые методы, улучшить архитектуру.
  • Терминал zmnv-views поддерживает языки: English, Русский (зависит от языка в системе).
  • Привести в порядок описания в терминале на русском и английском языках.
  • Копирование галереи в сетевую папку.
  • Проверить поддержку копирования галереи через FTP.
  • Разобраться с комбинаторикой опций и условиями.
  • Возможность простой организации middlewares для сканирования и копирования файлов.

Непонятное:

  • Сервера IIS не поддерживают символы ё и й. Подумать.
     

Другие похожие проекты

  • adauru-cli — собери ассеты от Google Web Designer и т.д. в 1 html файл.

zmnv-views's People

Contributors

dependabot[bot] avatar zmnv avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.