distro
1.0.0
Эти инструкции более ориентированы на разработчиков и администраторов, которые хотят использовать «кровотечение» Фосвики. Мы рекомендуем использовать наши упакованные распределения. Смотрите нашу страницу загрузки
Вы можете запустить экземпляр Foswiki из этого клона, просто указав на него Apache. Смотрите Apacheconfiggenerator
Примечание: Configure была полностью переписана на главной ветви. Фосвики теперь может «начаться» без конфигурации. После псевдо-установки расширений по умолчанию укажите свой браузер на свой URL-адрес по умолчанию для нового сайта, настроенного в ApacheConfigGenerator. http://yoursite.com/foswiki http://yoursite.com/foswiki/bin/view http://yoursite.com
Чтобы «установить» расширения в зоне оформления заказа, вам следует использовать скрипт pseudo-install.pl для их установки. На Unix/Linux этот скрипт генерирует мягкие ссылки от основного дерева до расширений, поэтому вы можете работать на своем коде in situ и увидеть влияние изменений на живую Foswiki, не требуя шага установки. Windows не поддерживает мягкие ссылки, поэтому сценарий также можно запускать в режиме -copy (по умолчанию в Windows), но в этом случае вам придется повторно запустить его каждый раз, когда вы меняете расширение. Использовать:
pseudo-install.pl default для установки вкладчиков и плагинов по умолчанию (EG Extensions.twistyContrib, на который опирается extensions.patternskin)pseudo-install.pl developer для установки дополнительных расширений разработчика. Опция разработчика также устанавливает все расширения по умолчанию. См. Комментарий заголовка сценария pseudo-install.pl (Core Directory of Checkout) для вариантов и дополнительной информации. Обратите внимание, что pseudo-install.pl работает только с расширениями, которые имеют манифестный файл, как того требует Extensions.buildContrib. Примеры скрипта ниже предназначены для оболочки bash .
Типичная ситуация заключается в том, что вы хотите запустить псевдо-установленную Foswiki, проверенный из «Мастер». И если вы разработаете плагины, вы хотите иметь возможность активировать свой плагин в этой установке. Это вся последовательность для проверки главной ветви от GIT и выполнения псевдо-установки. Мы предполагаем, что вы хотите запустить свою установку на основе GIT в /var/www/foswiki
Следующие команды проверяют абсолютно минимальный Foswiki (только картирование пользователя Core + по умолчанию). Это самая маленькая проверка, которая будет работать. Шаги:
git clone https://github.com/foswiki/distro.git foswikicd core && ./pseudo-install.pl default cd /var/www
mkdir foswiki
git clone https://github.com/foswiki/distro.git foswiki
Cloning into 'foswiki'...
remote: Counting objects: 134190, done.
remote: Compressing objects: 100% (37847/37847), done.
remote: Total 134190 (delta 87343), reused 132136 (delta 85289)
Receiving objects: 100% (134190/134190), 66.86 MiB | 1.63 MiB/s, done.
Resolving deltas: 100% (87343/87343), done.
Checking connectivity... done.
# By default this will leave you in the "master" branch, where leading edge development happens
# If you want to use the current release branch, change to the Release01x01 branch
# Skip this step if you want to remain on the experimental master branch.
cd foswiki
git checkout Release01x01
Branch Release01x01 set up to track remote branch Release01x01 from origin.
Switched to a new branch 'Release01x01'
# The extensions have all been checked out one level up from the "core" directory
# the next step is to link / copy them into the installation. This is done with pseudo-install.
cd core
perl -T pseudo-install.pl default
Installing extensions: PatchFoswikiContrib, AutoViewTemplatePlugin, CompareRevisionsAddOn, CommentPlugin, EditTablePlugin, EmptyPlugin, FamFamFamContrib, HistoryPlugin, InterwikiPlugin, JSCalendarContrib, JQueryPlugin, MailerContrib, TablePlugin, TwistyPlugin, PatternSkin, PreferencesPlugin, RenderListPlugin, SlideShowPlugin, SmiliesPlugin, SpreadSheetPlugin, TipsContrib, WysiwygPlugin, TinyMCEPlugin, TopicUserMappingContrib, TWikiCompatibilityPlugin, core
Processing AutoViewTemplatePlugin
Linked data/System/AutoViewTemplatePlugin.txt
mkdir /var/www/fw/core/lib/Foswiki/Plugins
...
#...
#... A large amount of output is generated.
#... Errors about dependencies on foswiki extensions can generally be ignored.
#... The extensions are not installed in the order that would resolve all dependencies.
#...
# If necessary, change ownership of all files to the webserver user.
# In this case that is 'apache:apache', though it may also be 'www-data:www-data'
# e.g. on Debian and Ubuntu systems, or something else entirely. Check first.
chown -R apache:apache foswiki
# Now configure Apache to use the Foswiki in /var/www/foswiki/core
core/../foswiki.httpd.conffoswiki.httpd.conf из вашего Apache httpd.conf или/etc/apache2/sites_enabled или /etc/apache2/vhosts.d , или /etc/apache2/Include ... Проверьте инструкции вашего локального распределения.Include /path/to/foswiki.httpd.confSymbolic link not allowed or link target not accessible сообщений типа, вам, вероятно, необходимо добавить +FollowSymLinks к Options для /var/www/foswiki/dev/core/pub Directory в конфигурации вашего Apache. На этом этапе, если вы укажите свой браузер на свой URL -адрес foswiki, он должен «просто работать», но отобразит предупреждение на начальной загрузке в верхней части конфигурации. Чтобы полностью настроить Foswiki, посетите URL bin/configure , разрешите любые предупреждения и ошибки и сохраните конфигурацию. Внимание: После того, как вы сохраните конфигурацию, вы не сможете использовать настройку снова, если вы не зарегистрировались и не предоставите себе авторитет «Adimin». Вы можете управлять, кто может использовать настройку, установив Security and Authentication -> Access Control {ConfigureFilter} . Когда эта опция будет установлена, он заменяет проверку для авторитета администратора и может позволить любому пользователю, включая гостевого пользователя, использовать Configure. Так что используйте осторожность!.
Время от времени вы захотите сохранить свою установку синхронизировать с последней версией в репозитории Foswiki GIT. Псевдо-установленное сценарий недостаточно умный, чтобы справиться с изменениями в манифестах, так что это идиотский способ обновления. Сначала он удаляет все ссылки (или копированные файлы), Git Fetch. И, наконец, делает новый псевдо-установку.
cd /var/www/foswiki/core
./pseudo-install.pl -uninstall all
git pull
./pseudo-install.pl default
chown -R apache:apache ..
Обычно просто выполнять GIT Pull будет достаточно, если кто -то не удаляет файлы (и даже тогда вы обычно можете игнорировать его).
Если вы разработчик, вы также можете установить комплект, необходимый для запуска модульных тестов, передавая параметр developer в pseudo-install.pl
cd /var/www/foswiki/core
./pseudo-install.pl developer
Это также установит BuildContrib и ряд других компонентов, полезных для разработчиков.
Модульные тесты выполняются с включенными утверждениями, но живая веб -среда - нет. Чтобы включить утверждения, отредактировать bin/LocalLib.cfg (если его нет, создайте его, копировав bin/LocalLib.cfg.txt ) и не зарегистрировать следующую строку
$ENV{FOSWIKI_ASSERTS} = 1;
Это обеспечивает дополнительные проверки, которые повлияют на производительность, но пойдут на некоторые проблемы, которые можно пропустить во время обычного использования в Интернете.
Foswiki 1.2 больше не поставляется с модулями CPAN. Теперь рекомендуется использовать диспетчер пакетов вашей системы или CPAN для установки зависимостей. Смотрите http://foswiki.org/system/systemrequirements. В случае, если вы не можете установить зависимости CPAN, псевдо-установка Cpancontrib для получения специфических зависимостей в стиле 1.x. (Cpancontrib еще не выпущен). Чтобы проверить эти модули, PAN LIB PRECTING должен быть включен в bin/locallib.cfg , не покинув следующую строку:
$CPANBASE = ''; # Uncommented: Default path prepended
Полем См. Комментарии в bin/LocalLib.cfg.txt для получения более подробной информации.
Вероятно, лучше всего проверить с помощью модулей платформы, а также отправленных модулей.
Приведенные выше команды описывают, как установить минималистскую фосвики. Сценарий псевдо-установки знает некоторые дополнительные трюки, которые можно использовать с неотъемлемыми расширениями. Если вы псевдо-установите расширение, которое в настоящее время не проверяется, Pseudo-Install автоматически клонирует расширение из github, используя https://github.com/foswiki/ExtensionName.git
Примечание. Несмотря на то, что мы используем управляемые филиалы выпуска (Master, Release01x00, Release01x01) в распределении ядра Foswiki («Distro»), расширения не деко, как правило, имеют только «мастер».
Вот как установить расширение без декорации, используя Antikispamplugin в качестве примера:
cd foswiki/core
./pseudo-install.pl AntiWikiSpamPlugin
Useless use of E at ./pseudo-install.pl line 1553.
Useless use of E at ./pseudo-install.pl line 1553.
Installing extensions: AntiWikiSpamPlugin
Processing AntiWikiSpamPlugin
Trying clone from git://github.com/foswiki/AntiWikiSpamPlugin.git...
Cloning into 'AntiWikiSpamPlugin'...
remote: Counting objects: 489, done.
remote: Total 489 (delta 0), reused 0 (delta 0)
Receiving objects: 100% (489/489), 86.42 KiB | 0 bytes/s, done.
Resolving deltas: 100% (185/185), done.
Checking connectivity... done.
Cloned AntiWikiSpamPlugin OK
Linked data/Main/AntiWikiSpamBypassGroup.txt
Linked data/System/AntiWikiSpamLocalList.txt
Linked data/System/AntiWikiSpamRegistrationWhiteList.txt
Linked data/System/AntiWikiSpamRegistrationBlackList.txt
Linked data/Sandbox/AntiWikiSpamTestTopic.txt
Linked data/System/AntiWikiSpamPlugin.txt
Linked lib/Foswiki/Plugins/AntiWikiSpamPlugin.pm
Linked lib/Foswiki/Plugins/AntiWikiSpamPlugin
Linked test/unit/AntiWikiSpamPlugin
Linked /var/www/fw/core/tools/develop/githooks/commit-msg as /var/www/fw/AntiWikiSpamPlugin/.git/hooks/commit-msg
Linked /var/www/fw/core/tools/develop/githooks/pre-commit as /var/www/fw/AntiWikiSpamPlugin/.git/hooks/pre-commit
Linked /var/www/fw/core/tools/develop/githooks/commit-msg as /var/www/fw/AntiWikiSpamPlugin/../.git/hooks/commit-msg
Linked /var/www/fw/core/tools/develop/githooks/pre-commit as /var/www/fw/AntiWikiSpamPlugin/../.git/hooks/pre-commit
AntiWikiSpamPlugin installed
Linked /var/www/fw/core/tools/develop/githooks/commit-msg as /var/www/fw/core/.git/hooks/commit-msg
Linked /var/www/fw/core/tools/develop/githooks/pre-commit as /var/www/fw/core/.git/hooks/pre-commit
Linked /var/www/fw/core/tools/develop/githooks/commit-msg as /var/www/fw/core/../.git/hooks/commit-msg
Linked /var/www/fw/core/tools/develop/githooks/pre-commit as /var/www/fw/core/../.git/hooks/pre-commit
Это удобно, если вы изменили много манифестов или имеете вручную мягкую связь с любыми файлами и хотите удалить какие-либо сломанные мягкие ссылки. Предположим, что ваш багажник оформлена на /var/www/foswiki . Вам также необходимо сделать это при переключении между релизом 01x01 и главными ветвями.
find -L /var/www/foswiki/core -type l -exec rm {} ;
Вы можете быстро и легко создать новое расширение, используя скрипт create_new_extension.pl , который установлен в core , когда вы псевдо-установочный
Если вы разрабатываете новый код, вы захотите настроить среду разработки и тестирования. Для этого вам понадобится псевдо-установка! BuildContrib,! UnittestContrib и! TestFixturePlugin.
./pseudo-install.pl developer
Затем:
cd test/unit
export FOSWIKI_LIBS`/var/www/foswiki/core/lib
perl ../bin/TestRunner.pl FoswikiSuite
(или эквивалентно на окнах)
Для получения полной информации см.
