|
| 1 | +# Microformats JavaScript/Node Parser Website |
| 2 | + |
| 3 | +Website for Microformats JavaScript parser (based on pin13.net by [@aaronpk](https://github.com/aaronpk)). |
| 4 | + |
| 5 | +https://node.microformats.io |
| 6 | + |
| 7 | +## Deployment |
| 8 | + |
| 9 | +All commits to the `main` branch get auto-deployed to the live website [running on Heroku](https://node.microformats.io). |
| 10 | + |
| 11 | +### Git workflow |
| 12 | + |
| 13 | +The base branch is `next`. All PRs should target this branch. |
| 14 | + |
| 15 | +To initiate a release: |
| 16 | +* Create a new branch, from `next` named `release/x.y.z` |
| 17 | +* Bump the version in `package.json` to `x.y.z` |
| 18 | +* Merge `release/x.y.z` to `main`. This will trigger the [deployment](#deployment). |
| 19 | +* Merge `main` into `next` |
| 20 | + |
| 21 | +## Getting Started |
| 22 | + |
| 23 | +This website is built using [Yarn](https://yarnpkg.com/). |
| 24 | + |
| 25 | +To start working with this project, first clone the repository for this project: |
| 26 | + |
| 27 | +``` |
| 28 | +git clone https://github.com/microformats/microformats-parser-website-node.git |
| 29 | +cd microformats-parser-website-node |
| 30 | +``` |
| 31 | + |
| 32 | +Next, install the required dependencies and start the server: |
| 33 | + |
| 34 | +``` |
| 35 | +yarn install |
| 36 | +yarn start |
| 37 | +# Or, if you'd like a different port: |
| 38 | +# PORT=5000 yarn start |
| 39 | +``` |
| 40 | + |
| 41 | +You can view your running local application at this URL: |
| 42 | + |
| 43 | +``` |
| 44 | +http://localhost:9000 |
| 45 | +``` |
| 46 | + |
| 47 | +## Requirements |
| 48 | + |
| 49 | +- [Node 17](https://nodejs.org/en/blog/release/v17.0.0/) |
| 50 | +- [Yarn](https://yarnpkg.com/cli/install) |
| 51 | + |
| 52 | +## Contributions |
| 53 | + |
| 54 | +1. Fork it |
| 55 | +2. Get it running (see Installation above) |
| 56 | +3. Create your feature branch (`git checkout -b my-new-feature`) |
| 57 | +4. Commit your changes (`git commit -am 'Add some feature'`) |
| 58 | +5. Push to the branch (`git push origin my-new-feature`) |
| 59 | +6. Create new Pull Request |
| 60 | + |
| 61 | +If you find bugs, have feature requests or questions, please |
| 62 | +[file an issue](https://github.com/microformats/microformats-parser-website-node/issues). |
| 63 | + |
| 64 | +## License |
| 65 | + |
| 66 | +Microformats Parser Website Node is dedicated to the public domain using Creative Commons -- CC0 1.0 Universal. |
| 67 | + |
| 68 | +http://creativecommons.org/publicdomain/zero/1.0 |
0 commit comments