distro
1.0.0
Diese Anweisungen sind eher für Entwickler und Administratoren ausgerichtet, die die "Blutungskante" von Foswiki verwenden möchten. Wir empfehlen die Verwendung unserer verpackten Verteilungen. Siehe unsere Download -Seite
Sie können eine Foswiki -Instanz aus diesem Klon ausführen, indem Sie Apache darauf hinweisen. Siehe den ApacheConfiggenerator
HINWEIS: Konfiguration wurde in der Master -Filiale vollständig umgeschrieben. Foswiki kann sich jetzt ohne Konfiguration "Bootstrap" selbst "starten". Zeigen Sie Ihren Browser auf Ihre Standard-URL für die neue Site, wie in ApacheConfiggenerator konfiguriert, nach der Pseudoinstallation der Standardverlängerungen auf Ihre Standard-URL. http://yoursite.com http://yoursite.com/foswiki/bin/view http://yoursite.com/foswiki
Um Erweiterungen in einem Kassenbereich zu "installieren", sollten Sie das Skript pseudo-install.pl verwenden, um sie zu installieren. Auf UNIX/Linux generiert dieses Skript weiche Links vom Kernbaum bis zu den Erweiterungen, sodass Sie in situ an Ihrem Code arbeiten und die Auswirkungen der Änderungen Ihres Live-Foswiki sehen können, ohne einen Installationsschritt durchzuführen. Windows unterstützt keine Soft -Links, sodass das Skript auch im -copy -Modus (die Standardeinstellung unter Windows) ausgeführt werden kann. In diesem Fall müssen Sie es jedoch jedes Mal erneut ausführen, wenn Sie Ihre Erweiterung ändern. Verwenden:
pseudo-install.pl default für die Installation der Standardbeiträge und Plugins (z.pseudo-install.pl developer zur Installation der zusätzlichen Entwicklererweiterungen. Die Entwickleroption installiert auch alle Standardverlängerungen. Die Optionen und weitere Informationen finden Sie im Header-Kommentar des Skripts pseudo-install.pl (Kernverzeichnis der Kasse). Beachten Sie, dass pseudo-install.pl nur mit Erweiterungen funktioniert, die eine Manifestdatei haben, wie dies von den Erweiterungen erforderlich ist. Script -Beispiele unten finden Sie für bash -Shell.
Die typische Situation ist, dass Sie einen von Pseudo installierten Foswiki aus "Master" -Ast ausführen möchten. Wenn Sie Plugins entwickeln, möchten Sie Ihr Plugin in dieser Installation aktivieren können. Dies ist die gesamte Sequenz, um den Master-Zweig von Git zu überprüfen und den Pseudoinstall zu erledigen. Wir gehen davon aus, dass Sie Ihre GIT -basierte Installation in /var/www/foswiki ausführen möchten
Die folgenden Befehle finden Sie ein absolut minimales Foswiki (nur die Core + Standard -Benutzerzuordnung). Dies ist die kleinste Kasse, die ausgeführt wird. Die Schritte sind:
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 aus Ihrem Apache httpd.conf oder ein/etc/apache2/sites_enabled oder /etc/apache2/vhosts.d , oder /etc/apache2/Include , die die Anweisungen Ihrer lokalen Verteilung überprüfen.Include /path/to/foswiki.httpd.confSymbolic link not allowed or link target not accessible , müssen Sie die Optionen für die Options /var/www/foswiki/dev/core/pub -Verzeichnis in Ihrer Apache -Konfiguration wahrscheinlich +FollowSymLinks . Wenn Sie Ihren Browser auf Ihre Foswiki -URL verweisen, sollte er "einfach funktionieren", aber eine Bootstrap -Warnung oben in der Konfiguration anzeigen. Um Foswiki vollständig zu konfigurieren, besuchen Sie die bin/configure von URL, beheben Sie Warnungen und Fehler und speichern Sie die Konfiguration. VORSICHT: Sobald Sie die Konfiguration gespeichert haben, können Sie konfigurieren Sie konfigurieren, es sei denn, Sie haben sich "Adimin" -Heorte registriert und selbst gewährt. Sie können steuern, wer konfigurieren kann, indem Sie Security and Authentication einstellen -> Access Control {ConfigureFilter} . Wenn diese Option festgelegt ist, ersetzt sie den Scheck über die Administratorbehörde und ermöglicht es jedem Benutzer, einschließlich des Gastbenutzers zu konfigurieren. Verwalten Sie also Vorsicht!.
Ab und zu möchten Sie Ihre Installation mit der neuesten Version im Foswiki Git -Repository synchronisieren. Das Pseudo-Installationskript ist nicht intelligent genug, um mit Änderungen zu Manifits fertig zu werden. Dies ist daher die idiotbeweisende Methode zum Aktualisieren. Es entfernt zuerst alle Links (oder kopierte Dateien), Git -Fetch. Und schließlich einen neuen Pseudoinstall.
cd /var/www/foswiki/core
./pseudo-install.pl -uninstall all
git pull
./pseudo-install.pl default
chown -R apache:apache ..
Normalerweise reicht nur das Git -Zug aus, es sei denn, jemand hat Dateien entfernt (und selbst dann können Sie ihn normalerweise ignorieren).
Wenn pseudo-install.pl ein Entwickler sind, können developer auch das Kit installieren
cd /var/www/foswiki/core
./pseudo-install.pl developer
Dadurch wird auch BuildContrib und eine Reihe anderer Komponenten installiert, die für Entwickler nützlich sind.
Die Unit -Tests werden mit den Aktivitäten durchgeführt, die Live -Webumgebung jedoch nicht. Um Behauptungen zu aktivieren, bearbeiten Sie bin/LocalLib.cfg (falls dies nicht vorhanden ist, indem Sie bin/LocalLib.cfg.txt kopieren) und die folgende Zeile entfernen
$ENV{FOSWIKI_ASSERTS} = 1;
Dies ermöglicht zusätzliche Validierungstests, die sich auf die Leistung auswirken, aber einige Probleme aufnehmen, die möglicherweise während der normalen Webnutzung übersehen werden.
Foswiki 1.2 wird nicht mehr mit CPAN -Modulen geliefert. Es wird nun empfohlen, den Paketmanager oder die CPAN Ihres Systems zu verwenden, um Abhängigkeiten zu installieren. Siehe http://foswiki.org/system/SystemRequirements. Für den Fall, dass Sie die CPAN-Abhängigkeiten nicht installieren können, installieren Sie Pseudo die CPancontrib, um die Foswiki-spezifischen Abhängigkeiten im 1.X-Stil zu erhalten. (Cpancontrib ist noch nicht veröffentlicht). Um diese Module zu testen, sollte die CPAN -LIB -Vorbereitung in Bin/Locallib.cfg aktiviert werden, indem die folgende Zeile übernommen wird:
$CPANBASE = ''; # Uncommented: Default path prepended
. Weitere Informationen finden Sie in den Kommentaren in bin/LocalLib.cfg.txt .
Es ist wahrscheinlich am besten, mit Plattformmodulen sowie den versendeten Modulen zu testen.
Die obigen Beispielbefehle beschreiben, wie ein minimalistisches Foswiki installiert wird. Das Skript für Pseudo-Installation kennt einige zusätzliche Tricks, die Sie bei Nicht-Default-Erweiterungen verwenden sollten. Wenn Sie Pseudo-Install eine derzeit nicht ausgecheckte Erweiterung haben, klonen Sie die Erweiterung von Github automatisch mit https://github.com/foswiki/ExtensionName.git
HINWEIS: Obwohl wir Release Managed Zweigstellen (Master, Release01x00, Release01x01) in der Foswiki-Kernverteilung ("Distro)) verwenden, haben Nicht-Default-Erweiterungen in der Regel nur einen" Master "-Ast.
Hier erfahren Sie, wie Sie eine Nicht-Default-Erweiterung mit Antiwikispamplugin als Beispiel verwenden:
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
Dies ist praktisch, wenn Sie viele Manifests geändert haben oder Dateien manuell weichleuchten und zerbrochene weiche Links entfernen möchten. Nehmen wir an, Ihre Kofferraum -Kasse ist bei /var/www/foswiki . Sie müssen dies auch tun, wenn Sie zwischen Release01x01 und Master -Zweigen wechseln.
find -L /var/www/foswiki/core -type l -exec rm {} ;
Sie können schnell und einfach eine neue Erweiterung mit dem Skript create_new_extension.pl erstellen, das in core installiert ist, wenn Sie die Erweiterungen in der Erweiterung installieren.BuildContrib.
Wenn Sie einen neuen Code entwickeln, möchten Sie die Entwicklungs- und Testumgebung einrichten. Dazu müssen Sie Pseudo-Installation! BuildContrib,! UnittestContrib und! TestFixTeplugin.
./pseudo-install.pl developer
Dann:
cd test/unit
export FOSWIKI_LIBS`/var/www/foswiki/core/lib
perl ../bin/TestRunner.pl FoswikiSuite
(oder gleichwertig unter Windows)
Ausführliche Informationen finden Sie unter http://foswiki.org/development/unittests#settingupatestenvironment
