app-template/README.md

257 lines
7.7 KiB
Markdown
Raw Normal View History

2022-02-27 16:45:06 +00:00
<h1 align="center">
<a href="https://gitdab.com/${REPO_OWNER}/${REPO_NAME}">
<img src="docs/images/logo.png" alt="Logo" width="100" height="100">
</a>
<br />
${REPO_NAME}
</h1>
2022-02-24 04:27:34 +00:00
2022-02-27 16:45:06 +00:00
> **[?]**
> Switch for your own logo
<div align="center">
<i>${REPO_DESCRIPTION}</i>
<br />
2022-02-27 16:45:06 +00:00
<a href="https://gitdab.com/${REPO_OWNER}/${REPO_NAME}/issues/new">
Report a Bug
</a>
·
2022-02-27 17:03:17 +00:00
<a href="https://gitdab.com/${REPO_OWNER}/${REPO_NAME}/issues/new?template=feature_request.md">
2022-02-27 16:45:06 +00:00
Request a Feature
</a>
·
2022-02-27 17:03:17 +00:00
<a href="https://gitdab.com/${REPO_OWNER}/${REPO_NAME}/issues/new?template=question.md">
2022-02-27 16:45:06 +00:00
Ask a Question
</a>
<br />
[![Project license](https://img.shields.io/badge/license-AGPL--3.0--only-green?style=flat-square)](LICENSE)
[![Pull Requests welcome](https://img.shields.io/badge/PRs-welcome-ff69b4.svg?style=flat-square)](https://gitdab.com/${REPO_OWNER}/${REPO_NAME}/compare)
[![code with love by](https://img.shields.io/badge/%3C%2F%3E%20with%20%E2%99%A5%20by-${REPO_OWNER}-ff1414.svg?style=flat-square)](https://gitdab.com/${REPO_NAME})
2022-02-28 17:55:59 +00:00
Donations accepted:
<br />
[![Liberapay receiving](https://img.shields.io/liberapay/receives/${REPO_OWNER}.svg?style=flat-square)](https://liberapay.com/${REPO_OWNER})
[![buymeacoffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/${REPO_OWNER})
[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/${REPO_OWNER})
2022-02-27 16:45:06 +00:00
</div>
## Table of Contents
- [About](#about)
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Usage](#usage)
- [Support](#support)
- [Roadmap](#roadmap)
- [Project Help](#project-help)
- [Contributing](#contributing)
- [Acknowledgements](#acknowledgements)
- [Funding Organizations](#funding-organizations)
- [Patrons](#patrons)
- [Software Used](#software-used)
- [Inspirations](#inspirations)
- [Authors and Contributors](#authors-and-contributors)
- [Security](#security)
- [License](#license)
## About
> **[?]**
> Provide general information about your project here.
> What problem does it (intend to) solve?
> What is the purpose of your project?
> Why did you undertake it?
**[Back to top](#table-of-contents)**
## Getting Started
### Prerequisites
Required dependencies:
- .
2022-02-27 16:45:06 +00:00
> **[?]**
> List project requirements or dependencies.
> List build tools.
**[Back to top](#table-of-contents)**
### Installation
Run the following to install:
```sh
```
2022-02-27 16:45:06 +00:00
> **[?]**
> Describe how to install and get started with the project.
> List build instructions.
**[Back to top](#table-of-contents)**
## Usage
> **[?]**
> How does one go about using it?
> Provide various use cases and code examples here.
**[Back to top](#table-of-contents)**
## Support
> **[?]**
> Provide additional ways to contact the project maintainer/maintainers.
> Website?
> Email?
**[Back to top](#table-of-contents)**
## Roadmap
See the [open issues](https://gitdab.com/${REPO_OWNER}/${REPO_NAME}/issues)
for a list of proposed features (and known issues).
For some quick links:
- [Top Feature Requests](https://gitdab.com/${REPO_OWNER}/${REPO_NAME}/issues?state=open&sort=mostcomment&labels=)
- [Newest Feature Requests](https://gitdab.com/${REPO_OWNER}/${REPO_NAME}/issues?state=open&sort=latest&labels=)
- [Hottest Feature Requests](https://gitdab.com/${REPO_OWNER}/${REPO_NAME}/issues?state=open&sort=mostcomment&labels=)
- [Top Bugs](https://gitdab.com/${REPO_OWNER}/${REPO_NAME}/issues?state=open&sort=mostcommented&labels=)
- [Newest Bugs](https://gitdab.com/${REPO_OWNER}/${REPO_NAME}/issues?state=open&sort=latest&labels=)
- [Hottest Bugs](https://gitdab.com/${REPO_OWNER}/${REPO_NAME}/issues?state=open&sort=mostcomment&labels=)
2022-02-27 16:45:06 +00:00
> **[?]**
> Add number to `labels=` in link.
> Add Kanban board or other project management software.
2022-02-27 16:45:06 +00:00
**[Back to top](#table-of-contents)**
## Project Help
If you want to say "thank you" and/or support active development of
2022-02-27 16:45:06 +00:00
**${REPO_NAME}**:
- Add a [GitHub Star](https://github.com/${REPO_OWNER}/${REPO_NAME}) to the
project's GitHub awareness page. (*our project is not mirrored to prevent
GitHub Copilot*)
2022-02-27 16:45:06 +00:00
- Tweet about ${REPO_NAME} or spread the word on other social media.
- Write interesting articles about the project on [Dev.to](https://dev.to/),
[Medium](https://medium.com/), or your personal blog.
- Help fund our contributors on:
- [Liberapay](https://liberapay.com/${REPO_OWNER})
- [Buy me a coffee](https://www.buymeacoffee.com/${REPO_OWNER})
- [Ko-Fi](https://ko-fi.com/${REPO_OWNER})
2022-02-27 16:45:06 +00:00
- [Patreon](https://www.patreon.com)
- [Kickstarter](https://www.kickstarter.com/)
- [Indiegogo](https://www.indiegogo.com/)
> **[?]**
> Replace the above links with links to the project's own funding pages.
2022-02-27 16:45:06 +00:00
Together, we can make ${REPO_NAME} **better**!
**[Back to top](#table-of-contents)**
## Contributing
Firstly, thanks for considering to contribute!
2022-02-27 16:45:06 +00:00
Contributions are what make the open-source community such an amazing place to
learn, inspire, and create.
Any contributions you make will benefit everybody else and are **greatly
appreciated**.
2022-02-27 16:45:06 +00:00
Please read [our contribution guidelines](docs/CONTRIBUTING.md), and thank you
for being involved!
**[Back to top](#table-of-contents)**
## Acknowledgements
### Funding Organizations
> **[?]**
> Include any organizations or companies that are funding the project.
**[Back to top](#table-of-contents)**
### Patrons
All patrons can be found at:
- [Liberapay](https://liberapay.com/${REPO_OWNER})
- [Buy me a coffee](https://www.buymeacoffee.com/${REPO_OWNER})
- [Ko-Fi](https://ko-fi.com/${REPO_OWNER})
2022-02-27 16:45:06 +00:00
- [Patreon](https://www.patreon.com)
- [Kickstarter](https://www.kickstarter.com/)
- [Indiegogo](https://www.indiegogo.com/)
> **[?]**
> Replace the above links with links to the project's own funding pages w/
> patrons listed.
2022-02-27 16:45:06 +00:00
**[Back to top](#table-of-contents)**
### Software Used
- The
[Amazing Github Template](https://github.com/dec0dOS/amazing-github-template)
for the README.md and some other documents.
- The [cvoges12 app-template](https://gitdab.com/cvoges12/app-template) for this template repository.
2022-02-27 16:45:06 +00:00
> **[?]**
> Include libraries and applications used in the project.
**[Back to top](#table-of-contents)**
### Inspirations
> **[?]**
> Include any projects or people that have inspired this project.
**[Back to top](#table-of-contents)**
### Authors and contributors
The original setup of this repository is by ${REPO_OWNER}.
For a full list of all authors and contributors, see
[the contributors page](https://gitdab.com/${REPO_OWNER}/${REPO_NAME}/activity).
> **[?]**
> Replace with contributors graph once
2022-02-27 16:45:06 +00:00
> https://github.com/go-gitea/gitea/issues/847
> is implemented.
**[Back to top](#table-of-contents)**
## Security
**${REPO_NAME}** follows good practices of security, but 100% security cannot
be assured.
**${REPO_NAME}** is provided **"as is"** without any **warranty**. Use at your
own risk.
_For more information and to report security issues, please refer to our
[security documentation](docs/SECURITY.md)._
2022-02-27 16:45:06 +00:00
**[Back to top](#table-of-contents)**
## License
Copyright (C) 2022 Clayton Voges
This program is free software: you can redistribute it and/or modify it under
the terms of the GNU Affero General Public License as published by the Free
Software Foundation, version 3.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
details.
You should have received a copy of the GNU Affero General Public License along
with this program. If not, see <https://www.gnu.org/licenses/>
**[Back to top](#table-of-contents)**