![]() * Replace hardcoded en locale with current locale in lang attributes * Update README with current wiki link; add details to Docker Compose installation instructino. |
||
---|---|---|
.github | ||
api | ||
home | ||
installer | ||
paper | ||
selenium | ||
webapp | ||
.env | ||
.gitattributes | ||
.gitignore | ||
docker-compose.yml | ||
Dockerfile | ||
LICENSE | ||
pom.xml | ||
rc_script.sh | ||
README.md | ||
start.sh | ||
update-versions.sh |
VIVO: Connect, Share, Discover
VIVO is an open source semantic web tool for research discovery -- finding people and the research they do.
VIVO supports editing, searching, browsing and visualizing research activity in order to discover people, programs, facilities, funding, scholarly works and events. VIVO's search returns results faceted by type for rapid retrieval of desired information across disciplines.
Resources
VIVO Project web site
VIVO Project Wiki
https://wiki.duraspace.org/display/VIVO/
Installation Instructions
Installation instructions for the latest release can be found at this location on the wiki:
https://wiki.duraspace.org/display/VIVODOC112x/Installing+VIVO
Docker
VIVO docker container is available at vivoweb/vivo with accompanying vivoweb/vivo-solr. These can be used independently or with docker-compose.
Docker Compose
Docker Compose environment variables:
.env defaults
LOCAL_VIVO_HOME=./vivo-home
RESET_HOME=false
RESET_CORE=false
LOCAL_VIVO_HOME
: VIVO home directory on your host machine which will mount to volume in docker container. Set this environment variable to persist your VIVO data on your host machine.RESET_HOME
: Convenience to reset VIVO home when starting container. Caution, will delete local configuration, content, and configuration model.RESET_CORE
: Convenience to reset VIVO Solr core when starting container. Caution, will require complete reindex.
Before building VIVO, you will also need to clone (and switch to the same branch, if other than main) of Vitro. The Vitro project must be cloned to a sibling directory next to VIVO so that it can be found during the build. You will also need to clone (and switch to the appropriate branch) of Vitro-languages and VIVO-languages.
Build and start VIVO.
- In Vitro-languages, run:
mvn install
- In VIVO-languages, run:
mvn install
- In VIVO (with Vitro cloned alongside it), run:
mvn clean package -s installer/example-settings.xml
docker-compose up
Docker Image
To build and run local Docker image.
docker build -t vivoweb/vivo:development .
docker run -p 8080:8080 vivoweb/vivo:development
Contact us
There are several ways to contact the VIVO community. Whatever your interest, we would be pleased to hear from you.
Contact form
http://vivoweb.org/support/user-feedback
Mailing lists
vivo-all
This updates list provides news to the VIVO community of interest to all.
vivo-community
Join the VIVO community! Here you'll find non-technical discussion regarding participation, the VIVO conference, policy, project management, outreach, and engagement.
vivo-tech
The best place to get your hands dirty in the VIVO Project. Developers and implementers frequent this list to get the latest on feature design, development, implementation, and testing.
Contributing Code
If you would like to contribute code to the VIVO project, please open a ticket in our JIRA, and prepare a pull request that references your ticket. Contributors welcome!
Citing VIVO
If you are using VIVO in your publications or projects, please cite the software paper in the Journal of Open Source Software:
- Conlon et al., (2019). VIVO: a system for research discovery. Journal of Open Source Software, 4(39), 1182, https://doi.org/10.21105/joss.01182
BibTeX
@article{Conlon2019,
doi = {10.21105/joss.01182},
url = {https://doi.org/10.21105/joss.01182},
year = {2019},
publisher = {The Open Journal},
volume = {4},
number = {39},
pages = {1182},
author = {Michael Conlon and Andrew Woods and Graham Triggs and Ralph O'Flinn and Muhammad Javed and Jim Blake and Benjamin Gross and Qazi Asim Ijaz Ahmad and Sabih Ali and Martin Barber and Don Elsborg and Kitio Fofack and Christian Hauschke and Violeta Ilik and Huda Khan and Ted Lawless and Jacob Levernier and Brian Lowe and Jose Martin and Steve McKay and Simon Porter and Tatiana Walther and Marijane White and Stefan Wolff and Rebecca Younes},
title = {{VIVO}: a system for research discovery},
journal = {Journal of Open Source Software}
}