ℹ️ Note:
This README.md is a template.
All sections and texts written in square brackets (e.g.,[your text here]
) are placeholders.
Please replace them with your project-specific information before publishing or sharing this repository.
You can follow these steps for completing this setup:
- Replace the title (above this hint)
- replace all URLS and repo titles
- write an quicksetup.bat or quick_setup.py that execute your application for developers
- Add instructions how to use the application
- Add prerequisites and installation instructions
- Add instructions how to contribute to development AND never stop to continue your documentation in 2. About this Assistent Note: The table of contents will be generated automatically! Do not touch it!
- [Dev. to User: Write here some instructions, how bugs and advices can be communicated.]
- [Dev. to Dev.: Write here some details of your dev-process, or some hints for your coworkers.]
[This repository] is a component of the research data infrastructure "Historische Quellen" (abbreviated as 'HisQu'). It serves as a collaborative initiative aimed at fostering the systematic organization, analysis, and accessibility of historical sources. For more detailed information about the goals, scope, and participating institutions, please visit the official website at https://hisqu.de/.
[Write here your specific description.]
[include instructions how to use the repository, often it is as simple as running a quick_setup.bat
or downloading the releases from the release page]
- Python [z.B. 'ab 3.10.1' Versionsnummer der supporteten Python Versionen für dieses Repo], Details can be found in the Python version guide. [List here all other prerequisites that are not simple package dependencies, also note if they are automatically isntalled via submodules. These could be things like other Languages for the Programming stack or specific Tools like antlr]
- Clone this repository to your local device.
Alternatively: If you don't have Git installed, download the project as a .zip file and extract all data into a folder. - [Optional: If you have a quick_setup.py or quick_setup.bat file to do this for the user, list that here as an option]
- Create and activate a virtual environment in your project folder.
- Initialize your submodules
- Install all required python packages using
pip install -r requirements.txt
in your source path. - Set up your
.env
file with the necessary Environmental Variables. - [Add any other necessary steps for setup]
[include Instructions how to contribute to development, what are the near term goals]