web.docusaurus #

fn new(args_ DocusaurusArgs) !&DocusaurusFactory

enum ErrorCat {
	unknown
	image_double
	file_double
	file_not_found
	image_not_found
	page_double
	page_not_found
	sidebar
	circular_import
	def
	summary
	include
}

struct Configuration {
pub mut:
	main   Main
	navbar Navbar
	footer Footer
}

struct DSiteGetArgs {
pub mut:
	name         string
	nameshort    string
	path         string
	url          string
	path_publish string // default empty
	// path_build    string //default empty
	production    bool
	watch_changes bool = true
	update        bool
	open          bool
	init          bool // means create new one if needed
	deploykey     string
	// config        ?Configuration
}

struct DevArgs {
pub mut:
	host string = 'localhost'
	port int    = 3000
}

struct DocSite {
pub mut:
	name     string
	url      string
	path_src pathlib.Path
	// path_build pathlib.Path
	path_publish pathlib.Path
	args         DSiteGetArgs
	errors       []SiteError
	config       Configuration
	factory      &DocusaurusFactory @[skip; str: skip] // Reference to the parent
}

fn (mut s DocSite) build() !

fn (mut s DocSite) build_dev_publish() !

fn (mut s DocSite) build_publish() !

fn (mut s DocSite) dev(args DevArgs) !

fn (mut s DocSite) dev_watch(args DevArgs) !

fn (mut site DocSite) download_collections() !

fn (mut site DocSite) error(args ErrorArgs)

fn (mut site DocSite) generate() !

fn (mut s DocSite) open(args DevArgs) !

struct DocusaurusArgs {
pub mut:
	path_publish string
	path_build   string
	production   bool
	update       bool
	// heroscript      string
	// heroscript_path string
}

struct DocusaurusFactory {
pub mut:
	sites        []&DocSite @[skip; str: skip]
	path_build   pathlib.Path
	path_publish pathlib.Path
	args         DocusaurusArgs
	config       Configuration // Stores configuration from HeroScript if provided
}

fn (mut f DocusaurusFactory) get(args_ DSiteGetArgs) !&DocSite

struct ErrorArgs {
pub mut:
	path string
	msg  string
	cat  ErrorCat
}

struct Footer {
pub mut:
	style string
	links []FooterLink
}

struct FooterItem {
pub mut:
	label string
	href  string
	to    string
}

struct FooterLink {
pub mut:
	title string
	items []FooterItem
}

struct Logo {
pub mut:
	alt      string
	src      string
	src_dark string @[json: 'srcDark']
}

struct Main {
pub mut:
	title          string
	tagline        string
	favicon        string
	url            string
	base_url       string @[json: 'baseUrl']
	url_home       string
	image          string
	metadata       Metadata
	build_dest     []string @[json: 'buildDest']
	build_dest_dev []string @[json: 'buildDestDev']
	copyright      string
	name           string
}

struct Metadata {
pub mut:
	description string
	image       string
	title       string
}

struct Navbar {
pub mut:
	title string
	logo  Logo
	items []NavbarItem
}

struct NavbarItem {
pub mut:
	label    string
	href     string
	position string
	to       string
}

struct SiteError {
	Error
pub mut:
	path string
	msg  string
	cat  ErrorCat
}