|
1 |
| -# Welcome to your Lovable project |
| 1 | +# security-commits.org |
2 | 2 |
|
3 |
| -## Project info |
| 3 | +[](https://security-commits.org) |
4 | 4 |
|
5 |
| -**URL**: https://lovable.dev/projects/6afe7763-2aeb-46a8-9748-35b98b5fb3e3 |
| 5 | +This repo is the home of the [SECOM specification](https://security-commits.org). |
6 | 6 |
|
7 |
| -## How can I edit this code? |
| 7 | +## Repo Layout |
8 | 8 |
|
9 |
| -There are several ways of editing your application. |
| 9 | +We use [HUGO](https://gohugo.io/) as static site generator, so we use the [directory structure](https://gohugo.io/getting-started/directory-structure/) HUGO proposes. |
10 | 10 |
|
11 |
| -**Use Lovable** |
| 11 | +#### Our implementation |
12 | 12 |
|
13 |
| -Simply visit the [Lovable Project](https://lovable.dev/projects/6afe7763-2aeb-46a8-9748-35b98b5fb3e3) and start prompting. |
| 13 | +* `./content`: contains all the versions of the specification. |
| 14 | +* `./content/next/`: contains the version of the specification (where all the changes SHOULD be made). |
| 15 | +* `./content/**/index.[lang].md`: contains the content of the specification, if a language is specified it's a translation. |
14 | 16 |
|
15 |
| -Changes made via Lovable will be committed automatically to this repo. |
| 17 | +## Contributing |
16 | 18 |
|
17 |
| -**Use your preferred IDE** |
| 19 | +We'd love your help refining the language of this specification, |
| 20 | +fixing typos, or adding more translations. Please don't hesitate |
| 21 | +to send a pull request. |
18 | 22 |
|
19 |
| -If you want to work locally using your own IDE, you can clone this repo and push changes. Pushed changes will also be reflected in Lovable. |
| 23 | +### Adding a translation |
20 | 24 |
|
21 |
| -The only requirement is having Node.js & npm installed - [install with nvm](https://github.com/nvm-sh/nvm#installing-and-updating) |
| 25 | +1. Create a new file in `./content/version/index.[lang].md` using the hugo command `hugo new [version]/index.[lang].md`. |
| 26 | +1. Ensure all files have the appropriate fields required (see others as an example).. |
| 27 | +1. Add the language to the `config.yaml` file (see others as an example). |
22 | 28 |
|
23 |
| -Follow these steps: |
| 29 | +### Running project locally |
24 | 30 |
|
25 |
| -```sh |
26 |
| -# Step 1: Clone the repository using the project's Git URL. |
27 |
| -git clone <YOUR_GIT_URL> |
| 31 | +There's a docker-compose.yml file ready that will help you to check if the website looks good! |
| 32 | +To run it make sure you have [docker-compose installed](https://docs.docker.com/compose/install/#install-compose) on your machine and just use the command `docker-compose up` to make it run locally. |
28 | 33 |
|
29 |
| -# Step 2: Navigate to the project directory. |
30 |
| -cd <YOUR_PROJECT_NAME> |
| 34 | +Once the website will be compiled, you can see the website visiting `http://localhost:1313` |
31 | 35 |
|
32 |
| -# Step 3: Install the necessary dependencies. |
33 |
| -npm i |
| 36 | +## Badges! |
34 | 37 |
|
35 |
| -# Step 4: Start the development server with auto-reloading and an instant preview. |
36 |
| -npm run dev |
37 |
| -``` |
38 |
| - |
39 |
| -**Edit a file directly in GitHub** |
40 |
| - |
41 |
| -- Navigate to the desired file(s). |
42 |
| -- Click the "Edit" button (pencil icon) at the top right of the file view. |
43 |
| -- Make your changes and commit the changes. |
44 |
| - |
45 |
| -**Use GitHub Codespaces** |
46 |
| - |
47 |
| -- Navigate to the main page of your repository. |
48 |
| -- Click on the "Code" button (green button) near the top right. |
49 |
| -- Select the "Codespaces" tab. |
50 |
| -- Click on "New codespace" to launch a new Codespace environment. |
51 |
| -- Edit files directly within the Codespace and commit and push your changes once you're done. |
| 38 | +Tell your users that you use the Conventional Commits specification: |
52 | 39 |
|
53 |
| -## What technologies are used for this project? |
54 |
| - |
55 |
| -This project is built with: |
56 |
| - |
57 |
| -- Vite |
58 |
| -- TypeScript |
59 |
| -- React |
60 |
| -- shadcn-ui |
61 |
| -- Tailwind CSS |
62 |
| - |
63 |
| -## How can I deploy this project? |
64 |
| - |
65 |
| -Simply open [Lovable](https://lovable.dev/projects/6afe7763-2aeb-46a8-9748-35b98b5fb3e3) and click on Share -> Publish. |
| 40 | +```markdown |
| 41 | +[](https://conventionalcommits.org) |
| 42 | +``` |
66 | 43 |
|
67 |
| -## Can I connect a custom domain to my Lovable project? |
| 44 | +## Thank you |
68 | 45 |
|
69 |
| -Yes, you can! |
| 46 | +To **[Lorenzo D'Ianni](https://github.com/lorenzodianni)** for the great effort creating the CSS and the HTML for the new UI. |
70 | 47 |
|
71 |
| -To connect a domain, navigate to Project > Settings > Domains and click Connect Domain. |
| 48 | +To **[Netlify](https://www.netlify.com/)** to host our project, giving us a lot of [amazing built in functionality](https://www.netlify.com/features/) for free. |
72 | 49 |
|
73 |
| -Read more here: [Setting up a custom domain](https://docs.lovable.dev/tips-tricks/custom-domain#step-by-step-guide) |
| 50 | +To **[semver.org](https://github.com/mojombo/semver.org)**: we used [semver.org](https://github.com/mojombo/semver.org) as a blueprint for |
| 51 | +the structure of this specification and the first version of the website. |
0 commit comments