これらの指示は、開発者と、Foswikiの「出血エッジ」を使用したい管理者向けに向けられています。パッケージ化された分布を使用することをお勧めします。ダウンロードページを参照してください
Apacheを指すだけで、このクローンからFoswikiインスタンスを実行できます。 Apacheconfiggeneratorを参照してください
注:configureはマスターブランチで完全に書き直されています。 Foswikiは、構成なしでそれ自体を「ブートストラップ」できるようになりました。デフォルトの拡張機能を擬似インストールした後、apacheconfiggeneratorで構成されている新しいサイトのデフォルトのURLでブラウザを指します。 (ex。http: http://yoursite.com : http://yoursite.com/foswiki 、またはhttp://yoursite.com/foswiki/bin/view apache構成に応じて)
チェックアウトエリアに拡張機能を「インストール」するには、 pseudo-install.plスクリプトを使用してそれらをインストールする必要があります。 Unix/Linuxでは、このスクリプトはコアツリーから拡張機能へのソフトリンクを生成するため、コードで作業して、インストールステップを実行する必要なくライブFoswikiの変更の影響を確認できます。 Windowsはソフトリンクをサポートしていないため、スクリプトを-copyモード(Windowsのデフォルト)で実行することもできますが、この場合、拡張機能を変更するたびに再実行する必要があります。使用:
pseudo-install.pl defaultデフォルトのコントリブとプラグインをインストールするには(extensions.patternskinに依存しているextensions.twistycontribなど)。pseudo-install.pl developerに追加の開発者拡張機能をインストールします。開発者オプションは、すべてのデフォルト拡張機能もインストールします。オプションと詳細については、 pseudo-install.plスクリプト(チェックアウトのコアディレクトリ)のヘッダーコメントを参照してください。 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.confに保存しますfoswiki.httpd.conf Apache httpd.confから含めます/etc/apache2/Include /etc/apache2/sites_enabledまたは/etc/apache2/vhosts.dに保存できます。Include /path/to/foswiki.httpd.confSymbolic link not allowed or link target not accessible場合、Apache構成の/var/www/foswiki/dev/core/pubディレクトリのOptionsに+FollowSymLinks必要があります。この時点で、ブラウザをFoswiki URLに向けると、「機能するだけ」が必要ですが、構成の上部にブートストラップ警告が表示されます。 Foswikiを完全に構成するには、 bin/configure URLにアクセスし、警告とエラーを解決し、構成を保存します。注意:構成を保存すると、登録して「adimin」権限を付与していない限り、構成を再度使用できなくなります。 Security and Authenticationを設定して、誰がConfigureを使用できるかを制御できます - > 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や開発者に役立つ他の多くのコンポーネントもインストールされます。
ユニットテストは、有効になっているアサートで実行されますが、ライブWeb環境は実行されません。アサートを有効にするには、 bin/LocalLib.cfg (そこにない場合は、 bin/LocalLib.cfg.txtをコピーして作成)を作成し、次の行をcommentしてください
$ENV{FOSWIKI_ASSERTS} = 1;
これにより、パフォーマンスに影響を与える追加の検証テストが可能になりますが、通常のWeb使用量中に見逃される可能性のある問題をキャッチします。
Foswiki 1.2は、CPANモジュールを搭載しなくなりました。現在、システムのパッケージマネージャー(CPAN)を使用して依存関係をインストールすることをお勧めします。 http://foswiki.org/system/systemRequirementsを参照してください。 CPAN依存関係をインストールできない場合は、CPANTONTRIBをインストールして1.XスタイルのFoswiki固有の依存関係を取得します。 (Cpancontribはまだリリースされていません)。これらのモジュールをテストするには、次の行を除外して、 bin/locallib.cfgで準備する必要があります。
$CPANBASE = ''; # Uncommented: Default path prepended
。詳細については、 bin/LocalLib.cfg.txtのコメントを参照してください。
おそらく、出荷されたモジュールだけでなく、プラットフォームモジュールを使用してテストするのが最善です。
上記の例のコマンドは、ミニマリストのfoswikiのインストール方法について説明します。擬似インストールスクリプトは、非デフォルト拡張機能で使用する追加のトリックをいくつか知っています。現在チェックアウトされていない拡張機能を擬似インストールすると、擬似インストールはhttps://github.com/foswiki/ExtensionName.gitを使用してgithubから拡張機能を自動的にクローンします
注: Foswiki Core Distribution(「ディストリビューション」)でリリースマネージドブランチ(Master、Release01x00、Release01x01)を使用しますが、非デフォルト拡張は通常「マスター」ブランチのみを備えています。
例として以下に、非デフォルト拡張機能をインストールする方法は次のとおりです。
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 {} ;
extensions.buildcontribを擬似インストールするときにcoreにインストールされているcreate_new_extension.plスクリプトを使用して、新しい拡張機能を迅速かつ簡単に作成できます。
新しいコードを開発している場合は、開発環境とテスト環境をセットアップする必要があります。このためには、擬似インストール!buildcontrib、!unittestcontrib、および!testfixturepluginが必要です。
./pseudo-install.pl developer
それから:
cd test/unit
export FOSWIKI_LIBS`/var/www/foswiki/core/lib
perl ../bin/TestRunner.pl FoswikiSuite
(またはWindowsで同等)
詳細については、http://foswiki.org/development/unittests#settingupatestenvironmentを参照してください