-- | This is a library which colourises Haskell code. -- It currently has five output formats: -- -- * ANSI terminal codes -- -- * LaTeX macros -- -- * HTML with font tags -- -- * HTML with CSS. -- -- * mIRC chat client colour codes. -- module Language.Haskell.HsColour (Output(..), ColourPrefs(..), hscolour) where import Language.Haskell.HsColour.Colourise (ColourPrefs(..)) import qualified Language.Haskell.HsColour.TTY as TTY import qualified Language.Haskell.HsColour.HTML as HTML import qualified Language.Haskell.HsColour.CSS as CSS import qualified Language.Haskell.HsColour.LaTeX as LaTeX import qualified Language.Haskell.HsColour.MIRC as MIRC -- | The supported output formats. data Output = TTY -- ^ ANSI terminal codes | LaTeX -- ^ TeX macros | HTML -- ^ HTML with font tags | CSS -- ^ HTML with CSS. | MIRC -- ^ mIRC chat clients deriving (Eq,Show) -- | Colourise Haskell source code with the given output format. hscolour :: Output -- ^ Output format. -> ColourPrefs -- ^ Colour preferences (for formats that support them). -> Bool -- ^ Whether to include anchors. -> Bool -- ^ Whether output document is partial or complete. -> Bool -- ^ Whether input document is literate haskell or not -> String -- ^ Title for output. -> String -- ^ Haskell source code. -> String -- ^ Coloured Haskell source code. hscolour output pref anchor partial literate title | literate = concatMap chunk . joinL . map lhsClassify . inlines | otherwise = hscolour' output pref anchor partial title where chunk (Literate c) = c chunk (Code c) = hscolour' output pref anchor True title c hscolour' :: Output -- ^ Output format. -> ColourPrefs -- ^ Colour preferences (for formats that support them). -> Bool -- ^ Whether to include anchors. -> Bool -- ^ Whether output document is partial or complete. -> String -- ^ Title for output. -> String -- ^ Haskell source code. -> String -- ^ Coloured Haskell source code. hscolour' TTY pref _ _ _ = TTY.hscolour pref hscolour' MIRC pref _ _ _ = MIRC.hscolour pref hscolour' LaTeX pref _ partial _ = LaTeX.hscolour pref partial hscolour' HTML pref anchor partial top = HTML.hscolour pref anchor partial top hscolour' CSS _ anchor partial top = CSS.hscolour anchor partial top -- | Separating literate files into code\/comment chunks. data Literate = Code {unL :: String} | Literate {unL :: String} -- Re-implementation of 'lines', for better efficiency (but decreased laziness). -- Also, importantly, accepts non-standard DOS and Mac line ending characters. -- And retains the trailing '\n' character in each resultant string. inlines :: String -> [String] inlines s = lines' s id where lines' [] acc = [acc []] lines' ('\^M':'\n':s) acc = acc ['\n'] : lines' s id -- DOS --lines' ('\^M':s) acc = acc ['\n'] : lines' s id -- MacOS lines' ('\n':s) acc = acc ['\n'] : lines' s id -- Unix lines' (c:s) acc = lines' s (acc . (c:)) -- Note, I just pass the > symbol to the colouriser, which assumes that -- it's token based and not parse-based!!! lhsClassify :: String -> Literate lhsClassify ('>':xs) = Code ('>':xs) lhsClassify xs = Literate xs joinL :: [Literate] -> [Literate] joinL [] = [] joinL (Code c:Code c2:xs) = joinL (Code (c++c2):xs) joinL (Literate c:Literate c2:xs) = joinL (Literate (c++c2):xs) joinL (any:xs) = any: joinL xs