Skip to content

Commit e2bf73a

Browse files
authored
Update README.md
1 parent e668149 commit e2bf73a

File tree

1 file changed

+29
-50
lines changed

1 file changed

+29
-50
lines changed

README.md

Lines changed: 29 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -1,65 +1,44 @@
11
# HackTheBox Writeups Template
22

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/)
46

57
## Features
68

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.
1113

1214
## Installation
1315

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:
4517

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.
4721

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+
```
4928

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
5630

57-
## Customization
31+
To deploy your writeups on GitHub Pages:
5832

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>/`.
6239

63-
## License
40+
## Future Updates
6441

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

Comments
 (0)