mirror of
https://github.com/GrammaticalFramework/gf-core.git
synced 2026-04-22 19:22:50 -06:00
297 lines
9.1 KiB
Haskell
297 lines
9.1 KiB
Haskell
----------------------------------------------------------------------
|
|
-- |
|
|
-- Module : GrammarToVoiceXML
|
|
-- Maintainer : Bjorn Bringert
|
|
-- Stability : (stable)
|
|
-- Portability : (portable)
|
|
--
|
|
-- Create VoiceXML dialogue system from a GF grammar.
|
|
-----------------------------------------------------------------------------
|
|
|
|
module GF.Speech.GrammarToVoiceXML (grammar2vxml) where
|
|
|
|
import qualified GF.Canon.GFC as GFC
|
|
import GF.Canon.AbsGFC (Term)
|
|
import GF.Canon.PrintGFC (printTree)
|
|
import GF.Canon.CMacros (noMark, strsFromTerm)
|
|
import GF.Canon.Unlex (formatAsText)
|
|
import GF.Compile.ShellState (StateGrammar,stateGrammarST,cncId,grammar)
|
|
import GF.Data.Str (sstrV)
|
|
import GF.Grammar.Macros hiding (assign,strsFromTerm)
|
|
import GF.Grammar.Grammar (Fun)
|
|
import GF.Grammar.Values (Tree)
|
|
import GF.UseGrammar.GetTree (string2treeErr)
|
|
import GF.UseGrammar.Linear (linTree2strings)
|
|
|
|
import GF.Infra.Ident
|
|
import GF.Infra.Modules
|
|
import GF.Data.Operations
|
|
|
|
import GF.Data.XML
|
|
|
|
import Control.Monad (liftM)
|
|
import Data.List (isPrefixOf, find, intersperse)
|
|
import Data.Maybe (fromMaybe)
|
|
|
|
import Debug.Trace
|
|
|
|
-- | the main function
|
|
grammar2vxml :: Ident -> StateGrammar -> String
|
|
grammar2vxml startcat gr = showsXMLDoc (skel2vxml name language startcat gr' qs) ""
|
|
where (name, gr') = vSkeleton (stateGrammarST gr)
|
|
qs = catQuestions gr (map fst gr')
|
|
language = "en" -- FIXME: use speechLanguage tag
|
|
--
|
|
-- * VSkeleton: a simple description of the abstract syntax.
|
|
--
|
|
|
|
type VSkeleton = [(Ident, [(Ident, [Ident])])]
|
|
type VIdent = Ident
|
|
|
|
vSkeleton :: GFC.CanonGrammar -> (VIdent,VSkeleton)
|
|
vSkeleton gr = (name,collectR rules [(c,[]) | c <- cats]) where
|
|
collectR rr hh =
|
|
case rr of
|
|
(fun,typ):rs -> case catSkeleton typ of
|
|
Ok (cats,cat) ->
|
|
collectR rs (updateSkeleton (snd cat) hh (fun, map snd cats))
|
|
_ -> collectR rs hh
|
|
_ -> hh
|
|
cats = [cat | (cat,GFC.AbsCat _ _) <- defs]
|
|
rules = [(fun, typ) | (fun,GFC.AbsFun typ _) <- defs]
|
|
|
|
defs = concat [tree2list (jments m) | im@(_,ModMod m) <- modules gr, isModAbs m]
|
|
name = ifNull (error "No abstract module") last [n | (n,ModMod m) <- modules gr, isModAbs m]
|
|
|
|
updateSkeleton :: VIdent -> VSkeleton -> (VIdent, [VIdent]) -> VSkeleton
|
|
updateSkeleton cat skel rule =
|
|
case skel of
|
|
(cat0,rules):rr | cat0 == cat -> (cat0, rule:rules) : rr
|
|
(cat0,rules):rr -> (cat0, rules) : updateSkeleton cat rr rule
|
|
|
|
--
|
|
-- * Questions to ask
|
|
--
|
|
|
|
type CatQuestions = [(VIdent,String)]
|
|
|
|
catQuestions :: StateGrammar -> [VIdent] -> CatQuestions
|
|
catQuestions gr cats = [(c,catQuestion gr c) | c <- cats]
|
|
|
|
catQuestion :: StateGrammar -> Ident -> String
|
|
catQuestion gr cat = err errHandler id (getPrintname gr cat >>= term2string)
|
|
where -- FIXME: use some better warning facility
|
|
errHandler e = trace ("GrammarToVoiceXML: " ++ e) ("quest_"++prIdent cat)
|
|
term2string = liftM sstrV . strsFromTerm
|
|
|
|
getPrintname :: StateGrammar -> Ident -> Err Term
|
|
getPrintname gr cat =
|
|
do m <- lookupModMod (grammar gr) (cncId gr)
|
|
i <- lookupInfo m cat
|
|
case i of
|
|
GFC.CncCat _ _ p -> return p
|
|
_ -> fail $ "getPrintname " ++ prIdent cat
|
|
++ ": Expected CncCat, got " ++ show i
|
|
|
|
|
|
{-
|
|
lin :: StateGrammar -> String -> Err String
|
|
lin gr fun = do
|
|
tree <- string2treeErr gr fun
|
|
let ls = map unt $ linTree2strings noMark g c tree
|
|
case ls of
|
|
[] -> fail $ "No linearization of " ++ fun
|
|
l:_ -> return l
|
|
where c = cncId gr
|
|
g = stateGrammarST gr
|
|
unt = formatAsText
|
|
-}
|
|
|
|
getCatQuestion :: VIdent -> CatQuestions -> String
|
|
getCatQuestion c qs =
|
|
fromMaybe (error "No question for category " ++ prIdent c) (lookup c qs)
|
|
|
|
--
|
|
-- * Generate VoiceXML
|
|
--
|
|
|
|
skel2vxml :: VIdent -> String -> VIdent -> VSkeleton -> CatQuestions -> XML
|
|
skel2vxml name language start skel qs =
|
|
vxml language ([startForm] ++ concatMap (uncurry (catForms gr qs)) skel)
|
|
where
|
|
gr = grammarURI (prIdent name)
|
|
startForm = Tag "form" [] [subdialog "sub" [("src", "#"++catFormId start)] []]
|
|
|
|
grammarURI :: String -> String
|
|
grammarURI name = name ++ ".grxml"
|
|
|
|
|
|
catForms :: String -> CatQuestions -> VIdent -> [(VIdent, [VIdent])] -> [XML]
|
|
catForms gr qs cat fs =
|
|
comments [prIdent cat ++ " category."]
|
|
++ [cat2form gr qs cat fs]
|
|
|
|
cat2form :: String -> CatQuestions -> VIdent -> [(VIdent, [VIdent])] -> XML
|
|
cat2form gr qs cat fs =
|
|
form (catFormId cat) $
|
|
[var "value" (Just "{ name : '?' }"),
|
|
var "callbacks" Nothing,
|
|
blockCond "value.name != '?'" [assign (catFieldId cat) "value"],
|
|
block [doCallback "entered" cat [return_ [catFieldId cat]] []],
|
|
field (catFieldId cat) []
|
|
[promptString (getCatQuestion cat qs),
|
|
vxmlGrammar (gr++"#"++catFormId cat),
|
|
nomatch [Data "I didn't understand you.", reprompt],
|
|
help [Data (mkHelpText cat)],
|
|
filled [] [if_else (catFieldId cat ++ ".name == '?'")
|
|
[reprompt]
|
|
[doCallback "refined" cat [return_ [catFieldId cat]] []]]
|
|
]
|
|
]
|
|
++ concatMap (uncurry (fun2sub gr cat)) fs
|
|
++ [block [doCallback "done" cat [return_ [catFieldId cat]] [return_ [catFieldId cat]]]]
|
|
|
|
mkHelpText :: VIdent -> String
|
|
mkHelpText cat = "help_"++ prIdent cat
|
|
|
|
fun2sub :: String -> VIdent -> VIdent -> [VIdent] -> [XML]
|
|
fun2sub gr cat fun args =
|
|
comments [prIdent fun ++ " : ("
|
|
++ concat (intersperse ", " (map prIdent args))
|
|
++ ") " ++ prIdent cat] ++ ss
|
|
where
|
|
argNames = zip ["arg"++show n | n <- [0..]] args
|
|
ss = map (uncurry mkSub) argNames
|
|
mkSub a t = subdialog s [("src","#"++catFormId t),
|
|
("cond",catFieldId cat++".name == "++string (prIdent fun))]
|
|
[param "value" (catFieldId cat++"."++a),
|
|
param "callbacks" "callbacks",
|
|
filled [] [assign (catFieldId cat++"."++a) (s++"."++catFieldId t)]]
|
|
where s = prIdent fun ++ "_" ++ a
|
|
|
|
doCallback :: String -> VIdent -> [XML] -> [XML] -> XML
|
|
doCallback f cat i e =
|
|
if_else ("callbacks && " ++ cf ++ " && !" ++ cf ++ "("++string (prIdent cat)++","++ catFieldId cat ++ ")")
|
|
i e
|
|
where cf = "callbacks." ++ f
|
|
|
|
catFormId :: VIdent -> String
|
|
catFormId c = prIdent c ++ "_cat"
|
|
|
|
catFieldId :: VIdent -> String
|
|
catFieldId c = prIdent c ++ "_field"
|
|
|
|
--
|
|
-- * VoiceXML stuff
|
|
--
|
|
|
|
vxml :: String -> [XML] -> XML
|
|
vxml language = Tag "vxml" [("version","2.0"),
|
|
("xmlns","http://www.w3.org/2001/vxml"),
|
|
("xml:lang", language)]
|
|
|
|
form :: String -> [XML] -> XML
|
|
form id xs = Tag "form" [("id", id)] xs
|
|
|
|
field :: String -> [(String,String)] -> [XML] -> XML
|
|
field name attrs = Tag "field" ([("name",name)]++attrs)
|
|
|
|
subdialog :: String -> [(String,String)] -> [XML] -> XML
|
|
subdialog name attrs = Tag "subdialog" ([("name",name)]++attrs)
|
|
|
|
filled :: [(String,String)] -> [XML] -> XML
|
|
filled = Tag "filled"
|
|
|
|
vxmlGrammar :: String -> XML
|
|
vxmlGrammar uri = Tag "grammar" [("src",uri)] []
|
|
|
|
prompt :: [XML] -> XML
|
|
prompt = Tag "prompt" []
|
|
|
|
promptString :: String -> XML
|
|
promptString p = prompt [Data p]
|
|
|
|
reprompt :: XML
|
|
reprompt = Tag "reprompt" [] []
|
|
|
|
assign :: String -> String -> XML
|
|
assign n e = Tag "assign" [("name",n),("expr",e)] []
|
|
|
|
value :: String -> XML
|
|
value expr = Tag "value" [("expr",expr)] []
|
|
|
|
if_ :: String -> [XML] -> XML
|
|
if_ c b = if_else c b []
|
|
|
|
if_else :: String -> [XML] -> [XML] -> XML
|
|
if_else c t f = cond [(c,t)] f
|
|
|
|
cond :: [(String,[XML])] -> [XML] -> XML
|
|
cond ((c,b):rest) els = Tag "if" [("cond",c)] (b ++ es)
|
|
where es = [Tag "elseif" [("cond",c')] b' | (c',b') <- rest]
|
|
++ if null els then [] else (Tag "else" [] []:els)
|
|
|
|
goto_item :: String -> XML
|
|
goto_item nextitem = Tag "goto" [("nextitem",nextitem)] []
|
|
|
|
return_ :: [String] -> XML
|
|
return_ names = Tag "return" [("namelist", unwords names)] []
|
|
|
|
block :: [XML] -> XML
|
|
block = Tag "block" []
|
|
|
|
blockCond :: String -> [XML] -> XML
|
|
blockCond cond = Tag "block" [("cond", cond)]
|
|
|
|
throw :: String -> String -> XML
|
|
throw event msg = Tag "throw" [("event",event),("message",msg)] []
|
|
|
|
nomatch :: [XML] -> XML
|
|
nomatch = Tag "nomatch" []
|
|
|
|
help :: [XML] -> XML
|
|
help = Tag "help" []
|
|
|
|
param :: String -> String -> XML
|
|
param name expr = Tag "param" [("name",name),("expr",expr)] []
|
|
|
|
var :: String -> Maybe String -> XML
|
|
var name expr = Tag "var" ([("name",name)]++e) []
|
|
where e = maybe [] ((:[]) . (,) "expr") expr
|
|
|
|
script :: String -> XML
|
|
script s = Tag "script" [] [CData s]
|
|
|
|
scriptURI :: String -> XML
|
|
scriptURI uri = Tag "script" [("uri", uri)] []
|
|
|
|
--
|
|
-- * ECMAScript stuff
|
|
--
|
|
|
|
string :: String -> String
|
|
string s = "'" ++ concatMap esc s ++ "'"
|
|
where esc '\'' = "\\'"
|
|
esc c = [c]
|
|
|
|
{-
|
|
--
|
|
-- * List stuff
|
|
--
|
|
|
|
isListCat :: (VIdent, [(VIdent, [VIdent])]) -> Bool
|
|
isListCat (cat,rules) = "List" `isPrefixOf` prIdent cat && length rules == 2
|
|
&& ("Base"++c) `elem` fs && ("Cons"++c) `elem` fs
|
|
where c = drop 4 (prIdent cat)
|
|
fs = map (prIdent . fst) rules
|
|
|
|
isBaseFun :: VIdent -> Bool
|
|
isBaseFun f = "Base" `isPrefixOf` prIdent f
|
|
|
|
isConsFun :: VIdent -> Bool
|
|
isConsFun f = "Cons" `isPrefixOf` prIdent f
|
|
|
|
baseSize :: (VIdent, [(VIdent, [VIdent])]) -> Int
|
|
baseSize (_,rules) = length bs
|
|
where Just (_,bs) = find (isBaseFun . fst) rules
|
|
-} |