badges badges badges

- https://www.youtube.com/watch?v=pzagBTcYsYQ
This commit is contained in:
Leon Stafford 2021-01-31 08:42:08 +10:00
parent 89acba4ea0
commit b6be47b73b
2 changed files with 105 additions and 72 deletions

73
CONTRIBUTING.md Normal file
View file

@ -0,0 +1,73 @@
## Beginner-friendly contributing
Please don't be intimidated to contribute code to this project. I welcome code
in any way you're comfortable to contribute it (email, forum, diff). If you're
new to GitHub and this kind of thing, the below guide may help you.
1. Fork project with button in top of WP2static github [home page](https://github.com/leonstafford/wp2static)
1. Clone your project to your development computer (please, change <your-account> by your account name):
`git clone https://github.com/<your-account>/wp2static.git`
1. Fork your new branch from **develop** naming with:
1. If you want add new feature: `feature-<name of your feature>`
1. If you want to fix a bug: `bug-<name of bug>`
`git checkout -b feature-myfeature`
1. Do your commits
1. Push to your repository
`git push origin feature-myfeature`
1. Then go to your https://github.com/<your-account>/wp2static site and create a pull request:
In base repository choose _leonstafford/wp2static_ and choose _development_ branch.
1. After Pull Request is approved you need to sync repositories.
1. In your local development add **upstream** branch:
`git remote add upstream https://github.com/leonstafford/wp2static`
1. Fetch **upstream**
`git fetch upstream`
1. Checkout your local branch:
`git checkout develop`
1. Merge **upstream** with your local:
`git merge upstream/develop`
1. You can now make new branches.
### Working example
#### Preparing Repository
Fork project WP2static [home page](https://github.com/leonstafford/wp2static)
`git clone https://github.com/ebavs/wp2static.git # clone repository (please,change ebavs by yours, this is only an example)`
Then add WP2Static remote
`git remote add upstream https://github.com/leonstafford/wp2static # add remote`
#### Working and Commiting
`git checkout -b feature-newdocumentation # create new branch to do changes`
`git commit -am "my new commits" # send new changes`
`git push origin feature-myfeature # push to your repository`
Then **Pull Request** in WP2Static
#### Sync Repository
`git fetch upstream # download commits from wp2static repo`
`git checkout develop # change to local develop branch`
`git merge upstream/develop # merge with wpstatic develop branch`
### Publishing a new release
This is currently done by @leonstafford and involves these steps:
- test code in `develop` branch
- set a new dev version if needed, ie `7.1.1-dev`
- merge `develop` branch to `master`
- adjust `wp2static.php` version to non-dev, ie `7.1.1`
- update `CHANGELOG.md`
- create new git tag with matching version
- push `master` branch and tag to GitHub
- create new Release in GitHub with same notes as CHANGELOG
- build zip installer and publish to wp2static.com with MD5 hash

104
README.md
View file

@ -2,14 +2,42 @@
A WordPress plugin for static site generation and deployment.
[![Latest Stable Version](https://poser.pugx.org/leonstafford/wp2static/v)](//packagist.org/packages/leonstafford/wp2static)
![codequality](https://github.com/leonstafford/wp2static/workflows/codequality/badge.svg?branch=master)
[![Packagist](https://img.shields.io/packagist/v/leonstafford/wp2static.svg?color=239922&style=popout)](https://packagist.org/packages/leonstafford/wp2static)
[![PHPStan](https://img.shields.io/badge/PHPStan-enabled-239922)](https://github.com/phpstan/phpstan)
[![Packagist Downloads](https://poser.pugx.org/leonstafford/wp2static/downloads)](//packagist.org/packages/leonstafford/wp2static)
__Looking for the older style plugin? It's been renamed and improved as [Static HTML Output](https://github.com/WP2Static/static-html-output-plugin).__
[![License](https://poser.pugx.org/leonstafford/wp2static/license)](//packagist.org/packages/leonstafford/wp2static)
---
<div align="center">
### Support my continued work!
Please join my creative journey, crafting software to solve real problems and doing it in a way that I hope to inspire others to follow.
#### Donation options:
- [Patreon](https://www.patreon.com/leonstafford)
- [PayPal](https://paypal.me/ljsdotdev)
- [DonorBox](https://donorbox.org/leonstafford)
- [Ko-fi](https://ko-fi.com/leonstafford)
- [Credit card, ApplePay, GooglePay](https://ljs.dev)
- BTC: *3BVcAjb3bMddYNNaK2q2QZioAjJG2Pc6Gp*
- BCH: *qr0fzu0t6vt4cu49wmuanmd54dgnwutleq80jjqex0*
- ECH: *0x26FBc559f7897FFbe270348bE4213E150ba116B9*
I want you to be part of the journey with me, so please sponsor any amount you can and get updates via [my Patreon page](https://www.patreon.com/leonstafford)
</div>
---
## Open Source over profits
WP2Static is an open source project, maintained by many generous developers over the years, including, but not limited to these [contributors on GitHub](https://github.com/WP2Static/wp2static/graphs/contributors). Source code for this core repository and all addons shall always remain publicly available.
@ -28,76 +56,8 @@ Read about WP2Static's [developers, contributors, supporters](https://wp2static.
`master` branch should always reflect a stable release, such as `7.1.1`, which should have a matching tag.
## Beginner-friendly contributing
### Contributing
Please don't be intimidated to contribute code to this project. I welcome code
in any way you're comfortable to contribute it (email, forum, diff). If you're
new to GitHub and this kind of thing, the below guide may help you.
[See `CONTRIBUTING.md`](./contributing)
1. Fork project with button in top of WP2static github [home page](https://github.com/leonstafford/wp2static)
1. Clone your project to your development computer (please, change <your-account> by your account name):
`git clone https://github.com/<your-account>/wp2static.git`
1. Fork your new branch from **develop** naming with:
1. If you want add new feature: `feature-<name of your feature>`
1. If you want to fix a bug: `bug-<name of bug>`
`git checkout -b feature-myfeature`
1. Do your commits
1. Push to your repository
`git push origin feature-myfeature`
1. Then go to your https://github.com/<your-account>/wp2static site and create a pull request:
In base repository choose _leonstafford/wp2static_ and choose _development_ branch.
1. After Pull Request is approved you need to sync repositories.
1. In your local development add **upstream** branch:
`git remote add upstream https://github.com/leonstafford/wp2static`
1. Fetch **upstream**
`git fetch upstream`
1. Checkout your local branch:
`git checkout develop`
1. Merge **upstream** with your local:
`git merge upstream/develop`
1. You can now make new branches.
### Working example
#### Preparing Repository
Fork project WP2static [home page](https://github.com/leonstafford/wp2static)
`git clone https://github.com/ebavs/wp2static.git # clone repository (please,change ebavs by yours, this is only an example)`
Then add WP2Static remote
`git remote add upstream https://github.com/leonstafford/wp2static # add remote`
#### Working and Commiting
`git checkout -b feature-newdocumentation # create new branch to do changes`
`git commit -am "my new commits" # send new changes`
`git push origin feature-myfeature # push to your repository`
Then **Pull Request** in WP2Static
#### Sync Repository
`git fetch upstream # download commits from wp2static repo`
`git checkout develop # change to local develop branch`
`git merge upstream/develop # merge with wpstatic develop branch`
### Publishing a new release
This is currently done by @leonstafford and involves these steps:
- test code in `develop` branch
- set a new dev version if needed, ie `7.1.1-dev`
- merge `develop` branch to `master`
- adjust `wp2static.php` version to non-dev, ie `7.1.1`
- update `CHANGELOG.md`
- create new git tag with matching version
- push `master` branch and tag to GitHub
- create new Release in GitHub with same notes as CHANGELOG
- build zip installer and publish to wp2static.com with MD5 hash