JuliaDiff / JuliaDiff/DocThemeIndigo.jl
generate the CSS file in build directory
Nobody has claimed this yet.
- Dominant language
- SCSS
- Stars
- 7
- Forks
- 1
- PR merge metrics
- No merged PRs in 30d
Description
currently, we generate CSS files in src/assets, this is causing LiveServer falls into recursive execution of the make.jl script because it will watch the generated CSS file. One will need to ignore this CSS file in order to make LiveServer work correctly with this package. I'm not sure what would be the best way to solve this, but generate the CSS to the build directory might be the solution. But then the problem becomes how to make Documenter recognize this.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by tracing the CSS generation in src/assets and the make.jl workflow, then check how Documenter discovers the generated stylesheet. Determine a build-directory location that prevents LiveServer from watching and rerunning make.jl, while keeping the theme CSS available to Documenter. Done means LiveServer no longer recursively executes and the documentation still loads the generated styles.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- julia, scss
- Domain
- build-system, documentation
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100