Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 44 additions & 0 deletions .github/workflows/build-website.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
name: Deploy to GitHub Pages

on:
push:
branches:
- master
jobs:
build:
name: Build Docusaurus
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- uses: actions/setup-node@v4
with:
node-version: 22
cache: npm

- name: Install dependencies
run: npm ci
- name: Build website
run: |
npm run build
ls website/build

- name: Upload Build Artifact
uses: actions/upload-pages-artifact@v3
with:
path: website/build/all-contributors
deploy:
name: Deploy to GitHub Pages
needs: build
permissions:
pages: write
id-token: write
environment:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
runs-on: ubuntu-latest
steps:
- name: Deploy to GitHub Pages
id: deployment
uses: actions/deploy-pages@v4
5 changes: 3 additions & 2 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,9 @@ desktop.ini
# Optional eslint cache
.eslintcache

# npm
package-lock.json
# yarn
#package-lock.json

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would remove this line.

Copy link
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok!!

yarn.lock

# Optional npm cache directory
.npm
Expand Down
11 changes: 11 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,14 @@
# Contribute to the All Contributors bot

We welcome contributions of all kinds to AllContributors.

## 13 August 2025 Update:

Currently, we are doing some work to revive the project. The documentation
website is not online but we are working to get it online soon.

************* THE LINKS BELOW DON'T CURRENTLY WORK ******

Read the contributing docs in:

- <a href="https://allcontributors.org/docs/en/project/contribute">English</a>
Expand Down
16 changes: 10 additions & 6 deletions docs/project/contribute.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,13 +62,17 @@ After you translate strings in any given language, you won't see those changes a

Search is by algolia, the configuration is at <https://github.com/algolia/docsearch-configs/blob/master/configs/all-contributors.json>

## Running the site locally:
## Run the website locally:

All Contributors currently uses [Docusaurus 1.x](https://docusaurus.io) for our documentation website.

To build the docs locally:

Make sure `npm` is installed on your machine. Use the [nodejs documentation](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) if you aren't sure how to install `npm`.

* https://tutorial.docusaurus.io/docs/intro

1. Make sure `npm` is installed on your machine. Use the [nodejs documentation](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) if you aren't sure how to install `npm`.

To check that npm is installed run the following in your favorite shell:

`npm -v`
Expand All @@ -78,11 +82,11 @@ use:

`node -v`

If you don't have at least version `0.22` or higher, please install Node or upgrade your current version.

If you don't have atleast version `.22` or higher, please install node or upgrade your current version.
Install docusaurus v1 (1.14.7) and all of the project dependencies using `npm install`. *Note: This project does not yet support docusaurus v2 or v3; though, we hope to do so in the future.*
**`npm i` is shorthand for `npm install`)**:

`npm install`
`npm i`

Once you have completed the above, you can launch a server locally that will build and run the docs locally. In your favorite shell run:

Expand All @@ -98,7 +102,7 @@ check those changes. To run the linter yourself on a file locally:

First install markdownlint-cli:

`npm install -g markdownlint-cli`
`npm i -g markdownlint-cli`

Then run markdownlint on the file (or files) that you wish to check:

Expand Down
Loading