ViewVC
| ||||||||||||||||
ViewVC es una interfaz para repositorios de control de versiones CVS y Subversion. Genera plantillas HTML para presentar directorios navegables, revisión y listados de registro de cambios. Permite mostrar versiones específicas de los archivos así como diferecias entre esas versiones. Provee la mayor parte de las funcionalidades de tipo reporte que se esperarían de una herramienta de control de versiones. Cuenta son el soporte para CVS sistema con acceso de archivos y repositorios de subversión, el apoyo para la autorización basada en rutas, incluyendo el análisis y honrar Subversion autorizar los archivos de configuración, generación RSS feed para el seguimiento de los cambios en repositorios o elementos individuales dentro de los repositorios, individualmente apoyo host virtual configurable, y anotación / display basada en la línea.
Sumario
Características
Estas son algunas de las características que tiene integrada la wiki ViewVC:
- El apoyo a repositorios CVS y Subversion- sistema de archivos accesible.
- Soporte para la autorización basada en ruta, incluyendo el análisis y rendir homenaje a los archivos de configuración authz Subversion.
- Generación feed RSS de seguimiento de los cambios a los repositorios o elementos individuales dentro de los repositorios.
- Apoyo host virtual individualmente configurable.
- Basada en la línea de visualización anotación / culpa.
- Capacidades de gráficos de revisión (a través de la integración con CvsGraph) (CVS solamente).
- El resaltado de sintaxis apoyo.
- Generación de salida basado en plantillas.
- Generación Tarball (por etiqueta / rama de CVS, por la revisión de Subversion).
- Soporte de localización basado en la cabecera de petición Accept-Language.
- Capacidad para funcionar tanto como script CGI o como un servidor independiente.
- Basado en Regexp búsqueda de archivos.
- Archivo de configuración INI-como (en oposición a requerir ajustes de código reales).
- Apoyo a CVS-sistema de archivos accesible y repositorios de Subversion.
- Apoyo host virtual individualmente configurable.
- Capacidades de gráficos de revisión (CVS solamente).
- Apoyo resaltado de sintaxis.
- Instalaciones de consulta de metadatos.
- Tintadas, diferencias de lado a lado.
Requerimientos
El único requisito de software para correr ViewVC es una versión adecuada de Python. Los detalles de que, al igual que todos los demás requisitos, dependen de lo que quieres hacer con la herramienta. Como los que han cambiado un poco en los últimos años, lo mejor es consultar el archivo de instalación de la versión específica ViewVC que desea evaluar a sus necesidades exactas. Aquí son punteros a los archivos de instalación de las líneas actuales de liberación principales:
Software necesario y la configuración necesaria para ejecutar ViewVC:
Para Soporte CVS:
* Python 1.5.2 o posterior (lo siento, no hay soporte 3.x aún)
(http://www.python.org/)
* RCS, Sistema de Control de Revisiones
(http://www.cs.purdue.edu/homes/trinkle/RCS/)
* GNU-diff para sustituir implementaciones diff sin la opción -u
(http://www.gnu.org/software/diffutils/diffutils.html)
* Sólo lectura, el acceso físico a un repositorio CVS
(Ver http://www.cvshome.org/ para más información)
Para Apoyo Subversion:
* Python 2.0 o posterior (lo siento, no hay soporte 3.x aún)
(http://www.python.org/)
* Subversion, Sistema de Control de Versiones, 1.3.1 o posterior
(instalación binaria y enlaces Python)
(http://subversion.apache.org/)
Opcional:
* Un servidor web capaz de ejecutar programas CGI
(por ejemplo, Apache en http://httpd.apache.org/)
* MySQL 3.22 y MySQLdb 0.9.0 o posterior para crear una base de datos cometer
(http://www.mysql.com/)
(http://sourceforge.net/projects/mysql-python)
* Pygments 0.9 o posterior, motor de resaltado de sintaxis
(http://pygments.org)
* CvsGraph 1.5.0 o posterior, CVS gráfica Generador árbol de revisión
(http://www.akhphd.au.dk/~bertho/cvsgraph/)
Comprobación de validez rápida
Si lo que desea es ver lo que su repositorio se ve como cuando se ve a través ViewVC, escriba:
$ Bin / standalone.py -r / path / to / GUARDAMUEBLES
Esto iniciará un servidor ViewVC diminuta en http: // localhost: 49152 / viewvc /, al que se pueden conectar con su navegador.
=== Funcionamiento estándar ===
Para iniciar la instalación de forma inmediata (en UNIX): tipo "./viewvc-install" en el directorio actual y responder a las indicaciones. Cuando acabados, editar el viewvc.conf archivo en el directorio de instalación para decirle ViewVC las rutas de acceso a sus CVS y repositorios de Subversion. A continuación, configure su servidor web (en la forma adecuada para que el navegador) ejecutar <VIEWVC_INSTALLATION_DIRECTORY> /bin/cgi/viewvc.cgi. La sección `INSTALACIÓN ViewVC 'a continuación se sigue recomendando la lectura.
INSTALACIÓN ViewVC
NOTA: Los usuarios de Windows pueden hacer referencia a las ventanas / README para específico para Windows instrucciones de instalación.
1) Para obtener viewvc.cgi de trabajo, asegúrese de que tiene instalado Python
y un servidor web que es capaz de ejecutar scripts CGI (cualquiera basado en la extensión .cgi, o mediante la colocación de la secuencia de comandos dentro de una específica directorio).
Tenga en cuenta que para navegar repositorios CVS, el guión viewvc.cgi necesita tener sólo lectura, acceso físico al repositorio (o una copia de la misma). Por lo tanto, rsh / ssh o pserver acceso al repositorio no funcionará. Y es necesario tener las utilidades RCS instalan, específicamente "rlog", "rcsdiff", y "co".
2) La instalación está a cargo de la secuencia de comandos ./viewvc-install. Ejecuta esto
guión y se le pedirá una ruta de acceso raíz de instalación. El valor predeterminado es / viewvc-VERSION / usr / local, donde VERSION es la versión de este comunicado ViewVC. El instalador establece la instalación ruta de acceso en algunos de los archivos, y ViewVC no se puede mover a una camino diferente después de la instalación.
NOTA: mientras que 'root' se requiere generalmente para crear / usr / local / viewvc, ViewVC no tiene que ser instalado como root, ni ejecutar como root. Es igual de válido para colocar ViewVC en un directorio principal, también.
NOTA: si su sistema utiliza un umask restrictiva, es posible que necesite ajustar los permisos de la estructura de directorios que viewvc a instalar crea de manera que, por ejemplo, los módulos en el lib / subdirectorio en realidad son legibles por los principales programas de la bin / subdirectorio.
NOTA: viewvc-instalación creará los directorios si es necesario. Va a pregunte antes de sobrescribir archivos que pueden haber sido modificados (tales como viewvc.conf), por lo que es seguro de instalar en la parte superior de la una instalación anterior. Siempre va a sobrescribir archivos de programa, ahora bien.
3) Editar <VIEWVC_INSTALLATION_DIRECTORY> /viewvc.conf para su específica
configuración. En particular, examinará las siguientes opciones de configuración:
cvs_roots (por CVS)
svn_roots (para Subversion)
root_parents (por CVS o Subversion)
default_root
root_as_url_component
rcs_dir
mime_types_files
Hay algunas otras opciones que suelen ser agradable a cambiar. Ver viewvc.conf para más información. ViewVC ofrece un trabajo, aspecto predeterminado. Sin embargo, si desea personalizar el aspecto de ViewVC luego editar los archivos en <VIEWVC_INSTALLATION_DIRECTORY> / plantillas. Es necesario el conocimiento de HTML para editar las plantillas.
4) Los programas CGI están en <VIEWVC_INSTALLATION_DIRECTORY> / bin / cgi /. Puedes
enlace simbólico a este directorio desde algún lugar de su servidor HTTP publicada ruta si su servidor web está configurado para seguir enlaces simbólicos. Puedes También copiar el instalado <VIEWVC_INSTALLATION_DIRECTORY> / bin / cgi / *. cgi secuencias de comandos después de la instalación (a diferencia de los otros archivos en ViewVC, los guiones bajo bin / se puede mover).
Si está usando Apache, a continuación, ver a continuación en la sección titulada APACHE CONFIGURACIÓN.
NOTA: por razones de seguridad, no es aconsejable instalar ViewVC directamente en su publicada árbol de directorios HTTP (debido a la MySQL contraseñas en viewvc.conf).
Eso es todo para la navegación repositorio. Instrucciones para obtener el SQL base de datos de registro de trabajo están por debajo.
APACHE CONFIGURACIÓN
1) Busque el archivo de configuración de Apache (s).
Las ubicaciones típicas son /etc/httpd/httpd.conf, /etc/httpd/conf/httpd.conf y /etc/apache/httpd.conf. Dependiente de cómo se haya instalado Apache, también puede buscar en / usr / local / etc o / etc / local. Utilice la documentación del proveedor o la utilidad de descubrimiento si en duda.
2) En función de cómo su configuración de Apache es la configuración por defecto,
puede ser que necesite para permitir explícitamente el acceso de alto nivel a la ViewVC ubicación de instalación.
<Directorio <VIEWVC_INSTALLATION_DIRECTORY >>
Solicitar permiten, negar
Dejar de todas
</ Directory>
Por ejemplo, si se instala en ViewVC en /usr/local/viewvc-1.0 su sistema:
</usr/local/viewvc-1.0 Directorio>
Solicitar permiten, negar
Dejar de todas
</ Directory>
3) Configurar Apache para exponer ViewVC a los usuarios en la URL de su elección.
ViewVC proporciona varias maneras diferentes de hacer esto. Elija uno de los siguientes métodos:
----------------------------------- MÉTODO A: modo CGI mediante ScriptAlias ----------------------------------- La directiva ScriptAlias es muy útil para señalar directamente a la secuencia de comandos viewvc.cgi. Basta con insertar una línea que contiene
ScriptAlias / viewvc <VIEWVC_INSTALLATION_DIRECTORY> /bin/cgi/viewvc.cgi
en su archivo httpd.conf. Elija la ubicación en httpd.conf, donde También las otras líneas ScriptAlias residen. Algunos ejemplos:
ScriptAlias / viewvc /usr/local/viewvc-1.0/bin/cgi/viewvc.cgi
ScriptAlias / /usr/local/viewvc-1.0/bin/cgi/query.cgi consulta
INFORMACION DE SEGURIDAD
ViewVC proporciona una característica que permite que la versión controlada contenido servir a los navegadores web al igual estática contenido del servidor web. Así que, si usted tiene un directorio lleno de archivos HTML interrelacionados que se encuentra en su repositorio de control de versiones, ViewVC puede servir esos archivos como HTML. Usted verá en su navegador web lo que verías si los archivos fueron parte de su sitio web, con referencias de trabajo para hojas de estilo e imágenes y enlaces a otras páginas.
Es importante darse cuenta, sin embargo, que tan útil como esa característica Es decir, hay una cierta seguridad en cuanto el riesgo en su uso. Esencialmente, cualquier persona con comprometer el acceso a los repositorios CVS o Subversion atendidas por ViewVC tiene la capacidad de afectar el contenido del sitio. Si una o descontentos usuario ignorante comete HTML malicioso en un archivo de versión controlada (tal vez sólo a modo de documentar ejemplos de tales), que malicioso HTML se publica de manera eficaz y viven en su instancia ViewVC. Los visitantes viendo esos documentos controlados versionados obtener la código malicioso, también, que podría no ser lo que el autor original destinado a.
Por esta razón, la vista "checkout" de ViewVC está desactivado por defecto. Si desea activarlo, basta con añadir "co" a la lista de puntos de vista habilitada en la opción de configuración allowed_views.
Pedido Subversion
El código fuente para ViewVC se mantiene en un repositorio Subversion en Tigris.org. Puedes retirar el tronco de nuestro árbol de desarrollo desde http://viewvc.tigris.org/svn/viewvc/trunk/. Tendrá que proporcionar su nombre de usuario y la contraseña cuando así se le solicite Tigris.org, o, si usted no tiene una cuenta Tigris.org, utilice "invitado" como el nombre de usuario (sin, o un vacío, contraseña).
Actualización
Hemos tratado de garantizar que las URL ViewVC son estables, y que incluso cuando nos despreciar una sintaxis URL en particular, seguimos apoyando el manejo de la misma (utilizando redirecciones HTTP señalar navegadores a la nueva forma de la URL). Sabemos que las URL ViewVC consiguen favoritos, ya nadie le gusta cuando sus URLs marcadas dejan de funcionar repentinamente.
Al otro lado de parche libera de ViewVC (cuando sólo el componente Z de la versión XYZ cambia), hacemos todo lo posible para mantener el diccionario de sintaxis del archivo de configuración y los datos de plantilla sin cambios, también. Esto hace que sea mucho más fácil para las personas que necesitan actualizar rápidamente para obtener parches de seguridad o de otro tipo de errores. Pero a través de comunicados de mayor y menor, todas las apuestas están apagadas, y es muy probable que lo que hemos hecho algunas tuberías principales. Al actualizar la instancia ViewVC través de mayores o menores números de versión, es casi seguro que desea consultar nuestra HOWTO actualización para obtener consejos sobre cómo migrar los archivos de configuración y todas las personalizaciones plantilla que ha realizado en sus nuevos formatos.
Licencia
ViewVC emplea una licencia de "dos cláusula de estilo Berkeley". Es bastante liberal como licencias van. Copyright © 1999-2011 El Grupo ViewCVS. Todos los derechos reservados. Mediante el uso de ViewVC, usted acepta los términos y condiciones que se establecen a continuación: La redistribución y el uso en formas fuente y binario, con o sin modificaciones, están permitidos siempre que se cumplan las siguientes condiciones: 1. Las redistribuciones del código fuente deben conservar la nota de copyright anterior, esta lista de condiciones y el siguiente descargo de responsabilidad. 2. Las redistribuciones en formato binario deben reproducir el aviso de copyright anterior, esta lista de condiciones y el siguiente descargo de responsabilidad en la documentación y / u otros materiales proporcionados con la distribución.
Imágenes
¿Quién necesita las capturas cuando se puede visitar e interactuar con el funcionamiento de las instancias ViewVC? Los siguientes sitios están ejecutando varias versiones de ViewVC: • tigris.org (a través de la integración con CollabNet Enterprise Edition) • ctf.open.collab.net (a través de la integración con CollabNet TeamForge) • sourceforge.net (a través de la integración con SourceForge) • svn.apache.org (una implementación estándar)
