{-# LANGUAGE ScopedTypeVariables #-} {-# LANGUAGE OverloadedStrings #-} module Database.Design.Ampersand.Output.ToPandoc.SharedAmongChapters ( module Text.Pandoc , module Text.Pandoc.Builder , bulletList -- (is redefined in this module, but belongs in Text.Pandoc.Builder.) , math -- , module Data.Monoid , module Database.Design.Ampersand.Basics , module Database.Design.Ampersand.FSpec , module Database.Design.Ampersand.Misc , module Database.Design.Ampersand.Core.AbstractSyntaxTree , Chapter(..) , chaptersInDoc , chptHeader , chptTitle , Xreferencable(..) , showImage , canXRefer , Purpose(..) , purposes2Blocks , isMissing , lclForLang , dpRule' , relsInThemes , Counter(..),newCounter,incEis , inlineIntercalate , orderingByTheme , plainText , NLString(..) , ENString(..) , LocalizedStr , localize ) where import Database.Design.Ampersand.Basics import Database.Design.Ampersand.Core.AbstractSyntaxTree hiding (Meta) import Database.Design.Ampersand.ADL1 import Database.Design.Ampersand.Classes import Database.Design.Ampersand.FSpec import Text.Pandoc import Text.Pandoc.Builder hiding (bulletList,math) import qualified Text.Pandoc.Builder as BuggyBuilder import Database.Design.Ampersand.Output.PredLogic (PredLogicShow(..), showLatex) import Database.Design.Ampersand.Misc import Database.Design.Ampersand.Output.PandocAux import Data.List (intercalate,partition) import Data.Monoid import System.Locale fatal :: Int -> String -> a fatal = fatalMsg "Output.ToPandoc.SharedAmongChapters" data Chapter = Intro | SharedLang | Diagnosis | ConceptualAnalysis | ProcessAnalysis | DataAnalysis | SoftwareMetrics | EcaRules | Interfaces | FunctionPointAnalysis | Glossary deriving (Eq, Show) -- | Define the order of the chapters in the document. chaptersInDoc :: Options -> [Chapter] chaptersInDoc opts = [chp | chp<-chapters, chp `notElem` disabled] where -- temporarily switch off chapters that need too much refactoring, but keep this Haskell code compilable. disabled = [] chapters | test opts = [Interfaces] | diagnosisOnly opts = [Diagnosis] | theme opts == StudentTheme = [Intro,SharedLang,Diagnosis,ConceptualAnalysis,DataAnalysis] | otherwise = [ Intro , SharedLang , Diagnosis , ConceptualAnalysis , ProcessAnalysis , DataAnalysis , SoftwareMetrics , EcaRules , Interfaces ] ++ [ FunctionPointAnalysis | genFPAChap opts ] ++ [ Glossary ] -- | This function returns a header of a chapter chptHeader :: Lang -> Chapter -> Blocks chptHeader lang chap = header 1 (chptTitle lang chap ) <> (para (xrefLabel chap)) chptTitle :: Lang -> Chapter -> Inlines chptTitle lang cpt = (case (cpt,lang) of (Intro , Dutch ) -> text "Inleiding" (Intro , English) -> text "Introduction" (SharedLang , Dutch ) -> text "Gemeenschappelijke taal" (SharedLang , English) -> text "Shared Language" (Diagnosis , Dutch ) -> text "Diagnose" (Diagnosis , English) -> text "Diagnosis" (ConceptualAnalysis , Dutch ) -> text "Conceptuele Analyse" (ConceptualAnalysis , English) -> text "Conceptual Analysis" (ProcessAnalysis , Dutch ) -> text "Procesanalyse" (ProcessAnalysis , English) -> text "Process Analysis" (DataAnalysis , Dutch ) -> text "Gegevensstructuur" (DataAnalysis , English) -> text "Data structure" (SoftwareMetrics , Dutch ) -> text "Functiepunt Analyse" (SoftwareMetrics , English) -> text "Function Point Analysis" (EcaRules , Dutch ) -> text "ECA regels" (EcaRules , English) -> text "ECA rules (Flash points)" (Interfaces , Dutch ) -> text "Koppelvlakken" (Interfaces , English) -> text "Interfaces" (FunctionPointAnalysis , Dutch ) -> text "Functiepuntanalyse" (FunctionPointAnalysis , English) -> text "Function point analysis" (Glossary , Dutch ) -> text "Begrippen" (Glossary , English) -> text "Glossary" ) class Xreferencable a where xLabel :: a -> String -- xrefReference :: a -> Inline --Depreciated! TODO: use xRefReference instead -- xrefReference a = fatal 117 $ "--Depreciated! TODO: use xRefReference instead" xRefReference :: Options -> a -> Inlines xRefReference opts a | canXRefer opts = rawInline "latex" ("\\ref{"++xLabel a++"}") | otherwise = mempty -- "fatal 89 xreferencing is not supported!" xrefLabel :: a -> Inlines xrefLabel a = rawInline "latex" ("\\label{"++xLabel a++"}") canXRefer :: Options -> Bool canXRefer opts = fspecFormat opts `elem` [FLatex] instance Xreferencable Chapter where xLabel a = "chapter" ++ escapeNonAlphaNum (show a) instance Xreferencable Picture where xLabel a = "figure" ++ escapeNonAlphaNum (caption a) --Image [Inline] Target -- alt.text (URL,title) showImage :: Options -> Picture -> Inlines showImage opts pict = case fspecFormat opts of FLatex -> rawInline "latex" ("\\begin{figure}[htb]\n\\begin{center}\n\\scalebox{"++scale pict++"}["++scale pict++"]{") _ -> mempty <> image (imagePath opts pict) (xLabel pict) (text $ "Here, "++caption pict++" should have been visible" ) <> case fspecFormat opts of FLatex -> rawInline "latex" "}\n" <>rawInline "latex" ("\\caption{"++latexEscShw (caption pict)++"}\n") _ -> mempty <> (xrefLabel pict) <> case fspecFormat opts of FLatex -> rawInline "latex" "\n\\end{center}\n\\end{figure}" _ -> mempty -- | This function orders the content to print by theme. It returns a list of -- tripples by theme. The last tripple might not have a theme, but will contain everything -- that isn't handled in a specific theme. orderingByTheme :: FSpec -> [( Maybe Pattern -- A theme is about either a pattern or a process. , [Rule] -- The rules of that theme , [Declaration] -- The relations that are used in a rule of this theme, but not in any rule of a previous theme. , [A_Concept] -- The concepts that are used in a rule of this theme, but not in any rule of a previous theme. ) ] orderingByTheme fSpec = f (fallRules fSpec) (filter isUserDefined (relsMentionedIn fSpec)) (allConcepts fSpec) tms where isUserDefined d = case d of Sgn{} -> decusr d _ -> False -- | The patterns that should be taken into account for this ordering tms = if null (themes fSpec) then (vpatterns fSpec) else [ pat | pat <-vpatterns fSpec, name pat `elem` themes fSpec ] f ruls rels cpts ts = case ts of t:ts' -> let ( (rulsOfTheme,rulsNotOfTheme) , (relsOfTheme,relsNotOfTheme) , (cptsOfTheme,cptsNotOfTheme) ) = partitionByTheme t ruls rels cpts in (Just t, rulsOfTheme, relsOfTheme, cptsOfTheme) : f rulsNotOfTheme relsNotOfTheme cptsNotOfTheme ts' [] -> [(Nothing, ruls, rels, cpts)] -- | This function takes care of partitioning each of the -- lists in a pair of lists of elements which do and do not belong -- to the theme, respectively partitionByTheme :: Pattern -> [Rule] -> [Declaration] -> [A_Concept] -> ( ([Rule],[Rule]) , ([Declaration],[Declaration]) , ([A_Concept],[A_Concept]) ) partitionByTheme pat ruls rels cpts = ((rulsOfTheme,rulsNotOfTheme), (relsOfTheme,relsNotOfTheme), (cptsOfTheme,cptsNotOfTheme)) where (rulsOfTheme,rulsNotOfTheme) = partition isRulOfTheme ruls isRulOfTheme r = r `elem` ptrls pat (relsOfTheme,relsNotOfTheme) = partition isRelOfTheme rels isRelOfTheme r = r `elem` (concatMap relsUsedIn rulsOfTheme) (cptsOfTheme,cptsNotOfTheme) = partition isCptOfTheme cpts isCptOfTheme c = c `elem` concatMap concs relsOfTheme --GMI: What's the meaning of the Int? dpRule' :: FSpec -> [Rule] -> Int -> [A_Concept] -> [Declaration] -> ([(Inlines, [Blocks])], Int, [A_Concept], [Declaration]) dpRule' fSpec = dpR where l lstr = text $ localize (fsLang fSpec) lstr dpR [] n seenConcs seenDeclarations = ([], n, seenConcs, seenDeclarations) dpR (r:rs) n seenConcs seenDeclarations = ( ( str (name r) , [theBlocks] ): dpNext , n' , seenCs , seenDs ) where theBlocks :: Blocks theBlocks = ( (purposes2Blocks (getOpts fSpec) (purposesDefinedIn fSpec (fsLang fSpec) r)) -- Als eerste de uitleg van de betreffende regel.. <> (purposes2Blocks (getOpts fSpec) [p | d<-nds, p<-purposesDefinedIn fSpec (fsLang fSpec) d]) -- Dan de uitleg van de betreffende relaties <> case (nds, fsLang fSpec) of ([] ,_) -> mempty ([d],Dutch) -> plain ("Om dit te formaliseren is een " <> (if isFunction d then "functie" else "relatie" ) <> str (name d) <> " nodig (" <> xRefTo (XRefNaturalLanguageDeclaration d) <> "):") ([d],English) -> plain ("In order to formalize this, a " <> (if isFunction d then "function" else "relation") <> str (name d) <> " is introduced (" <> xRefTo (XRefNaturalLanguageDeclaration d) <> "):") (_ ,Dutch) -> plain ("Om te komen tot de formalisatie van " <> xRefTo (XRefNaturalLanguageRule r) <> " (" <> (singleQuoted.str.name) r <> ") " <> str (" zijn de volgende "++count Dutch (length nds) "in deze paragraaf geformaliseerde relatie"++" nodig.")) (_ ,English) -> plain ("To arrive at the formalization of " <> xRefTo (XRefNaturalLanguageRule r) <> str (", the following "++count English (length nds) "relation"++" are introduced.")) <> (fromList $ pandocEqnArray [ [ "("++xRefToLatexRefString (XRefConceptualAnalysisDeclaration d) ++ ")\\;\\;" , texOnly_Id(name d) , ":" , texOnly_Id(name (source d))++(if isFunction d then texOnly_fun else texOnly_rel)++texOnly_Id(name(target d)) ] |d<-nds]) <> (case nds of [] -> case rds of [] -> mempty [rd] -> plain ( l (NL "Relatie ", EN "We use relations ") <> xRefTo (XRefConceptualAnalysisDeclaration rd) <> "(" <> (emph.str.name) rd <> ")" <> l (NL " wordt gebruikt.", EN ".") ) _ -> plain ( (case fsLang fSpec of Dutch -> "We gebruiken de relaties " <> commaNLPandoc' "en" [xRefTo (XRefConceptualAnalysisDeclaration rd) <> " (" <> (emph.str.name) rd <> ")" |rd<-rds] English -> "We use relations " <> commaEngPandoc' "and" [xRefTo (XRefConceptualAnalysisDeclaration rd) <> " (" <> (emph.str.name) rd <> ")" |rd<-rds] ) ) _ -> if null rds then mempty else ( plain ( ( case rds of [] -> mempty [rd] -> l (NL "Daarnaast gebruiken we relatie ", EN "Beside that, we use relation ") <> xRefTo (XRefConceptualAnalysisDeclaration rd) <> "(" <> (str.name) rd <> ")" _ -> (case fsLang fSpec of Dutch -> "Ook gebruiken we relaties " <> commaNLPandoc' "en" [xRefTo (XRefConceptualAnalysisDeclaration rd) <> " (" <> (emph.str.name) rd <> ")" |rd<-rds] English -> "We also use relations " <> commaEngPandoc' "and" [xRefTo (XRefConceptualAnalysisDeclaration rd) <> " (" <> (emph.str.name) rd <> ")" |rd<-rds] ) ) <> l (NL " om ", EN " to formalize ") <> xRefTo (XRefNaturalLanguageRule r) <> l (NL " te formaliseren: ", EN ": ") ) ) ) <> plain (if isSignal r then l ( NL "Activiteiten, die door deze regel zijn gedefinieerd, zijn afgerond zodra: " , EN "Activities that are defined by this rule are finished when: ") else l (NL "De regel luidt: ", EN "This means: ") ) <> (if showPredExpr (getOpts fSpec) then pandocEqnArrayWithLabel (XRefConceptualAnalysisRule r) ((showLatex.toPredLogic) r) else pandocEquationWithLabel (XRefConceptualAnalysisRule r) (showMath r) ) <> (if length nds<=1 then mempty else plain ( l (NL "Dit komt overeen met ", EN "This corresponds to ") <> xRefTo (XRefNaturalLanguageRule r) <> " (" <> (singleQuoted.str.name) r <> ")." ) ) ) ncs = concs r >- seenConcs -- newly seen concepts cds = [(c,cd) | c<-ncs, cd<-cDefsInScope fSpec, cdcpt cd==name c] -- ... and their definitions ds = relsUsedIn r nds = [d | d@Sgn{}<-ds >- seenDeclarations] -- newly seen relations rds = [d | d@Sgn{}<-ds `isc` seenDeclarations] -- previously seen relations ( dpNext, n', seenCs, seenDs ) = dpR rs (n+length cds+length nds+1) (ncs++seenConcs) (nds++seenDeclarations) relsInThemes :: FSpec -> [Declaration] relsInThemes fSpec -- a relation is considered relevant iff it is declared or mentioned in one of the relevant themes. = [d | d<-vrels fSpec , decusr d , ( decpat d `elem` themes fSpec || d `elem` relsMentionedIn [p | p<- vpatterns fSpec , name p `elem` themes fSpec] ) ] data Counter = Counter { --getConc :: Int -- getDecl :: Int -- , getRule :: Int getEisnr:: Int } newCounter :: Counter newCounter = Counter 1 incEis :: Counter -> Counter --incConc x = x{getConc = getConc x + 1} --incDecl x = x{getDecl = getDecl x + 1} --incRule x = x{getRule = getRule x + 1} incEis x = x{getEisnr = getEisnr x + 1} purposes2Blocks :: Options -> [Purpose] -> Blocks purposes2Blocks opts ps = fromList $ case ps of [] -> [] -- by putting the ref after the first inline of the definition, it aligns nicely with the definition _ -> case concatMarkup [expl{amPandoc = insertAfterFirstInline (ref purp) $ amPandoc expl} | purp<-ps, let expl=explMarkup purp] of Nothing -> [] Just p -> amPandoc p where -- The reference information, if available for this purpose, is put ref :: Purpose -> [Inline] ref purp = case fspecFormat opts of FLatex | (not.null.explRefIds) purp-> [RawInline (Text.Pandoc.Builder.Format "latex") ("\\marge{"++intercalate "; " (map latexEscShw (explRefIds purp))++"}\n")] _ -> [] concatMarkup :: [A_Markup] -> Maybe A_Markup concatMarkup es = case eqCl f es of [] -> Nothing [cl] -> Just A_Markup { amLang = amLang (head cl) , amFormat = amFormat (head cl) , amPandoc = concatMap amPandoc es } cls -> fatal 136 ("don't call concatMarkup with different languages and formats\n "++ intercalate "\n " [(show.f.head) cl | cl<-cls]) where f e = (amLang e, amFormat e) -- Insert an inline after the first inline in the list of blocks, if possible. insertAfterFirstInline :: [Inline] -> [Block] -> [Block] insertAfterFirstInline inlines ( Plain (inl:inls):pblocks) = Plain (inl : (inlines++inls)) : pblocks insertAfterFirstInline inlines ( Para (inl:inls):pblocks) = Para (inl : (inlines++inls)) : pblocks insertAfterFirstInline inlines (BlockQuote (Para (inl:inls):pblocks):blocks) = BlockQuote (Para (inl : (inlines++inls)) : pblocks):blocks insertAfterFirstInline inlines blocks = Plain inlines : blocks isMissing :: Maybe Purpose -> Bool isMissing mp = case mp of Nothing -> True Just p -> (not . explUserdefd) p lclForLang :: Lang -> TimeLocale lclForLang lang = defaultTimeLocale { months = case lang of Dutch -> [ ("januari","jan"),("februari","feb"),("maart","mrt"),("april","apr") , ("mei","mei"),("juni","jun"),("juli","jul"),("augustus","aug") , ("september","sep"),("oktober","okt"),("november","nov"),("december","dec")] English -> [ ("January","Jan"),("February","Feb"),("March","Mar"),("April","Apr") , ("May","May"),("June","Jun"),("July","Jul"),("August","Aug") , ("September","Sep"),("October","Oct"),("November","Nov"),("December","Dec")] } inlineIntercalate :: Inlines -> [Inlines] -> Inlines inlineIntercalate _ [] = mempty inlineIntercalate _ [x] = x inlineIntercalate sep (x:xs) = x <> sep <> inlineIntercalate sep xs plainText :: String -> Blocks plainText = plain . text -- Temporary fixes of Pandoc builder. --- bulletList :: [Blocks] -> Blocks bulletList [] = mempty bulletList xs = BuggyBuilder.bulletList xs math :: String -> Inlines math s = BuggyBuilder.math ("{"++s++"}") -- Utility types and functions for handling multiple-language strings -- If you declare a local function: l lstr = localize (fsLang fSpec) lstr -- you can use: l (NL "Nederlandse tekst", EN "English text") -- to specify strings in multiple languages. newtype NLString = NL String newtype ENString = EN String type LocalizedStr = (NLString, ENString) localize :: Lang -> LocalizedStr -> String localize Dutch (NL s, _) = s localize English (_, EN s) = s