docs

Build and edit JustRelax.jl documentation with Documenter.jl and DocumenterVitepress.

40|12|Updated Sep 1, 2021
One-click install
npx skills add https://github.com/PTsolvers/JustRelax.jl --skill docs-ptsolvers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs
Source: https://github.com/PTsolvers/JustRelax.jl/tree/main/.claude/skills/docs
Command: npx skills add https://github.com/PTsolvers/JustRelax.jl --skill docs-ptsolvers

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the process of building and editing documentation for JustRelax.jl, leveraging Documenter.jl and DocumenterVitepress.

Core Features & Use Cases

  • Automated Documentation Build: Utilizes Documenter.jl and DocumenterVitepress to automatically generate and deploy documentation.
  • Local and Remote Build Support: Offers both local development and remote deployment options.
  • Version Control Integration: Seamlessly integrates with version control systems to maintain documentation consistency.

Quick Start

Run the following commands in the root directory to build and deploy the documentation:

julia --project=docs -e 'using Pkg; Pkg.develop(path="."); Pkg.instantiate()'
julia --project=docs docs/make.jl

Frequently Asked Questions about docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build Julia package documentation with Documenter.jl and DocumenterVitepress?

Building documentation locally requires running `julia --project=docs docs/make.jl` in the root directory after instantiating the project environment, which generates the site files directly on your machine for local review.

Does DocumenterVitepress support local development and remote deployment for documentation?

Yes, DocumenterVitepress supports both local development builds and remote deployment options, allowing developers to test changes locally before deploying the generated documentation remotely.

What is the best way to automate technical documentation updates for a Julia package?

Automating technical documentation updates is best achieved by integrating Documenter.jl with version control systems, ensuring documentation consistency and automatically generating site updates whenever package changes are committed.

Do I need Julia installed to run documentation build automation scripts?

Yes, you need Julia installed to execute the documentation build automation scripts, as the process directly invokes the Julia runtime to instantiate project dependencies and execute the `make.jl` build file.

Why does my documentation build fail when running the make.jl script in Julia?

Your documentation build might fail if the project environment is not properly instantiated, requiring you to run `Pkg.develop(path=".")` and `Pkg.instantiate()` before executing `docs/make.jl` to ensure all dependencies are resolved.