|
1 | 1 | # HackTheBox Writeups Template |
2 | 2 |
|
3 | | -This is a template repository for creating a personal site using GitHub Pages, designed for sharing HackTheBox writeups or similar technical content. It provides a clean, minimal design with Tailwind CSS for easy styling. |
| 3 | +Welcome to the **HackTheBox Writeups Template**! This repository is a customizable template designed for cybersecurity professionals and aspiring penetration testers to document and share their HackTheBox challenge writeups using GitHub Pages. |
| 4 | + |
| 5 | +Check out the example site: [HackTheBox Writeups Example](https://adamazl.github.io/hackthebox-writeups/) |
4 | 6 |
|
5 | 7 | ## Features |
6 | 8 |
|
7 | | -- **Tailwind CSS** for responsive and modern design |
8 | | -- Pre-built pages for **Home**, **About**, and **Contact** |
9 | | -- Simple structure for adding writeups in HTML format |
10 | | -- Easy to customize and extend |
| 9 | +- **Tailwind CSS** for a modern and responsive design. |
| 10 | +- Pre-built **Home**, **About**, and **Contact** pages. |
| 11 | +- Ready-to-use writeup template for adding HackTheBox challenges writeups. |
| 12 | +- Easy deployment via GitHub Pages. |
11 | 13 |
|
12 | 14 | ## Installation |
13 | 15 |
|
14 | | -### 1. Use as a Template |
15 | | - |
16 | | -To use this repository as a template, follow these steps: |
17 | | - |
18 | | -1. Click the **"Use this template"** button at the top of the repository page. |
19 | | -2. Name your new repository and set it to public or private. |
20 | | -3. Clone the new repository to your local machine: |
21 | | - ```bash |
22 | | - git clone https://github.com/your-username/your-repo-name.git |
23 | | - cd your-repo-name |
24 | | - ``` |
25 | | - |
26 | | -### 2. Git Clone |
27 | | - |
28 | | -Alternatively, you can clone this repository directly: |
29 | | - |
30 | | -1. Clone the repository: |
31 | | - ```bash |
32 | | - git clone https://github.com/adamazl/hackthebox-writeups-template.git |
33 | | - cd hackthebox-writeups-template |
34 | | - ``` |
35 | | - |
36 | | -2. Modify the template files as needed (e.g., update content, links, and add your writeups). |
37 | | - |
38 | | -## Adding Writeups |
39 | | - |
40 | | -To add your HackTheBox or other CTF writeups: |
41 | | - |
42 | | -1. Create a new HTML file in the root directory (e.g., `writeup1.html`). |
43 | | -2. Use the existing `writeup1.html` file as a reference to structure your writeups. |
44 | | -3. Update the `index.html` file with links to your new writeups. |
| 16 | +You can start using this template in two ways: |
45 | 17 |
|
46 | | -## Deployment |
| 18 | +1. **Copy GitHub Template:** |
| 19 | + - Click the "Use this template" button on the repository page. |
| 20 | + - Name your repository and clone it to your local machine. |
47 | 21 |
|
48 | | -You can easily deploy your site using GitHub Pages: |
| 22 | +2. **Git Clone:** |
| 23 | + - Run the following command to clone the repository: |
| 24 | + ```bash |
| 25 | + git clone https://github.com/your-username/hackthebox-writeups-template.git |
| 26 | + cd hackthebox-writeups-template |
| 27 | + ``` |
49 | 28 |
|
50 | | -1. Make sure your repository is public. |
51 | | -2. Go to the **Settings** tab of your repository. |
52 | | -3. Scroll down to the **Pages** section under **Code and automation**. |
53 | | -4. Under **Source**, select the branch you want to use (e.g., `main` or `master`). |
54 | | -5. Select the folder as `/ (root)` and click **Save**. |
55 | | -6. After a few minutes, your site will be live at `https://your-username.github.io/your-repo-name/`. |
| 29 | +## Deployment on GitHub Pages |
56 | 30 |
|
57 | | -## Customization |
| 31 | +To deploy your writeups on GitHub Pages: |
58 | 32 |
|
59 | | -- Modify the **meta tags** in `index.html` to change the site title and description. |
60 | | -- Add your personal information to the **About** and **Contact** pages. |
61 | | -- Tailwind CSS can be further customized by adding styles or modifying the layout. |
| 33 | +1. **Ensure the repository is public**: GitHub Pages only works with public repositories. |
| 34 | +2. **Enable GitHub Pages**: |
| 35 | + - Go to your repository’s settings. |
| 36 | + - Scroll down to the "GitHub Pages" section. |
| 37 | + - In the "Source" dropdown, select `main` or `master` branch. |
| 38 | + - Your site will be live at `https://<your-username>.github.io/<repository-name>/`. |
62 | 39 |
|
63 | | -## License |
| 40 | +## Future Updates |
64 | 41 |
|
65 | | -This repository is open source and available under the [MIT License](LICENSE). |
| 42 | +- **User comments** on each writeup page for community discussions and feedback. |
| 43 | + |
| 44 | +Stay tuned for more features! |
0 commit comments