An open API service indexing awesome lists of open source software.

https://github.com/serverx-org/server-x-101

Unite developers, create impactful products together
https://github.com/serverx-org/server-x-101

developer-community server-x-101 serverx

Last synced: 4 months ago
JSON representation

Unite developers, create impactful products together

Awesome Lists containing this project

README

          

SERVER-X-101

SERVER X 101


## To work on this repository install Hugo

**In Windows:**

**Chocolatey**
[Chocolatey](https://chocolatey.org) is a free and open-source package manager for Windows. To install the extended edition of Hugo:

```bash
choco install hugo-extended
```

**Scoop**
[Scoop](https://scoop.sh) is a free and open-source package manager for Windows. To install the extended edition of Hugo:

```bash
scoop install hugo-extended
```

**Winget**
[Winget](https://learn.microsoft.com/en-us/windows/package-manager/) is Microsoft’s official free and open-source package manager for Windows. To install the extended edition of Hugo:

```bash
winget install Hugo.Hugo.Extended
```

**In Linux:**
To install the extended edition of Hugo:

```bash
sudo snap install hugo
```

To enable or revoke access to removable media:

```bash
sudo snap connect hugo:removable-media
sudo snap disconnect hugo:removable-media
```

To enable or revoke access to SSH keys:

```bash
sudo snap connect hugo:ssh-keys
sudo snap disconnect hugo:ssh-keys
```

**In macOS:**

**Homebrew**
[Homebrew](https://brew.sh) is a free and open-source package manager for macOS and Linux. To install the extended edition of Hugo:

```bash
brew install hugo
```

**MacPorts**
[MacPorts](https://www.macports.org) is a free and open-source package manager for macOS. To install the extended edition of Hugo:

```bash
sudo port install hugo
```

## Website Development Instructions

To contribute to the development of our website, follow these steps:

1. **Clone the Repository:**
```
git clone https://github.com/SERVER-X-101/SERVER-X-101.git
```

2. **Install Dependencies:**
```
npm i
```

3. **Start Localhost Server:**
```
npm start
```

4. **Make Changes:**
Once the server is running, make your desired changes to the codebase.

5. **Create a Pull Request:**
After making changes, create a pull request (PR) to merge your code into the main branch.

6. **Resolve Issues:**
Ensure that your PR addresses and resolves any related issues by mentioning them in the PR description.

Thank you for contributing to our project!

## Instructions for Content Contributors::

For Articles:

- Navigate to the `content` directory.
- Then to the `articles` directory.
- Create a folder using snake_case with your article title, e.g., `article_name`.
- Add an `img` folder for images related to your article inside the created directory.
- Add a `featured.png` file for the card image of your article.
- Create an `_index.md_` file and add your article in Markdown format.
- Inside `_index.md`, use the following template format:

Articles template:

```md
---
title: Article Title
description: Small Description for Your Article
author: Author Name
lastmod: 2024-03-18T00:00:00-00:00 (example)
github: link (if any GitHub link is available; otherwise, do not add)
tags:
- tag1
- tag2

---

From here, you can write your article...
```

For Contests:

- Navigate to the `content` directory.
- Then to the `contests` directory.
- Create a folder using snake_case with your contest title, e.g., `contest_name`.
- Add an `img` folder for images related to your contest inside the created directory.
- Add a `featured.png` file for the card image of your contest.
- Create an `_index.md_` file and add your contest in Markdown format.
- Add information about the contest, a small description, or any images if available.
- Create `problem_1.md` and add the first problem name of the contest inside the `contest_name` directory that you created.
- Similarly, create content for other problems.
- Inside each problem's Markdown file, use the following template format:

Contests template:

```md
---
title: Contest Title
description: Small Description for Your Contest
author: Author Name
lastmod: 2024-03-18T00:00:00-00:00 (example)
practice: true | false (for contests which come under practice)
vignan-challenges: true | false (for contests which come under vignan challenges)
tags:
- tag1
- tag2

---

From here, you can write your article...
```

If you want to contribute to the website layout:

- You can refer to the HUGO [documentation](https://gohugo.io/documentation/) for more information.
- You can use the `layout` directory for the layout of the website.

Thank you for your contribution!