- PVSM.RU - https://www.pvsm.ru -
Всем доброй пятницы!
[1]
Может быть кому-нибудь пригодится: Fine Cut Engine [1]?
Это админка для сайта-визитки.
Т.к. в настоящий момент документация есть только на английском, топик предназначен для исправления этого недочета.
Фичи:
— Keep it Simple: настолько, насколько было возможно
— Без базы данных
— Free from Fat: практически отсутствует back-end
— Free to Use: MIT [2] or GPL [3]
— Хорошо интегрируется: можно включить всё что угодно в шаблон
— Без попкорна: это не кино
— Там нет ложки: мы помним The Matrix [4] :)
Fine Cut был разработан с использованием:
PHP 5.3.6.
Apache HTTP Server 2.x version.
Скорее всего возможно использовать и другой web-сервер, просто посмотрите на «.htaccess» корневой директории для того, чтобы сделать такие же настройки.
Если использовать Apache, то нужно помнить что:
«rewrite_module»: строгая зависимость
«deflate_module»: будет работать но без gzip
«env_module»: будет работать, смотрите «.htaccess»
«expires_module»: будет работать, смотрите «.htaccess»
«filter_module»: будет работать, смотрите «.htaccess»
«headers_module»: будет работать, смотрите «.htaccess»
«mime_module»: будет работать, смотрите «.htaccess»
«setenvif_module»: будет работать, смотрите «.htaccess»
Да, нам не нужна база данных, чтобы работать с Fine Cut.
Для использования админки Fine Cut «_adm» будет необходим современный browser, например:
Internet Explorer 9+
Firefox 3.6+
Google Chrome
Opera 12 (or, may be older, we didn't make tests)
Safari 5
В общем требование можно сократить до: последний WebKit или Gecko движок.
Fine Cut распространяется как архив. И нет никакого установочного скрипта, потому, что сдено просто.
Распаковать архив в любую директорию web-сайта, доступную для просмотра, это всё что нужно.
По шагам:
Обычно после установки всё сразу нормально.
Но, вам, всё же, может потребоваться некоторая настройка Fine Cut Engine.
Поэтому, вот перечень свойств, которые могут быть сконфигурированы непосредственно:
Эти настройки можно поправить в админке на вкладке " Settings ".
Там так же находятся кнопки сохранения настроек, очистки кеша и пара чекбоксов для настройки админки.
Если вы собираетесь работать с Fine Cut в относительной директории, а не в " document root " вам будет необходимо всегда помнить, что вы «не в корне сайта».
По умолчанию всё в Fine Cut независимо, компоненты и дефолтные шаблоны сделаны без привязки к пути файловой системы.
Советы:
Не используйте прямые ссылки ( http:// ) между страничками. Используйте относительные. Относительные это то, что вы видите на вкладке «Pages Manager» в " Дереве " (расположено слева).
Там есть кнопка " Copy this Leaf Path ", используйте её, чтобы быть уверенными, что ссылка сделана правильно.
Да, админок одновременно можно открыть сколько угодно.
Все это же справедливо не только для ссылок, но и для картинок и прочих ресурсов внутри директории Fine Cut.
Если всё же необходимо детальное описание: мы используем простейший pre-processor основанный на regular expressions для того, чтобы переименовать каждую ссылку внутри содержимого страницы или в дополнительной части .
Пре-процессоры это два компонента с именами " content_parser " и " head_additional ". Эти компоненты просто изменяют все, что начинается с
http="/ or src="/
Добавляя к ним путь относительный от корневой директории до директории установки. Поэтому, когда ваша ссылка находится внутри Fine Cut, просто будьте уверены, что она относительна директории установки.
Да, создавая свой шаблон, пожалуйста используйте эти компоненты для совместимости.
По умолчанию админка не защищена…
И нет никакого " управления пользователями", потому, что мы подозреваем, что в большинстве случаев Fine Cut будет использоваться «персонажем», создающим маленький сайт.
Поэтому мы предпочти использовать Apache Authentification для защиты админики.
Вы можете убедиться, что последние четыре строчки " _adm/.htacces " закомментированы:
#AuthType basic
#AuthName "auth requred"
#AuthUserFile /home/www/your_site_directory/.htpasswd
#Require valid-user
Вам нужно создать свой " .htpasswd ".
Гулите…
Все, что представлено в дереве редактора [Pages Manager][Pages Editor], это " URL ".
Например "about" это:
http://YourWebSite.url/YourFineCutDir/ about
А forkus и screenshots это:
http://YourWebSite.url/YourFineCutDir/ about / forkus
http://YourWebSite.url/YourFineCutDir/ about / screenshots
Сам редактор, это непревзойденный ACE Editor [7].
Hotkeys preset:
Да, Ctrl + S доступен во всей вкладке «Pages Manager» also...
Мы используем эту вкладку для задания необходимых свойств.
Свойства это иерархическая структура, которая может быть использована, например, для описания характеристик чего-нибудь на странице, геренации меню и т.п…
При работе с ними помните, там немного странное поведение, после редактирования свойства не сохраняйте страницу сразу, для начала кликните где-нибудь на пустом месте, чтобы изменения попали в модель свойств.
Всё как обычно.
Только две вещи, о которых необходимо сказать: " that checkbox " и " Head Additional " textarea.
— checkbox означает, должна ли страничка всё время создаваться, или можно её положить в файловый cache. Поэтому если на странице необходим динамическое содержимое, включающее [Ваш любимый PHP Engine], используйте его.
— Head Additional необходим для подключения дополнительных компонент страницы, CSS или JavaScript в ситуации когда нет необходимости вставлять это в основной шаблон.
Например, есть шаблон с кучей подключенных библиотек.
Возникает ситуация, когда нужно подключить ещё парочку, но только для конкретной страницы. Вот для этого оно и используется. Например, мы так подключаем LightBox CSS и JS для страницы screenshots [9].
Да, конечно, можно создать ещё один шаблон. Но зачем? Вам будет всегда необходимо помнить, что есть ещё один шаблон, который почти такой же как оригинал, и в случае необходимости правки нужно будет править оба.
Их существует много, но мы любим этот [10].
Огромное спасибо команде ElFinder [10].
Но, тем не менее, мы сделали некоторые правки.
Во-первых мы используем версию 1.3, она проще интегрируется с нашим CSS.
Во-вторых в его редакторе доступен Ctrl + S.
И, самое главное, мы постарались сделать совместимость с Twitter Bootstrap [11].
Мы используем папку
/templates/
для хранения шаблонов.
Не храните другие файлы в этой папке, потому, что каждый шаблон, исключая шаблон «по умолчанию» может быть удален. Хотя, вы можете «выстрелить себе в ногу» удалив даже его из File Manager.
Каждая папка непосредственно внутри папки шаблонов является «именем» шаблона.
Меняя шаблон: просто измените код и нажмите " Save ".
Добавление шаблона: немножко сложнее, потому, что когда вы нажимаете " Add " оно просто делает копию выбранного, но мы считаем, что это очень удобно, не нужно заново создавать разметку и вписывать необязательные вещи.
Удаление шаблона: тоже просто, оно просто стирает его папку. Но, мы надеемся, что понятно: если на страничке была зависимость от шаблона, то его удаление обрушит «движок» при её генерации.
Каждый шаблон содержит: свой код и сниппеты свойств и header страницы.
Во время создания страницы каждый шаблон получает переменную $success от движка.
В ней вы найдёте:
<?php include( $success["components"]["json_info"] ); ?>
И тут мы используем
<?php include( $success["components"]["content_parser"] ); ?>
для вставки его в страницу.
Да, по умолчанию, админка находится:
http:// YourHost / YourInstallDir / _adm
Но это можно изменить.
Во-первых переименуйте "_adm" в файле
_engine index.php
на строке 3.
Затем переименуйте саму папку "_adm".
Это может быть сделано непосредственно изнутри админки, если вы так и поступили, то незамедлительно перезагрузите админку, потому, что скрипты админки «смотрят» сейчас на другую папку.
Источник: http://finecut.info/documentation/ [12]
Автор: wentout
Сайт-источник PVSM.RU: https://www.pvsm.ru
Путь до страницы источника: https://www.pvsm.ru/cms/14166
Ссылки в тексте:
[1] Image: http://finecut.info
[2] MIT : http://en.wikipedia.org/wiki/MIT_License
[3] GPL: http://en.wikipedia.org/wiki/GNU_General_Public_License
[4] The Matrix: http://en.wikipedia.org/wiki/The_Matrix
[5] ZIP: https://github.com/wentout/Fine-Cut-Engine/zipball/master
[6] TAR.BZ: https://github.com/wentout/Fine-Cut-Engine/tarball/master
[7] ACE Editor: http://ace.ajax.org/
[8] ссылка: https://www.pvsm.ru/
[9] screenshots: http://finecut.info/about/screenshots/
[10] этот: http://elfinder.org/
[11] Twitter Bootstrap: http://twitter.github.com/bootstrap/
[12] http://finecut.info/documentation/: http://finecut.info/documentation/
Нажмите здесь для печати.