Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation website template #33

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open

Conversation

alpondith
Copy link

This documentation template has been built with vitepress

Necessary Commands :

Step 1: npm dependencies

npm install

Step 2: run the documentation site on browser for development

npm run docs:dev

Step 3: build website to publish

npm run docs:build

this will create website files inside docs/.vitepress/dist directory. inside dist directory generated website files will be avaliable.

Step 4 : preview the site locally before publishing. If everything is good then publish the website.

npm run docs:preview

docs/.vitepress/config.js Outdated Show resolved Hide resolved
Comment on lines 29 to 34
// DocSearch by Algolia
// algolia: {
// appId: 'XXXXXXXXXXXX',
// apiKey: 'XXXXXXXXXXXXXXXXXXXX',
// indexName: 'XXXXX'
// },
Copy link
Owner

Choose a reason for hiding this comment

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

Do we have any simple search? Other than algolia?

Copy link
Author

Choose a reason for hiding this comment

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

Whenever the documentation site will be ready then you will have to apply here. They will email you all credentials. And this is free.

However, there is another alternative to this. But it will take some time to play with the alternative. I will inform you if I find the proper solution. Alternative plugin

docs/.vitepress/config.js Outdated Show resolved Hide resolved
@Ananto30
Copy link
Owner

Ananto30 commented Apr 4, 2023

@alpondith Thanks for the PR! 🙌
Is it possible to move the package.json and lock file in the docs folder?

@alpondith
Copy link
Author

@alpondith Thanks for the PR! raised_hands Is it possible to move the package.json and lock file to the docs folder?

Moved all files inside the documentation folder.

Also added the instruction readme file there. Please take a look while working on the documentation.

@codecov
Copy link

codecov bot commented Apr 6, 2023

Codecov Report

Patch coverage has no change and project coverage change: -0.64 ⚠️

Comparison is base (3fab0f4) 79.08% compared to head (43c3d44) 78.44%.

❗ Current head 43c3d44 differs from pull request most recent head 7aa2c9a. Consider uploading reports for the commit 7aa2c9a to get more accurate results

Additional details and impacted files
@@            Coverage Diff             @@
##             main      #33      +/-   ##
==========================================
- Coverage   79.08%   78.44%   -0.64%     
==========================================
  Files          25       25              
  Lines         631      603      -28     
==========================================
- Hits          499      473      -26     
+ Misses        132      130       -2     

see 14 files with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants