Skip to content

Conversation

@krystophny
Copy link
Collaborator

Summary

  • Fixes the issue where FORD configuration metadata was appearing as raw text on GitHub Pages
  • Configuration moved to fpm.toml where it belongs
  • Documentation now displays cleanly without metadata artifacts

Problem

The GitHub Pages documentation at https://lazy-fortran.github.io/fortplot/ was showing raw YAML configuration text instead of a clean summary. This was due to incorrect FORD metadata format in doc.md.

Solution

  • Removed all YAML metadata from doc.md (keeping only markdown content)
  • Simplified the [extra.ford] configuration in fpm.toml to essential settings
  • FORD now correctly reads configuration from fpm.toml and displays clean documentation

Testing

  • Regenerated documentation locally with ford doc.md
  • Verified that build/doc/index.html no longer contains metadata text
  • Confirmed clean HTML output without configuration artifacts

Fixes #399

The FORD documentation generator was displaying raw YAML metadata
on the GitHub Pages site instead of parsing it as configuration.

Changes:
- Removed YAML front matter from doc.md (configuration now in fpm.toml)
- Simplified fpm.toml [extra.ford] section to essential settings
- Documentation now displays clean content without metadata artifacts

Fixes #399
@codecov
Copy link

codecov bot commented Aug 26, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@krystophny krystophny merged commit e5e2147 into main Aug 26, 2025
5 checks passed
@krystophny krystophny deleted the fix-strange-summary-github-pages-399 branch August 26, 2025 17:15
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.

Strange summary on github pages

2 participants