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

Using DocumenterVitePress as new documentation site #69

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 12 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,15 @@
.DS_Store
docs/Manifest.toml
test/Manifest.toml
docs/build/
docs/build/

# DocumenterVitepress:
docs/src/.vitepress/cache
docs/src/.vitepress/dist
docs/Manifest.toml
docs/.vscode
docs/node_modules
docs/.vitepress/cache
docs/.vitepress/dist
docs/.DS_Store
docs/package-lock.json
1 change: 1 addition & 0 deletions docs/Project.toml
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ CSV = "336ed68f-0bac-5ca0-87d4-7b16caf5d00b"
CairoMakie = "13f3f980-e62b-5c42-98c6-ff1f3baf88f0"
DataFrames = "a93c6f00-e57d-5684-b7b6-d8193f3e46c0"
Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
DocumenterVitepress = "4710194d-e776-4893-9690-8d956a29c365"
MultiScaleTreeGraph = "dd4a991b-8a45-4075-bede-262ee62d5583"
PlantMeteo = "4630fe09-e0fb-4da5-a846-781cb73437b6"
PlantSimEngine = "9a576370-710b-4269-adf9-4f603a9c6423"
16 changes: 7 additions & 9 deletions docs/make.jl
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
using PlantSimEngine
using PlantMeteo
using DataFrames, CSV
using Documenter
using Documenter, DocumenterVitepress
using CairoMakie

DocMeta.setdocmeta!(PlantSimEngine, :DocTestSetup, :(using PlantSimEngine, PlantMeteo, DataFrames, CSV, CairoMakie); recursive=true)
Expand All @@ -11,12 +11,9 @@ makedocs(;
authors="Rémi Vezy <VEZY@users.noreply.github.com> and contributors",
repo=Documenter.Remotes.GitHub("VirtualPlantLab", "PlantSimEngine.jl"),
sitename="PlantSimEngine.jl",
format=Documenter.HTML(;
prettyurls=get(ENV, "CI", "false") == "true",
canonical="https://VirtualPlantLab.github.io/PlantSimEngine.jl",
edit_link="main",
assets=String[],
size_threshold=300000
format=DocumenterVitepress.MarkdownVitepress(;
repo="https://github.com/VirtualPlantLab/PlantSimEngine.jl",
# build_vitepress=false
),
pages=[
"Home" => "index.md",
Expand All @@ -37,12 +34,13 @@ makedocs(;
],
"Modelers" => "./model_coupling/model_coupling_modeler.md",
],
"FAQ" => ["./FAQ/translate_a_model.md"],
"FAQ" => ["Translate a model" => "./FAQ/translate_a_model.md"],
"API" => "API.md",
]
)

deploydocs(;
repo="github.com/VirtualPlantLab/PlantSimEngine.jl.git",
devbranch="main"
devbranch="main",
push_preview=true, # Visit https://VirtualPlantLab.github.io/PlantSimEngine.jl/previews/PR## to visualize the preview
)
5 changes: 0 additions & 5 deletions docs/src/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,11 +38,6 @@ run!(model2, meteo_day)
[![DOI](https://zenodo.org/badge/571659510.svg)](https://zenodo.org/badge/latestdoi/571659510)
[![JOSS](https://joss.theoj.org/papers/137e3e6c2ddc349bec39e06bb04e4e09/status.svg)](https://joss.theoj.org/papers/137e3e6c2ddc349bec39e06bb04e4e09)

```@contents
Pages = ["index.md"]
Depth = 5
```

## Overview

`PlantSimEngine` is a comprehensive package for simulating and modelling plants, soil and atmosphere. It provides tools to **prototype, evaluate, test, and deploy** plant/crop models at any scale. At its core, PlantSimEngine is designed with a strong emphasis on performance and efficiency.
Expand Down
Loading