Skip to content

An awesome repo template packed with tons of tools & more to kick-start your next project / repo!

License

Notifications You must be signed in to change notification settings

MarketingPipeline/Awesome-Repo-Template

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Awesome-Repo-Template Awesome

Repo Banner - Awesome Repo Template

A awesome repo template to kick-start your next project
Show your support!

Features:

Example and Usage


How to use this template:

To run any of these tasks you MUST be in the Actions section

How to find the Action

image



How to replace all links with your own:

Edit the repo_config.json file & set the value for "REPLACE_TEXT_WITH" - to your username & repo name like the following example

   MyUserName/My-Repo-Name

And run the Repo Generator in Actions - set "Update all links" to checked










How to replace e-mail in Code of Conduct with your own:

Edit the repo_config.json file & set the value for "EMAIL" - to your e-mail address like the following example.

   hello_world@github.com

And run the Repo Generator in Actions- set "Update Code Of Conduct Info" to checked










How to replace e-mail in Security Policy with your own:

Edit the repo_config.json file & set the value for "EMAIL" - to your e-mail address like the following example.

   hello_world@github.com

And run the Repo Generator in Actions- set "Update Security Info" to checked










How to download file(s) / folder(s) from another GitHub repo

WARNING

files downloaded from a repo containing the same name in your current repo will be OVER-WRITTEN.



In the Repo Generator Actions- set "Download a file or folder from a GitHub Repo" to a GitHub file path or folder.

Example(s)

To download a single file:

 https://github.com/Repo-Owner-UserName/Repo-Name/blob/master/README.md

To download a specific folder:

 https://github.com/Repo-Owner-UserName/Repo-Name/blob/master/Folder-Name

To download all files in a repo folder:

 https://github.com/Repo-Owner-UserName/Repo-Name/blob/master/

Note: File's will be placed into main repo path.












How to generate a index.html file

A index.html file will be produced from your README content.

SEO details such as Title, Description & OG images etc are auto-produced using your Repo details.

Note Your README content will be rendered in Github Flavored Markdown using our tool Markdown-Tag: Add Markdown to any HTML using a tag

Go to the Repo Generator in Actions- set "Generate Index File" to checked










How to compress / optimize images in repo

Note: All images in repo will be compressed / optimized (SVG's are NOT supported)

Go to the Repo Generator in Actions- set "Compress / Optimize Images" to checked











How to generate Table Of Contents:
To generate tables of contents automatically use anywhere in your README.md file a comment like so

<!-- toc -->

<!-- tocstop -->

And when running the Repo Generator in Actions - set "Generate Table Of Contents" to checked

WARNING: Only 1 table of contents can be generated in a README - if you use more than one you WILL face problems.











How to Generate a Metrics Image:

Create a Personal Access Token & create a repo secret called "METRICS_TOKEN" & when running the Repo Generator - set "Generate Metrics Image File" to checked

You will have an image generated that looks like this!

It will be placed in the main repo under the filename stargazers-metrics.svg

Note: if someone knows how to change this please make a pull request with the image placed to .github folder!




















Shield.io Buttons:

Repo metadata

Github license Open issues Closed issues Open Pull Requests Closed Pull Requests Commit activity GitHub contributors Last commit GitHub tag

Social buttons

MarketingPipeline - Awesome-Repo-Template stars - Awesome-Repo-Template forks - Awesome-Repo-Template

Call-to-Action buttons

Use this template

View site - GH Pages

Documentation button

view - Documentation

Custom button

Custom Shield.io Button











Auto Generated Table Of Contents Demo:

How to setup GitHub bots
These are bots that are prepared and configured for this template. They need to be activated to properly work.

  1. The issue_label_bot.yaml file depends on the issue label bot Activate it or check its documentation(✓ highly recommended).
  2. The settings.yml file depends on the settings label bot Activate it or check its documentation (optional).
  3. The config.yml file depends on the bot welcome bot Activate it or check its documentation and to-do bot (optional).

Contributing GitHub

Want to improve this template? Create a pull request with detailed changes / improvements! If approved you will be added to the list of contributors of this awesome repo template!

See also the list of contributors who participate in this project.

License GitHub

This project is licensed under the MIT License - see the LICENSE.md file for details.