drasil-gen-0.1.3.0: A framework for code and document generation for scientific software - Utils SubPackage
Safe HaskellSafe-Inferred
LanguageHaskell2010

Drasil.Generator

Synopsis

Documentation

caseStudyMainSRS :: SmithEtAlSRS -> SRSDecl -> String -> IO () Source #

A case study that only outputs an SRS in each of our supported variants.

caseStudyMainSRSWCode :: SmithEtAlSRS -> SRSDecl -> String -> Choices -> IO () Source #

A case study that outputs both an SRS in each of our supported variants as well as a single chosen software artifact in optionally many programming languages.

caseStudyMainSRSWCodeZooWLsnPlan :: SmithEtAlSRS -> SRSDecl -> String -> [Choices] -> LessonPlan -> LsnDesc -> String -> IO () Source #

The same as caseStudyMainSRSWCode, except it also produces a JupyterNotebook-based lesson plan.

caseStudyMainDrasilWebsite :: DrasilWebsite -> IO () Source #

The Drasil website binary is expected to build a `WebsiteHTML` folder containing the actual website artifacts (`index.html` and `index.css`).

Generators

genCode :: SmithEtAlSRS -> Choices -> IO FileLayout Source #

Generate an ICO-style executable software artifact.

Internal Functions

codedDirName :: String -> Choices -> String Source #

Find name of folders created for a "zoo" of executable softifacts.

FIXME: This is a hack. The generation phase should emit what artifacts it created.

Common Background Knowledge for Drasil's Science-focused Case Studies

withCommonKnowledge :: [Reference] -> [DefinedQuantityDict] -> [IdeaDict] -> [ConceptChunk] -> [UnitDefn] -> [DataDefinition] -> [InstanceModel] -> [GenDefn] -> [TheoryModel] -> [ConceptInstance] -> [Citation] -> [LabelledContent] -> ChunkDB Source #

Create a ChunkDB containing background knowledge common to all of Drasil's existing case studies. This means knowledge related to the SmithEtAl-esque SRS, mathematics, physics, general science, basic software, and general documentation.

Types (Printing Options)

type Filename = String Source #

When choosing your document, you must specify the filename for the generated output (specified without a file extension).

data Format Source #

Possible formats for printer output.

Constructors

TeX 
HTML 
Jupyter 
MDBook 

Instances

Instances details
Show Format Source # 
Instance details

Defined in Drasil.Generator.Formats