Skip to content

Conversation

@Veronika271
Copy link
Collaborator

I used the content in the ReadMe file to make a new directory which has a Mkdocs website. I'm not quite sure how to continuously host this page instead of having it be open whenever you run makedocs serve, but this should create a working documentation website!

@yibeichan
Copy link
Contributor

@Veronika271 thank you!! could you please

@Veronika271
Copy link
Collaborator Author

Sorry for the delay! I just took everything out of the parent folder and pushed it, but when I try to run mkdocs gh-deploy from the main branch, it still creates a docs website at this link: https://veronika271.github.io/reproschema-py/. I'm not quite sure how to fix that.

mkdocs.yml Outdated
@@ -0,0 +1,11 @@
site_name: My Docs
Copy link
Contributor

Choose a reason for hiding this comment

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

change the site_name to reproschema-py

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

just fixed, thank you!

@yibeichan
Copy link
Contributor

Hi @Veronika271 thank you!!
now let's deploy it via github action see the following link
https://github.com/marketplace/actions/deploy-mkdocs
so you will need to create an YAML file in this folder https://github.com/ReproNim/reproschema-py/tree/main/.github/workflows
you can name it as deploy-mkdocs.yml
if it requires a token, use GITHUB_TOKEN: ${{ secrets.AUTO_TOKEN }}

# Or use mhausenblas/mkdocs-deploy-gh-pages@nomaterial to build without the mkdocs-material theme
env:
GITHUB_TOKEN: ${{ secrets.AUTO_TOKEN }}
CUSTOM_DOMAIN: optionaldomain.com
Copy link
Contributor

Choose a reason for hiding this comment

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

Veronika271 and others added 7 commits May 1, 2025 15:16
- Fix typo in site name (reproschema-py)
- Remove incorrect CNAME file
- Update GitHub workflow to use modern actions and proper permissions
- Remove internal/ directory with misleading CLAUDE.md files
- Remove .serena/ IDE configuration from version control
- Add .serena/ and internal/ to .gitignore
- Fix GitHub Actions workflow: add mkdocs-material dependency
- Fix typos in docs/index.md (resproschema -> reproschema)
- Fix incorrect pre-commit command in installation docs
- Fix variable name mismatch in redcap2reproschema.md example
- Replace AUTO_TOKEN with built-in GITHUB_TOKEN
- Add necessary permissions for release creation
- This fixes the 'Bad credentials' error in GitHub Actions
@yibeichan yibeichan merged commit a9e735c into ReproNim:main Aug 15, 2025
9 checks passed
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.

2 participants