{"id":607,"date":"2012-10-23T14:57:58","date_gmt":"2012-10-23T09:27:58","guid":{"rendered":"http:\/\/www.cvr.cc\/?p=607"},"modified":"2012-10-23T14:57:58","modified_gmt":"2012-10-23T09:27:58","slug":"an-annotated-tex-source","status":"publish","type":"post","link":"https:\/\/cvr.cc\/?p=607","title":{"rendered":"An Annotated TeX Source"},"content":{"rendered":"

Mahesh wanted to see the annotated source of the Te<\/span>X document that generated the output shown here<\/a>. There are two components in the source:\u00a0 (1) document source, let us call it as test.tex<\/code>, (2) a custom configuration for Te<\/span>X4ht, let us call it as my.cfg<\/code>.
\n<\/p>\n

Document Source<\/h4>\n
documentclass[a4paper]{article}\n\n\\usepackage{lettrine}\n\\usepackage{lipsum,shortvrb}\n\\usepackage[utf8]{inputenc}\n\n\\MakeShortVerb{|}\n\\def\\hlink#1#2{\\Tg<a href=\"#1\">#2\\Tg<\/a>}\n\n\\begin{document}\n\n\\title{Taming TeX4ht to Support Lettrine Package}\n\n\\author{\\hlink{http:\/\/www.cvr.cc}{\\textsc{cv radhakrishnan}},\n        \\Tg<small>\\hlink{http:\/\/www.river-valley.com}{River Valley},\n        Trivandrum, \\textsc{india}\\Tg<\/small>}\n\n\\maketitle\n\n\\lettrine{T}{his code} has kindly been contributed by\n\\hlink{http:\/\/www.raphink.info\/}{Rapha\"el Pinson} and is\n\\hlink{https:\/\/github.com\/cc-translators\/sagesse\/blob\/master\/lettrine.4ht}\n{available here}. The original code was slightly modified to fit\ninto the scheme of TeX4ht.  Rapha\"el had provided eight hooks to\nre\\Configure |lettrine| which I'd reduced to seven. All the hooks are\nprovided below:\n\n\\begin{enumerate}\n \\item Before |lettrine|\n \\item After  |lettrine|\n \\item Before lettrine initial character\n \\item Between lettrine initial character and lettrine line\n \\item After lettrine line\n \\item Before lettrine ante\n \\item After lettrine ante\n\\end{enumerate}\n\n\\lettrine{F}{urther} hooks have been defined to access initial\ncharacter and lettrine line in case we want to \\Configure\n|lettrine|. |HlettrineChar| and |HlettrineString| can be used to\naccess the character and line respectively. The screenshot of this\npages as rendered in Firefox is \\hlink{lettrine.png}{available here}.\n\nHere is a bit of dummy text to fill in the page. lipsum[5-9]\n\n\\end{document}<\/pre>\n
There is nothing special to explain in the above part. \\hlink<\/code> is a
\ncustom macro with two arguments to cross-link something to a URL<\/small>. The
\npackages are popular ones and need no introduction.<\/p>\n
Custom Configuration<\/h4>\n
The custom configuration, my.cfg<\/code> has two parts — a preamble part and a post preamble part. Preamble area shall consist of three important commands:<\/p>\n
    \n
  1. \\Preamble<\/code> — beginning of preamble area.<\/li>\n
  2. \\begin{document}<\/code> — do not confuse with the begin{document}<\/code> in your document source.<\/li>\n
  3. \\EndPreamble<\/code> — end of preamble area.<\/li>\n<\/ol>\n
    \\Preamble<\/code> command shall contain all the options that are to be passed on to Te<\/span>X4ht. Options can be provided as comma separated strings. All needed Te<\/span>X packages shall be loaded before Preamble<\/code> command as shown below, where we have loaded xspace<\/code> package.<\/p>\n
    \\RequirePackage{xspace}\n\\Preamble{xhtml,NoFonts,ext=html,charset=\"utf-8\"}<\/pre>\n
    For more details about options, please see this post<\/a>.<\/p>\n
    \\Configure{PROLOG}{DOCTYPE}\n\\Configure{VERSION}{}\n\\Configure{DOCTYPE}{\\HCode{<!DOCTYPE html>\\Hnewline}}\n\\Configure{HTML}{\\HCode{<html>\\Hnewline}}{\\HCode{\\Hnewline<\/html>}}\n\\Configure{@HEAD}{}\n\\Configure{@HEAD}{\\HCode{<meta\n         \\expandafter\\csname a:charset\\endcsname\/>\\Hnewline}}\n\\Configure{@HEAD}{\\HCode{<meta name=\"generator\" content=\"TeX4ht\n         http:\/\/www.tug.org\/tex4ht\/\" \/>\\Hnewline}}\n\\Configure{@HEAD}{\\HCode{<link\n         rel=\"stylesheet\" type=\"text\/\\Css\"\n         href=\"\\expandafter\\csname aa:\\CssFile\\endcsname\" \/>\\Hnewline\n    }\n}\n\\Configure{BODY}{\\Tg<body>}{\\Tg<\/body>}\n\\begin{document}\n\\def\\hlink#1#2{\\Tg<a href=\"#1\">#2\\Tg<\/a>\\xspace}\n\\EndPreamble<\/pre>\n
    All the configuration items that are processed by Te<\/span>X4ht at the top of the document source shall be provided before the begin{document}<\/code> command that appears in the preamble area. All the elements that form part of prolog and <head><\/code> element of HTML<\/small> are the ideal candidates. Thus, PROLOG<\/code>, VERSION<\/code>, DOCTYPE<\/code>, HTML<\/code>, @HEAD<\/code> and BODY<\/code> are re-\\Configured as we want them in a different manner. In HTML<\/small> 5, we do not need DTD<\/small>, XML<\/small> version and further several meta part are more simplified, we re\\Configure these items in this part of the configuration. You might note that @HEAD<\/code> is additive, each \\Configure{@HEAD}<\/code> has one argument which will be added to the <head>...<\/head><\/code> part of the HTML<\/small>. We have inserted character set, link information for .\\Css<\/code> file, meta information relating to generator which is Te<\/span>X4ht, by re-configuring @HEAD<\/code>.<\/p>\n
    \\Configure{\\textsc}{\\Tg<span class=\"sc\">}{\\Tg<\/span>}\n\\Configure{texttt}{\\Tg<span class=\"tt\">}{\\Tg<\/span>}\n\\Configure{textbf}{\\Tg<span class=\"bf\">}{\\Tg<\/span>}\n\\Css{.sc{font-variant: small-caps;}}\n\\Css{.bf{font-weight: bold;}}\n\\Css{small{font-size: .8em;}}\n\\Css{.tt,.verb{font-family: monospace; white-space: nowrap;\n    color: #222; font-size: 85%;}}<\/pre>\n
    The above lines show a few font attributes where we have re\\Configured commands like \\textsc<\/code>, textbf<\/code>, and texttt<\/code>. The related .\\Css<\/code> declarations have been provided following the font attributes.<\/p>\n
    \\Css{body{margin-top: 2em; margin-bottom: 1em; width: 60%;\n    margin-left: auto; margin-right: auto; padding: 3em;\n    color: #444; box-shadow: 2px 2px 20px -5px #bfbfbf;\n    -webkit-box-shadow: 2px 2px 20px -8px #bfbfbf;\n    -moz-box-shadow: 2px 2px 20px -5px #bfbfbf;\n    font-family: \"EB Garamond\";\n    font-style: normal;\n    font-size: 1em; line-height: 1.3em;\n    border: 1px solid #fefeef; }}\n\\Css{p.indent{ text-indent: 0em }}<\/pre>\n
    The above provides .\\Css<\/code> declarations for <body><\/code> element with a soft gray shadow, 60% width of the window, slightly grayed text color, slightly increased line height, 3em padding on all sides, etc. Not a big deal. The text indent has been suppressed through another .\\Css<\/code> declaration, as the indent can interfere with lettrine spacing.<\/p>\n
    Our custom configuation ends here if you do not want to make use of the free web font, namely, EB Garamond created by Georg Duffner<\/a> and distributed under OFL<\/small> <\/a>font licence. The font can be had from Google or from here<\/a>. The succeeding lines are .\\Css<\/code> declarations to make use of Garamond and CheshireInitials fonts in your document.<\/p>\n
    \\Css{@font-face{font-family: InitialsFont; font-style: normal;\n    src: url\/fonts\/CheshireInitials.ttf;}}\n\\Css{@font-face{font-family: \"EB Garamond SC\"; font-variant: small-caps;\n    src: url\/fonts\/EBGaramond12-SC.ttf;}}\n\\Css{@font-face{font-family: \"EB Garamond\"; font-style: normal;\n    font-weight: normal; font-variant: normal;\n    src: url\/fonts\/EBGaramond12-Regular.ttf;}}\n\\Css{@font-face{font-family: \"EB Garamond Italic\"; font-style: italic;\n    font-weight: normal;font-variant: normal;\n    src: url\/fonts\/EBGaramond12-Italic.ttf;}}\n\\Css{@font-face{font-family: \"EB Garamond Bold\"; font-style: normal;\n    font-weight: bold; font-variant: normal;\n    src: url\/fonts\/EBGaramond12-Bold.ttf;}}\n\\Css{em, i, .ecti, .ecti1, .thanks, .signature, .dvquote-text,\n.dvprayer-text{font-family: \"EB Garamond Italic\", serif;}}\n%\n\\Css{strong, b, .partToc a, .partToc, .likepartToc a, .likepartToc,\n.chapterToc a, .chapterToc, .likechapterToc a, .likechapterToc,\n.appendixToc a, .appendixToc, .addchapToc,\n.paragraphHead, .likeparagraphHead,\n.subparagraphHead, .likesubparagraphHead,\n.caption td.id{font-family: \"EB Garamond Bold\", serif;}}\n%\n\\Css{.small-caps, .booksubtitle, .dvday, .sectionHead,\n.dvquote-ref, .dvbox .lettrine-line{font-family: \"EB Garamond SC\", serif;}}\n%\n% CheshireInitials for Lettrine character\n%\n\\Css{.lettrine{float: left; font-family: InitialsFont;\n    line-height: 1.15; margin-left: -0.1em; padding-bottom: -0.6em;\n    margin-bottom: -1em; margin-right: 0.2em;}}<\/pre>\n
    How to run Te<\/span>X4ht<\/h4>\n
    Save the above sources as test.tex<\/code> and my.cfg<\/code> respectively. Following command can be invoked from terminal:<\/p>\n
      mzlatex test my ' -cunihtf'<\/pre>\n
    The synatax is<\/p>\n
      script <tex-file> <conf-file> '<options-for-t4ht>'<\/pre>\n
    Please note the space between the opening single quote character and -cunihtf<\/code> which is very important. The sources and latest lettrine.4ht<\/code> package are available here as a zip archive<\/a>.<\/p>\n
    Enjoy the magic!<\/p>\n","protected":false},"excerpt":{"rendered":"
    Mahesh wanted to see the annotated source of the TeX document that generated the output shown here. There are two components in the source:\u00a0 (1) document source, let us call it as test.tex, (2) a custom configuration for TeX4ht, let us call it as my.cfg.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[20,26,15,16],"tags":[],"class_list":["post-607","post","type-post","status-publish","format-standard","hentry","category-annotated-source","category-lettrine","category-tex","category-tex4ht"],"_links":{"self":[{"href":"https:\/\/cvr.cc\/index.php?rest_route=\/wp\/v2\/posts\/607","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cvr.cc\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/cvr.cc\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/cvr.cc\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/cvr.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=607"}],"version-history":[{"count":0,"href":"https:\/\/cvr.cc\/index.php?rest_route=\/wp\/v2\/posts\/607\/revisions"}],"wp:attachment":[{"href":"https:\/\/cvr.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=607"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/cvr.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=607"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/cvr.cc\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=607"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}