adding doc

This commit is contained in:
qwjyh 2023-11-12 09:57:28 +09:00
parent 39b5a334c7
commit bcd54dc673
No known key found for this signature in database
GPG key ID: F30838CD89227A79
9 changed files with 63 additions and 0 deletions

View file

@ -6,6 +6,7 @@ version = "0.1.0"
[deps] [deps]
ColorSchemes = "35d6a980-a343-548e-a6ea-1d62b119f2f4" ColorSchemes = "35d6a980-a343-548e-a6ea-1d62b119f2f4"
Dates = "ade2ca70-3891-5945-98fb-dc099432e06a" Dates = "ade2ca70-3891-5945-98fb-dc099432e06a"
Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
GLMakie = "e9467ef8-e4e7-5192-8a1a-b1aee30e663a" GLMakie = "e9467ef8-e4e7-5192-8a1a-b1aee30e663a"
YAML = "ddb6d928-2868-570f-bddf-ab3f9cf99eb6" YAML = "ddb6d928-2868-570f-bddf-ab3f9cf99eb6"

2
docs/.gitignore vendored Normal file
View file

@ -0,0 +1,2 @@
build/
site/

2
docs/Project.toml Normal file
View file

@ -0,0 +1,2 @@
[deps]
Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"

19
docs/make.jl Normal file
View file

@ -0,0 +1,19 @@
using Documenter
using CoordVisualize
makedocs(
sitename = "CoordVisualize",
format = Documenter.HTML(),
modules = [CoordVisualize],
pages = [
"Top" => "index.md",
"API list" => "apis.md"
]
)
# Documenter can also automatically deploy documentation to gh-pages.
# See "Hosting Documentation" and deploydocs() in the Documenter manual
# for more information.
#=deploydocs(
repo = "<repository url>"
)=#

8
docs/src/apis.md Normal file
View file

@ -0,0 +1,8 @@
# API list
```@index
```
```@autodocs
Modules = [CoordVisualize]
```

27
docs/src/index.md Normal file
View file

@ -0,0 +1,27 @@
```@meta
CurrentModule = CoordVisualize
```
# CoordVisualize.jl
Documentation for CoordVisualize.jl
## Tutorial
Readers are expected to be familiar with basics of julia.
### Log structure
CoordVisualize.jl treats coordination trace log with some additional information,
datetime when log was taken and supplemental note to annotate the log.
This set of log is represented by the type [`CoordLog`](@ref).
### Parsing Log
Use [`parse_log`](@ref) to parse log files generated with Tracecoords CSM mod.
Set the keyword argument `interactive` to `true` to supply notes interactively.
It automatically get datetime.
Notes can be also supplied in the following section.
### Editing
You sometimes want to split logs and to give more appropriate notes for each of them.
You can do this with [`split_log`](@ref) function.
You can also edit existing notes with [`assign_note!`](@ref).

View file

@ -5,5 +5,6 @@ using Dates
include("typedef.jl") include("typedef.jl")
include("parser.jl") include("parser.jl")
include("edit.jl") include("edit.jl")
include("print.jl")
end # module CoordVisualize end # module CoordVisualize

0
src/print.jl Normal file
View file

View file

@ -1,4 +1,7 @@
using Dates using Dates
"""
Stores a set of logs with its taken date datetime and supplemental note.
"""
mutable struct CoordLog{T <: AbstractFloat} mutable struct CoordLog{T <: AbstractFloat}
coords::Matrix{T} coords::Matrix{T}
logdate::DateTime logdate::DateTime