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.
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í algunos detalles a tener en cuenta a la hora de la instalación.
Herramientas de software y la configuración necesaria para ejecutar ViewVC y sus URL de descarga:
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 - (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
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 de ViewVC
Descarga de ViewVC.
Puede efectuar la descarga en la URL http://descargar.cnet.com/linux/viewvc/3260-20_4-10230707-1.html.
Instalación.
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).
Se debe tener 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.
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).
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.
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. 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.
Actualización
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). Se conoce que las URL ViewVC consiguen favoritos, y a nadie le gusta cuando sus URL marcadas dejan de funcionar repentinamente.
