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

automatic spelling check by sphinx-spelling ext. #4998

Draft
wants to merge 1 commit into
base: rolling
Choose a base branch
from

Conversation

fujitatomoya
Copy link
Collaborator

related to #4997

i tried another approach with sphinxcontrib.spelling, that i knew that is going to be aggressive to detect possible misspelling...

although this works as framework, this generates much more burden to maintain the whitelist and false alarms... i am not gonna suggest this approach at this moment...

rosindex@08a1b9556c31:/tmp/doc_repository$ make spellcheck
...
Writing /tmp/doc_repository/build/spellcheck/index.spelling

WARNING: Found 10145 misspelled words
sphinx-sitemap-ros: No pages generated for sitemap.xml
build succeeded, 1 warning.

Check finished. Report is in build/spellcheck.```

Comment on lines +92 to +94
spelling_ignore_acronyms = True
spelling_ignore_case = True
spelling_ignore_digits = True
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

according to the result with this repo, these configurations do not really help to reduce the warnings.

Copy link

github-actions bot commented Feb 6, 2025

HTML artifacts: https://github.com/ros2/ros2_documentation/actions/runs/13172711320/artifacts/2545492862.

To view the resulting site:

  1. Click on the above link to download the artifacts archive
  2. Extract it
  3. Open html-artifacts-4998/index.html in your favorite browser

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.

1 participant