/drex

📖 Docusaurus template for my Open Source projects 📖

Primary LanguageJavaScriptMIT LicenseMIT

drex

Docusaurus template for my Open Source projects.

Step 1: Clone this project and switch to a source branch

(If you are not creating an organization page read the bottom note)

Step 2: Replace these template strings

Use your editor's find all in path tool to replace these template strings. All template strings to be replaced are in SCREAMING_SNAKE_CASE and start with YOUR.

Check that no template strings remain after completing this list by searching for YOUR with your IDE.

  • YOUR_SOLVED_PROBLEM: An uncapitalized phrase that describes what you project "makes it easy to" (no period)
    • Examples: clean your house, walk your dog, find your keys
  • YOUR_APP_TITLE: A title for your app (It will be displayed throughout the site.)
    • Examples: Tinder, Discord, Amazon Games
  • YOUR_APP_TAGLINE: A tagline for your app
    • Examples: Tinder for dogs, Clear your mind after a long day
  • YOUR_ORGANIZATION_NAME: Your Github organization name
    • Examples: facebook, google
  • YOUR_GITHUB_PROJECT: The Github project your documentation is for. (Not the repo the docs are hosted in)
    • Examples: react, create-react-app

Step 3: Replace images

Replace: website/static/img/favicon.ico & website/static/img/logo192.png

Step 4: Deploy to pages

Run the command: sudo GIT_USER=YOUR_GITHUB_USERNAME USE_SSH=false npm run publish-gh-pages

If you want to deploy this to a repo's Github page (instead of an organization's page)

  • Set baseUrl in config to /YOUR_GITHUB_PROJECT/
  • Instead of moving to a source branch, stay on master.