Giter Club home page Giter Club logo

corndocs's Introduction

Getting Started

Adding docs to your project

Changing the environment variables

Go into the corndocs.config.js file and update the follow fields.

/** @type {import('./types/ConfigType').Config} */

module.exports = {
  darkMode: true,
  search: {
    algolia_admin_key: process.env.ALGOLIA_SEARCH_ADMIN_KEY,
    algolia_app_id: process.env.NEXT_PUBLIC_ALGOLIA_APP_ID,
    algolia_search_api_key: process.env.NEXT_PUBLIC_ALGOLIA_SEARCH_API_KEY,
    algolia_index: "dev_corndocs",
  },
  project: {
    name: "CornDocs",
    url: "https://www.corndocs.com",
    github: {
      repo: "https://github.com/dishwasher-detergent/CornDocs",
      usesMain: false,
    },
    logo: {
      src: "/static/logo.svg",
      alt: "CornDocs Logo",
      size: [80, 40],
    },
    mainScreen: {
      showSearch: true,
      showSelection: true,
      homePage: {
        custom: {
          path: "index",
        },
        title: "Build documentation that will impress your friends and family.",
        tagLine:
          "CornDocs lets you easily create documentation to show off your projects!",
      },
    },
  },
};

Setting sidebar order

For a file, you can set the sidebar order in the frontmattter. Use the key position.

//_posts/doc.mdx
---
...
position: 1
...
---

For a folder, you can set the sidebar order in the define.json file. Use the key position.

//_posts/Folder/define.json
{
  ...
  "position": 1
  ...
}

Changing the images

Go into the public/static folder and change the 2 images. Add your own logo and picture there. The logo must be in SVG format.

Add your own content

Create a new file under the _posts directory. Let's assume the new documentation file name is getting-started.mdx

You can nest files within folders.

Example:

posts/
└── components/
    ├── Button
    ├── Link
    └── Etc

Be careful about the name because it will be the url (path) for the documentation.

Every documentation has a top section where you can specify some meta data about that blog

---
title: "Getting Started"
description: "This is a short description of the documentation"
banner: "/images/getting-started.jpeg"
tags: ["Setup"]
date: 1 October 2022
position: 1
---

Adding an image for the documentation file and folder (Optional)

It is recommended the image is in the same file structure as the document that is referencing it. So if the doc is in Getting Started/Setup, you should mirror this into the public/images/ folder.

Documentation File Image

Add an image to the public/images/ folder.

Folder Image

Add a define.json file within the folder. For the banner key add the path to the image you want for the folder.

Example:

{
  ...
  "banner": "/images/setup.jpg"
  ...
}

or

Add a image to the public/images/(Folder Name)/(Folder Name.File Extension).

Example:

public/
└── images/
    ├── sample.jpg
    └── Getting Started/
        ├── getting-started.jpg (This will give the folder getting started an image)
        └── setup.jpg (this will give the file setup.mdx an image if that was assigned in the frontmatter.)

Setting up Favicon

Generate your favicon files through your favorite method, or use https://www.favicon-generator.org/

Color customization

You can change the accent color to be whatever you like by going into tailwind.config.js and updating the primary color to your preference.

Example:

const colors = require("tailwindcss/colors");

module.exports = {
  ...
  theme: {
    extend: {
      colors: {
        primary: colors.amber,
      },
    },
  },
  ...
};

Run the project to verify

If you want to test the project locally

npm run dev

and go to http://localhost:3000/getting-started to see the fruits of your labor!

Deploy!

Once you're done, you can deploy to Vercel with the click of a button!

Deploy with Vercel

Github Repo

https://github.com/dishwasher-detergent/CornDocs

corndocs's People

Contributors

dishwasher-detergent avatar mohammad-faisal avatar arbak avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.