documentation
Build a statically generated documentation directory, container or service using Hugo and Camptocamp branded Docsy theme.Installation
dagger install github.com/camptocamp/daggerverse/documentation@v0.2.3
Entrypoint
Return Type
Documentation
Example
dagger -m github.com/camptocamp/daggerverse/documentation@81c7c3012b2ef703465237470376a367eb20e1d9 call \
func (m *myModule) example() *Documentation {
return dag.
Documentation()
}
@function
def example() -> dag.Documentation:
return (
dag.documentation()
)
@func()
example(): Documentation {
return dag
.documentation()
}
Types
Documentation 🔗
Documentation
init() 🔗
Get a directory containing a newly initialized documentation
Return Type
Directory !
Example
dagger -m github.com/camptocamp/daggerverse/documentation@81c7c3012b2ef703465237470376a367eb20e1d9 call \
init
func (m *myModule) example() *Directory {
return dag.
Documentation().
Init()
}
@function
def example() -> dagger.Directory:
return (
dag.documentation()
.init()
)
@func()
example(): Directory {
return dag
.documentation()
.init()
}
builder() 🔗
Documentation builder constructor
Return Type
Builder !
Arguments
Name | Type | Default Value | Description |
---|---|---|---|
directory | Directory ! | - | Directory containing documentation to build |
Example
dagger -m github.com/camptocamp/daggerverse/documentation@81c7c3012b2ef703465237470376a367eb20e1d9 call \
builder --directory DIR_PATH
func (m *myModule) example(directory *Directory) *DocumentationBuilder {
return dag.
Documentation().
Builder(directory)
}
@function
def example(directory: dagger.Directory) -> dag.DocumentationBuilder:
return (
dag.documentation()
.builder(directory)
)
@func()
example(directory: Directory): DocumentationBuilder {
return dag
.documentation()
.builder(directory)
}
Builder 🔗
Documentation builder
container() 🔗
Get a container ready to build the documentation
Return Type
Container !
Example
dagger -m github.com/camptocamp/daggerverse/documentation@81c7c3012b2ef703465237470376a367eb20e1d9 call \
builder --directory DIR_PATH \
container
func (m *myModule) example(directory *Directory) *Container {
return dag.
Documentation().
Builder(directory).
Container()
}
@function
def example(directory: dagger.Directory) -> dagger.Container:
return (
dag.documentation()
.builder(directory)
.container()
)
@func()
example(directory: Directory): Container {
return dag
.documentation()
.builder(directory)
.container()
}
build() 🔗
Build the documentation
Return Type
BuildResult !
Arguments
Name | Type | Default Value | Description |
---|---|---|---|
args | [String ! ] | - | Documentation builder arguments (Hugo arguments) |
Example
dagger -m github.com/camptocamp/daggerverse/documentation@81c7c3012b2ef703465237470376a367eb20e1d9 call \
builder --directory DIR_PATH \
build
func (m *myModule) example(directory *Directory) *DocumentationBuildResult {
return dag.
Documentation().
Builder(directory).
Build()
}
@function
def example(directory: dagger.Directory) -> dag.DocumentationBuildResult:
return (
dag.documentation()
.builder(directory)
.build()
)
@func()
example(directory: Directory): DocumentationBuildResult {
return dag
.documentation()
.builder(directory)
.build()
}
BuildResult 🔗
Documentation build result
directory() 🔗
Get a directory containing the documentation build result
Return Type
Directory !
Example
dagger -m github.com/camptocamp/daggerverse/documentation@81c7c3012b2ef703465237470376a367eb20e1d9 call \
builder --directory DIR_PATH \
build \
directory
func (m *myModule) example(directory *Directory) *Directory {
return dag.
Documentation().
Builder(directory).
Build().
Directory()
}
@function
def example(directory: dagger.Directory) -> dagger.Directory:
return (
dag.documentation()
.builder(directory)
.build()
.directory()
)
@func()
example(directory: Directory): Directory {
return dag
.documentation()
.builder(directory)
.build()
.directory()
}
container() 🔗
Get a container ready to serve the documentation
Container exposes port 8080.
Return Type
Container !
Arguments
Name | Type | Default Value | Description |
---|---|---|---|
platform | Scalar | - | Platform to get container for |
Example
dagger -m github.com/camptocamp/daggerverse/documentation@81c7c3012b2ef703465237470376a367eb20e1d9 call \
builder --directory DIR_PATH \
build \
container
func (m *myModule) example(directory *Directory) *Container {
return dag.
Documentation().
Builder(directory).
Build().
Container()
}
@function
def example(directory: dagger.Directory) -> dagger.Container:
return (
dag.documentation()
.builder(directory)
.build()
.container()
)
@func()
example(directory: Directory): Container {
return dag
.documentation()
.builder(directory)
.build()
.container()
}
server() 🔗
Get a service serving the documentation
See container()
for details.
Return Type
Service !
Example
dagger -m github.com/camptocamp/daggerverse/documentation@81c7c3012b2ef703465237470376a367eb20e1d9 call \
builder --directory DIR_PATH \
build \
server
func (m *myModule) example(directory *Directory) *Service {
return dag.
Documentation().
Builder(directory).
Build().
Server()
}
@function
def example(directory: dagger.Directory) -> dagger.Service:
return (
dag.documentation()
.builder(directory)
.build()
.server()
)
@func()
example(directory: Directory): Service {
return dag
.documentation()
.builder(directory)
.build()
.server()
}