distro
1.0.0
Estas instrucciones están más orientadas a los desarrolladores, y los administradores que desean usar el "borde sangrado" de Foswiki. Recomendamos usar nuestras distribuciones empaquetadas. Ver nuestra página de descarga
Puede ejecutar una instancia de Foswiki desde este clon simplemente señalando a Apache. Ver el apaconfiggenerator
Nota: Configuración ha sido completamente reescrita en la rama maestra. Foswiki ahora puede "arranque" a sí mismo sin una configuración. Después de la pseudo instalación de las extensiones predeterminadas, apunte a su navegador a su URL predeterminada para el nuevo sitio configurado en ApacheConFigGenerator. (Ex. http://yoursite.com , http://yoursite.com/foswiki , o http://yoursite.com/foswiki/bin/view dependiendo de la configuración de Apache)
Para "instalar" extensiones en un área de pago, debe usar el script pseudo-install.pl para instalarlas. En Unix/Linux, este script genera enlaces suaves desde el árbol central hasta las extensiones, por lo que puede trabajar en su código in situ y ver el impacto de los cambios en su foswiki vivo sin necesidad de hacer un paso de instalación. Windows no admite enlaces suaves, por lo que el script también se puede ejecutar en modo -copy (el valor predeterminado en Windows), pero en este caso tendrá que volver a ejecutarlo cada vez que cambie su extensión. Usar:
pseudo-install.pl default Instalar los contribuyentes y complementos predeterminados (por ejemplo, extensiones.twistycontrib, que se basa en extensiones. Patternskin)pseudo-install.pl developer para instalar las extensiones de desarrollador adicionales. La opción de desarrollador también instala todas las extensiones predeterminadas. Consulte el comentario del encabezado del script pseudo-install.pl (directorio central de pago) para obtener opciones y más información. Tenga en cuenta que pseudo-install.pl solo funciona con extensiones que tienen un archivo manifiesto, como lo requiere Extensions.BuildContrib. Los ejemplos de script a continuación son para bash Shell.
La situación típica es que desea ejecutar un foswiki pseudoinstalado revisado desde la rama "maestra". Y si desarrolla complementos, desea poder activar su complemento en esta instalación. Esta es la secuencia completa para ver la rama maestra de GIT y hacer la pseudoinstalación. Asumimos que desea ejecutar su instalación basada en Git en /var/www/foswiki
Los siguientes comandos consulte un Foswiki absolutamente mínimo (solo la asignación de usuario Core + predeterminada). Este es el pago más pequeño que se ejecutará. Los pasos son:
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 desde su apache httpd.conf o/etc/apache2/sites_enabled o /etc/apache2/vhosts.d , o /etc/apache2/Include ... verifique las instrucciones de su distribución local.Include /path/to/foswiki.httpd.confSymbolic link not allowed or link target not accessible , entonces probablemente necesite agregar +FollowSymLinks a las Options para el directorio /var/www/foswiki/dev/core/pub directorio en su configuración de apache. En este punto, si señala su navegador a su URL de foswiki, debería "solo funcionar", pero mostrará una advertencia de arranque en la parte superior de la configuración. Para configurar completamente Foswiki, visite la URL bin/configure , resuelva cualquier advertencia y error y guarde la configuración. PRECAUCIÓN: una vez que guarde la configuración, no podrá usar la configuración nuevamente a menos que se haya registrado y se haya otorgado la autoridad "adimin". Puede controlar quién puede usar Configurar configurando Security and Authentication -> Access Control {ConfigureFilter} . Cuando se establece esa opción, reemplaza el cheque para la autoridad de administración y puede permitir que cualquier usuario, incluido el usuario invitado, use Configure. ¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡¡
De vez en cuando, querrá mantener su instalación en sincronización con la última versión en el repositorio de Foswiki Git. El script de pseudo-instalación no es lo suficientemente inteligente como para hacer frente a los cambios a los manifiestos, por lo que esta es la forma de actualización de idiotas. Primero elimina todos los enlaces (o archivos copiados), Git Fetch. Y finalmente hace un nuevo pseudo-instalación.
cd /var/www/foswiki/core
./pseudo-install.pl -uninstall all
git pull
./pseudo-install.pl default
chown -R apache:apache ..
Normalmente, solo hacer la extracción de Git será suficiente, a menos que alguien haya eliminado los archivos (e incluso entonces, generalmente puede ignorarlo).
Si es un desarrollador, también puede instalar el kit requerido para ejecutar pruebas unitarias, pasando el parámetro developer a pseudo-install.pl
cd /var/www/foswiki/core
./pseudo-install.pl developer
Esto también instalará BuildContrib y varios otros componentes útiles para los desarrolladores.
Las pruebas unitarias se ejecutan con afirmaciones habilitadas, pero el entorno web en vivo no. Para habilitar Afirss, edite bin/LocalLib.cfg (si no está allí, cree copiando bin/LocalLib.cfg.txt ) y un comment la siguiente línea
$ENV{FOSWIKI_ASSERTS} = 1;
Esto permite pruebas de validación adicionales que afectarán el rendimiento, pero atraparán algunos problemas que podrían perderse durante el uso de la web normal.
Foswiki 1.2 ya no se envía con módulos CPAN. Ahora se recomienda utilizar el Administrador de paquetes de su sistema o CPAN para instalar dependencias. Ver http://foswiki.org/system/systemRequirements. En el caso de que no pueda instalar las dependencias de CPAN, pseudo-instalar el CPANCONTRIB para obtener las dependencias específicas de Foswiki de estilo 1.x. (CPANCONTRIB aún no se ha lanzado). Para probar estos módulos, la preparación de CPAN LIB debe habilitarse en bin/locAllib.cfg desencadenando la siguiente línea:
$CPANBASE = ''; # Uncommented: Default path prepended
. Vea los comentarios en bin/LocalLib.cfg.txt para obtener más detalles.
Probablemente sea mejor probar utilizando módulos de plataforma, así como los módulos enviados.
Los comandos de ejemplo anteriores describen cómo instalar un foswiki minimalista . El script de pseudo-instalación conoce algunos trucos adicionales para usar con extensiones no deformes. Si pseudo-instala una extensión que no se verifica actualmente, Pseudo-Install clonará automáticamente la extensión de GitHub usando https://github.com/foswiki/ExtensionName.git
Nota: Aunque utilizamos ramas administradas de lanzamiento (Master, Release01x00, Release01x01) en la distribución de núcleo de Foswiki ("Distro"), las extensiones no defensoras generalmente solo tienen una rama "maestra".
Aquí le mostramos cómo instalar una extensión no definitiva, utilizando antiwikispamplugin como ejemplo:
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
Esto es útil si ha cambiado muchos manifiestos o ha retirado manualmente cualquier archivo, y desea eliminar cualquier enlace suave rotos. Suponga que su pago del tronco es AT /var/www/foswiki . También deberá hacer esto al cambiar entre Release01x01 y las ramas maestras.
find -L /var/www/foswiki/core -type l -exec rm {} ;
Puede crear rápida y fácilmente una nueva extensión utilizando el script create_new_extension.pl que se instala en core cuando pseudoinstala las extensiones.BuildContrib.
Si está desarrollando un nuevo código, querrá configurar el entorno de desarrollo y prueba. ¡Para esto necesitará pseudo-instalar! BuildContrib ,! UnittestContrib y! TestFixturePlugin.
./pseudo-install.pl developer
Entonces:
cd test/unit
export FOSWIKI_LIBS`/var/www/foswiki/core/lib
perl ../bin/TestRunner.pl FoswikiSuite
(o equivalente en Windows)
Para obtener detalles completos, consulte http://foswiki.org/development/unittests#settingupatestenvironment
