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

Deploy docs to Github pages #449

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

Conversation

yann1cks
Copy link
Contributor

@yann1cks yann1cks commented Nov 2, 2024

Hello Raphael,

I created a Github Action to deploy the Docs to Github pages. It does not use an additional docs branch. This PR is more of a draft/example which deploys the docs to my custom domain (https://pingouin.stadtfeld.xyz/).

The following changes are needed on your site to deploy the docs to Github Pages:

  1. Verify your domain to protect it. Here is the official guide.
  2. Change the domain in the CNAME file to pingouin-stats.org. There is nothing else in this file.
  3. Configure your DNS following the official guide, Link.
  4. Also configure the www subdomain by adding the required CNAME record.

Deploying the documentation is triggered manually, because of on: workflow_dispatch in the documentation.yml file. There are many other triggers. Its possible to trigger the action if a specific tag is used or a release created. I do not know what you prefer, so I went with the manual option.

Copy link

codecov bot commented Nov 2, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 98.54%. Comparing base (873eb4b) to head (c1bcfac).

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #449   +/-   ##
=======================================
  Coverage   98.54%   98.54%           
=======================================
  Files          19       19           
  Lines        3360     3360           
  Branches      492      492           
=======================================
  Hits         3311     3311           
  Misses         26       26           
  Partials       23       23           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@raphaelvallat raphaelvallat self-requested a review November 14, 2024 17:22
@raphaelvallat raphaelvallat added the docs/testing:book: Documentation and unit testing label Nov 14, 2024
@raphaelvallat
Copy link
Owner

Hi @yann1cks,

Thank you so much for working on this and the detailed explanation on how to use this. This is great. I'll give it a try soon.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs/testing:book: Documentation and unit testing
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants