blackarch-wiki

KO | EN

gitlite — search

#javascript #python #golang #machine-learning #rust #deep-learning #macos #nodejs #cli #kubernetes #awesome-list #pytorch #security #ios

(★ 18)

BlackArch Linux Wiki

blackarch-wiki Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Netlify Status](https://api.netlify.com/api/v1/badges/ebf79c32-17b8-42a8-9d8e-ccceeb40ed95/deploy-status)](https://app.netlify.com/sites/blackarch-wiki/deploys)

# Contributing to this Wiki
This is a wiki for [BlackArch](https://blackarch.org), a complete Linux distribution for penetration testers and security researchers. These docs are rendered and deployed to:

[https://blackarch.wiki](https://blackarch.wiki)

Join the [BlackArch Matrix](https://matrix.to/#/%23BlackArch:matrix.org) to find other people interested in or using BlackArch Linux. If you want to support the project, consider [donating](https://blackarch.org/donate.html).

## Who can Contribute
This wiki belongs to BlackArch Linux, and contributions are welcome from anyone. Any member of the BlackArch organization can merge pull requests. BlackArch members can push directly to the `main` branch, which is the deployed branch.

## How to Contribute
Content is formatted using [markdown syntax](https://www.markdownguide.org/basic-syntax/). There are multiple ways to contribute content:

### Using Prose.io, a GitHub content editor
Links to edit content using `Prose.io` are embedded into the site in the top right corner:

![screenshot of prose links](https://raw.githubusercontent.com/anunna/blackarch-wiki/main/media/prose_links.png)

Clicking these links should drop you into a content editor in your browser:

![screenshot prose editor](https://raw.githubusercontent.com/anunna/blackarch-wiki/main/media/prose_editor.png)

There's a preview button to see your changes rendered in markdown:

![screenshot prose preview](https://raw.githubusercontent.com/anunna/blackarch-wiki/main/media/prose_preview.png)

#### Images
Images can be uploaded either by dragging and dropping the image into the prose editor or by clicking the image button in the markdown editor bar. These photos will be uploaded to the `media` directory and you should see some markdown generated for you:

![prose_image_upload.png](https://raw.githubusercontent.com/anunna/blackarch-wiki/main/media/prose_image_upload.png)

#### New Pages
Prose by default suggests a filename with a date, and there isn't a way currently to turn of this behavior. Please remove the date from the suggested filename, for example don't use `2023-04-20-your-filename.md` and instead name it without a date like `your-filename.md`. Remember to use the `.md` file extension. Files without the extension will not be rendered by jekyll.

#### Saving Changes
Click the save button, which will commit your changes. If you are a member of the BlackArch github organization, your changes will be committed directly to the deploy branch `main` and will show up https://blackarch.wiki once the site is rebuilt. If you are not a member of BlackArch Linux, saving your changes will create a Pull Request on Github. Any member of BlackArch can merge the changes after review.

### Using GitHub UI
There are links in the top right corner of the site to edit the content in GitHub. Clicking `Add new`, for example, will drop you into a GiHub UI for adding a new file:

![screenshot github editor](https://raw.githubusercontent.com/anunna/blackarch-wiki/main/media/github_editor.png)

The GitHub UI provides an option to either commit directly to `main` branch (if you are a member of BlackArch Linux) or submit a pull request, which can be merged by a member of BlackArch Linux.

### Using git

#### New Pages
New pages can be added to the root directory - no need to add to any subfolder. Pages should include the `.md` file extension or they will not be rendered.

#### Images
Add images to the `media` directory and include in markdown using the syntax:

```
![github_image_upload.png](https://raw.githubusercontent.com/anunna/blackarch-wiki/main/media/github_image_upload.png)
```

## Deploying Changes
All changes merged to `main` branch will be automatically deployed using Netlify to the domain `https://blackarch.wiki`. There is some delay between merge and when site is refreshed with the new content, so expect changes to take a moment. If you are a member of BlackArch, you have write access and can merge your own changes.

## Advanced
**If you are only looking to add content to the wiki, you should not need to do any of the following setup. This is only relevant if you want to make changes to the wiki site itself or you want to preview locally instead of using prose or GitHub UI.**

### How this Wiki is Built

This wiki is built using:
- [jekyll](https://jekyllrb.com/docs/), a static site generator
- [Netlify](https://www.netlify.com), to host the site
- [git-wiki-theme](https://github.com/Drassil/git-wiki-theme), a wiki theme for jekyll
- [prose.io](https://github.com/prose/prose), a content editor for GitHub

The theme is built directly into the repository so we could patch any changes as needed.

### Making Custom Style Changes
This wiki is built using a custom theme, but it is possible to override any of the style in `overrides/css/custom.css`.

### Previewing Changes Locally
Follow the instructions in the [Quickstart jekyll docs](https://jekyllrb.com/docs/) to setup a Ruby environment and install bundler.  To build the site and make it available to a local server, run:

```
bundle exec jekyll serve
```

and open `http://localhost:4000` in a browser.

Some functionality, such as the editing with prose, cannot be easily tested locally.

blackarch-wiki

blackarch-wiki Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

blackarch-wiki

blackarch-wiki Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README