Instiki

Instiki Parte de la familia Wiki Creador David Heinemeier Hansson Género Wiki

Instiki es un wiki bonito y fácil de configurar. Se ejecuta en Rails y se centra en la portabilidad y la estabilidad. Soporta carga de archivos, exportación a PDF, RSS, varios usuarios y la protección de contraseña. Algunos utilizan Instiki como un CMS debido a su capacidad de exportar páginas estáticas. Instiki reduce las barreras de interés para el uso de un wiki. Es tan simple para correr que permite usarlo en cualquier cosa como, tomar notas, de intercambio de ideas, la organización de una reunión.

Plataformas compatibles

Instiki sólo se basa en Rubí - la única dependencia externa (que incluye todas las demás dependencias). Cualquier sistema operativo que pueda ejecutar Ruby puede ejecutar Instiki, que incluye Windows, Linux, Mac OS X y muchos otros.

Requerimientos

Necesita al menos Rubí Versión 1.8.6 y 1.3.6 Rubygems, instalado en su sistema. La segunda dependencia es un sistema de base de datos, pero no te preocupes, la sqlite3 por defecto se instalará para ti, si no está ya instalado. También puede utilizar cualquier otro sistema de base de datos (MySQL, PostgreSQL, ...) con el apoyo de Rails.

Instalación

Instalación Instiki
Debe descargar y descomprimir la última versión, o la corriente versión de desarrollo. Este último contiene muchas correcciones y mejoras y es la versión que se está ejecutando en este sitio (por lo que, si se puede ver esta página, usted sabe que está trabajando). Si usted opta por la versión de desarrollo, también se puede obtener usando bzr:

bzr branch http://golem.ph.utexas.edu/~distler/code/instiki/svn/ location-of-Instiki/ 

o Git:

git clone http://github.com/parasew/instiki.git location-of-Instiki/ 

Asegúrese de que no hay espacios en la ruta de acceso que conducen al directorio donde instalar Instiki (es decir, que ninguno de los directorios padre tiene espacios en sus nombres).

Ejecución de Bundler y comenzando Instiki Ahora, desde el directorio principal Instiki, escriba el comando

 ruby bundle install --path vendor/bundle 

Esto descargará e instalará los otros requisitos previos (los sqlite3-ruby fijaciones, itextomml etc). Por último

./instiki --daemon 

comenzará hasta Instiki. Apunte su navegador web en http://localhost:2500 y comience a configurar su primera wiki.

Otros sistemas operativos

Puede instalar Instiki en varios sistemas oiperativos, quí tiene algunos ejemplos de como hacerlo:

• Obtener Rubí para su sistema, compilar si nessesary: http://ruby-lang.org
• En función de la versión de Rubygems que viene con el rubí, es posible que necesite:

sudo update joya --system 

• Obtener SQLite o compilar desde http://sqlite.org (también se puede usar MySQL o cualquier otro sistema de base de datos compatible si quieres)
• Run "paquete ruby instalar --path vendedor / bundle"
• Instiki plazo

Ahora está corriendo un wiki perfectamente adecuada en el puerto 2500 que va presentamos con la configuración de un solo paso, seguido de un área de texto de la página principal en http: // localhost: 2500

Windows

Las 1.9.3 y 2.0.0 RubyInstallers deben conseguir que los requisitos de tiempo de ejecución. Su kit de desarrollo proporciona las herramientas necesarias para instalar Rubygems "nativo" (como sqlite3-ruby y itextomml con cualquiera de las versiones de Ruby se recomienda encarecidamente que todo el camino en el que no reside Instiki contiene espacios en los nombres de directorio, ya que esto dará un mensaje de advertencia y los problemas potenciales.

• Busque * Rubí. A través del ejecutable, instale - Windows * http://rubyforge.org/projects/rubyinstaller
• Obtener Development Kit http://github.com/oneclick/rubyinstaller/wiki/development-kit
• En el directorio Instiki, ejecute "ruby bundle"
• Haga doble clic en instiki.bat o instiki.cmd y listo.

Mac OSX

Rubí 1.8.7 y Rubygems vienen instalados con las herramientas de desarrollo (opcional instalar, en el DVD de instalación del sistema) en MacOSX 10.6. En 10.07 a 10.09, Xcode (y las herramientas de línea de comandos asociados) están disponibles en la App Store. En cualquier caso, usted necesita las herramientas de desarrollo instaladas, con el fin de establecer Instiki. En sistemas más antiguos, puede que tenga que hacer un sudo gem update --system sudo gem update actualizar Rubygems a la última versión, antes de continuar. En los sistemas más recientes (León y posteriores), es posible que tenga que hacer un

sudo ln -s /usr/bin/gcc /usr/bin/gcc-4.2 

si los pasos conducen a un lixml2 not found error cuando intenta instalar Bundler Nokogiri.

O por otra vía:

• Run "joya sudo update --system" a través de la línea de comandos.
• Run "paquete ruby instalar --path vendedor / bundle" en el directorio Instiki.
• Run "Instiki rubí" y ahí lo tienes!

= Linux

En Debian y Ubuntu, usted necesitará:

$ sudo apt-get install ruby1.9.1 ruby1.9.1-dev ri1.9.1 libopenssl-ruby rake rubygems ruby-sqlite3 libxslt-dev libxml2-dev libsqlite3-dev swig flex bison 

(Algunos de estos no existen en mi distro Ubuntu (suricata): libopenssl-rubí, libxslt-dev (tengo libxml2-dev libxslt rubí), (tengo libxml-dev).) En Fedora, que sería:

$ yum install make ruby ruby-devel rubygems sqlite sqlite-devel swig flex bison 

sin embargo, al parecer, es posible que deba suministrar el enlace simbólico necesario

$ ln -s /usr/lib/libsqlite3.so.0.8.6 /usr/lib/libsqlite3.so 

Nota: Si usted recibe un

 install_gem_spec_stubs': undefined method `loaded_specs' for Gem:Module (NoMethodError) 

error cuando intenta ejecutar Instiki, entonces la versión de Rubygems que instaló es demasiado viejo. Vea estas instrucciones. En particular, es necesario

 sudo gem install rubygems-update sudo update_rubygems 

para actualizar Rubygems a una versión suficientemente reciente. (Ver la discusión aquí para una visión más clara.)

Características

Entre las muchas características que posee esta wiki, se ilustran las siguientes:

• Búsqueda Expresión regular: Encuentra cosas profunda muy rápido.
• Revisiones: Sigue los cambios en todas las páginas de su nacimiento. Retroceso a un rev anterior.
• Exportación a HTML o por marcadores en una postal: Tome toda la wiki con vosotros casa o para referencia.
• Feeds RSS para realizar un seguimiento de las páginas revisadas recientemente.
• Múltiples redes: Crear wikis independientes con su propio espacio de nombres.
• Protegidos con contraseña telas: Mantener en privado.
• Autores: Cada revisión se asocia con un autor, para que pueda ver lo que ha cambiado.
• Velocidad: Usando Madelein para la persistencia (todas las páginas están en memoria).
• Tres opciones de marcado: Textil (default / RedCloth), Markdown (BlueCloth) y RDoc.
• Servidor web incorporado: A través WEBrick.
• Internacionalización: palabras Wiki en cualquier latino, griego, Cirilo, o armenio caracteres.
• Diffs color: control de cambios a través de las revisiones.
• Soporte para Matemáticas (utilizando la sintaxis itex [1])
• Soporte para la edición WYSIWYG SVG - incrustar gráficos SVG en tu página wiki.
• Internacionalización: palabras Wiki en cualquier latino, griego, Cyrillian o caracteres armenio.
• Se ejecuta en SQLite3 por defecto, puede ser configurado para ejecutarse en PostgreSQL, MySQL, DB2, [[Firebird, OpenBase, Oracle, SQL Server o Sybase.

Otras características

• Se basa en Rails 2.3.18 y está siendo desarrollado activamente. En el último año más o menos antes de la fusión, la mayoría de los checkins en la rama principal de Instiki habían sido parches de seguridad, portado desde aquí.
• En particular, esta rama es compatible con Ruby 1.9.3, 2.0, 2.1 y 2.2.
• Se ha modificado extensivamente para que funcione correctamente como XHTML.
• Hace contenido negociación, para servir application/xhtml+xml para los navegadores compatibles. Eso incluye Internet Explorer, con el plugin de MathPlayer instalado.
• Para aquellos navegadores que no soporten MathML, Instiki utiliza mathjax renderizado basado en Javascript.
• Markdown es el predeterminado sintaxis de marcado. Textiles está disponible (pero no recomendado - el filtro textil no funciona en un entorno XHTML, por lo que muchas de las características avanzadas de esta rama no están disponibles bajo textiles).
• Utiliza Maruku como su motor de rebajas, en lugar de BlueCloth. Esto proporciona mucho mejor rendimiento, así como muchas extensiones a la sintaxis Markdown habitual.
• Tiene una sintaxis mejorada para marcar teoremas, demostraciones, etc.
• Utiliza xhtmldiff para generar documentos "línea roja" de los cambios entre las versiones sucesivas de una página wiki (en el enlace "Ver cambios" en la parte inferior de cualquier página wiki).
• Tiene un real, funcional, vista de látex, que produce una salida TeXable (ecuaciones y todo) de su Markdown + fuente itex.
• Tiene un S5 salida de la vista, lo que produce un S5 presentación de diapositivas (con ecuaciones!) De su Markdown + fuente itex. Y es compatible con S5 Temas, para que a medida look-and-feel.
• Cuenta con un sistema incorporado en SVG-Editor. Puede crear hermosas, gráficos vectoriales escalables justo en tus páginas wiki.
• Utiliza Atom 1.0 para sus alimentaciones de sindicación.
• Enhanced características administrativas, para facilitar la gestión de páginas Wiki y los archivos subidos.
• Apoyo al HTML5 (con formatos de audio y video).
• Soporte para incrustar vídeos de Youtube.
• Soporte para incrustar archivos Wolfram CDF.
• x-sendfile apoyo.
• Almacenamiento en caché basado en el sistema de archivos, soporte completo para Etag y condicional GET , para un uso más eficiente del ancho de banda.
• Muchas otras mejoras y correcciones de errores.

Seguridad

la seguridad es uno de los puntos más importantes en un aplicación o software, por lo que este punto debe tenerse muy en cuenta. Correr como un usuario sin privilegios
Si tiene acceso de superusuario en el recuadro en el que está ejecutando Instiki, puede tener una configuración más segura mediante la ejecución Instiki bajo un nuevo, UID sin privilegios. 1. Crear un nuevo usuario, sin privilegios, usuario, Instiki sin acceso a shell. 2. Permitir que este nuevo acceso de los usuarios sólo a los archivos que son absolutamente necesarias:

% sudo chown instiki public secret db db/production.db.sqlite3 config/environment.rb config/database.yml % sudo chown -R instiki log storage cache webs tmp 

3. Ejecute Instiki:

% sudo -u instiki ./instiki --daemon 

4. En esta configuración, puede detener Instiki con:

% sudo -u instiki kill pid-of-Instiki 

Fuente y Licencia

Instiki es software libre, licenciado bajo la misma licencia como Ruby. La versión actual es 0.19.7. La versión de desarrollo actual (que es lo que este sitio está en ejecución en) está disponible en el repositorio de BZR o como un archivo tar. El BZR tiene un feed Atom, con la que se puede estar al tanto del desarrollo del software. Apoyo Matemáticas es proporcionada por itex2MML encuadernaciones Rubí (disponibles como rubygem), cuyo desarrollo puede seguirse mediante la suscripción de su feed Atom. itex2MML obtiene su licencia de una triple LGPL, GPL y MPL licencia.

Versiones

• 0.10.2 - 30 julio de 2005, (80 KB).
• 0.10.1 - 1 mayo de 2005, (80 KB).
• 0.10.0 - 8 abril 2005, (70 KB).
• 0.9.2 - 7 enero 2005, (50 KB).

Fuentes

• https://golem.ph.utexas.edu/wiki/instiki/show/HomePage (en inglés)
• http://c2.com/cgi/wiki?InstikiWiki (en inglés)
• https://rubygems.org/gems/instiki/versions/0.10.2 (en inglés)
• https://github.com/parasew/instiki (en inglés)