{"id":682,"date":"2013-07-31T09:12:03","date_gmt":"2013-07-31T09:12:03","guid":{"rendered":"http:\/\/www.cvr.cc\/?p=682"},"modified":"2013-07-31T09:12:03","modified_gmt":"2013-07-31T09:12:03","slug":"tex4ht-and-multicolumn-layout","status":"publish","type":"post","link":"https:\/\/cvr.cc\/?p=682","title":{"rendered":"TeX4ht and Multicolumn Layout"},"content":{"rendered":"

Nasser M. Abbassi<\/a> had filed a feature request at Te<\/span>X4ht<\/a> project for multicolumn support in Te<\/span>X4ht which is lacking at the moment. This link<\/a> provides the latest specifications of W3C<\/a> relating to multicolumn layout in HTML which some of the mainstream browsers support in varying degrees. Our initial efforts are pointed towards multicol<\/code> package so that Te<\/span>X4ht provides enough hooks to generate output with multicolumn layout as envisaged in LA<\/span>TE<\/span>X<\/span><\/span> by multicol<\/code> package. Support for \\twocolumn<\/code> still remains to be done, though.<\/p>\n

<\/p>\n

Approach to the Problem<\/h4>\n

<\/a><\/p>\n

W3C provides different kinds of CSS properties to bring about multicolumn layout in HTML. These are briefly listed below:<\/p>\n

    \n
  1. column-count<\/code>: number of columns<\/li>\n
  2. column-width<\/code>: width of the columns<\/li>\n
  3. column-gap<\/code>: gap between columns<\/li>\n
  4. column-rule-color<\/code>: color of separator rule<\/li>\n
  5. column-rule-width<\/code>: width of separator rule<\/li>\n
  6. column-rule-style<\/code>: style of separator rule<\/li>\n
  7. column-span<\/code>: should the entry span all columns<\/li>\n
  8. column-fill<\/code>: should the multicolumn layout be balanced or ragged<\/li>\n
  9. column-break<\/code>: directive for breaks in print media<\/li>\n<\/ol>\n

    We have more or less equivalent commands in multicol<\/code> package and are listed below:<\/p>\n

      \n
    1. \\columnbreak<\/code>: forced break in a column<\/li>\n
    2. \\columnsep<\/code>: gap between columns<\/li>\n
    3. \\columnseprule<\/code>: rule width<\/li>\n
    4. \\columnseprulecolor<\/code>: rule color<\/li>\n
    5. \\flushcolumns<\/code>: balanced columns<\/li>\n
    6. \\raggedcolumns<\/code>: unbalanced columns<\/li>\n
    7. \\begin{multicols}{<num>}<\/code>: beginning of multicolumn enviromnemt<\/li>\n
    8. \\end{multicols}<\/code>: end of multicolumn environment<\/li>\n
    9. \\multicoltolerance<\/code>: no effect on HTML output<\/li>\n<\/ol>\n

      Some of the CSS properties do not have equivalent commands in multicol<\/code> package. For instance, column-width<\/code> can be specified in CSS as either auto<\/code> or as a legal dimension, but in multicol<\/code>, it is always automatically computed. Hence, we can safely ignore such properties. Conversely, certain multicol<\/code> commands like \\multicoltolerance<\/code> has no effect in HTML, so we can ignore such commands in the source documents.<\/p>\n

      We have written the multicol.4ht<\/code> to redefine the related multicol<\/code> commands to generate the equivalent CSS properties for HTML output so that multicolumn layout is visually similar to PDF output.<\/p>\n

      Usage<\/h4>\n

      <\/a><\/p>\n

      The multicolumn layout can be tailored using \\Configure<\/code> command on various items as given below:<\/p>\n

      \n\\Configure{columngap}{\\thecolumnsep}\n<\/pre>\n
      <\/p>\n
      <\/code><\/p>\n
      \\columngap<\/code> will default to the dimension provided by multicol<\/code>’s \\columnsep<\/code> command. However, if you want to override, you can make use of the above command. The legal values admissible are any valid \\dimen<\/code> or simply \\normal<\/code> which is considered to be 1em.<\/p>\n
      \n\\Configure{columnrulewidth}{\\thecolumnseprule}\n<\/pre>\n
      <\/p>\n
      <\/code><\/p>\n
      \\columnrulewidth<\/code> defaults to LA<\/span>TE<\/span>X<\/span><\/span> dimension provided by \\columnseprule<\/code> which can be overridden by the above command. The legal values are thin | medium | thick<\/code> or any valid dimension.<\/p>\n
      \n\\Configure{columnrulecolor}{#555;}\n<\/pre>\n
      You can specify any valid color for \\columnrulecolor<\/code>. Default is provided above.<\/p>\n
      \n\\Configure{columnrulestyle}{outset}\n<\/pre>\n
      <\/p>\n
      <\/code><\/p>\n
      \\columnrulestyle<\/code> has no equivalent in multicol<\/code>. Specify rule style with the above hook. Legal values are provided below: none<\/code>, hidden<\/code>, dotted<\/code>, dashed<\/code>, solid<\/code>, double<\/code>, groove<\/code>, ridge<\/code>, inset<\/code>, outset<\/code>,<\/p>\n
      \n\\Configure{columnspan}{none}\n<\/pre>\n
      <\/p>\n
      <\/code><\/p>\n
      \\columnspan<\/code> has no equivalent command in multicol<\/code>. This is to provide CSS directive of any column spanning all the columns, the default value being none<\/code>. Alternate value is all<\/code>.<\/p>\n
      \n\\Configure{columnfill}{balance}\n<\/pre>\n
      <\/p>\n
      <\/code><\/p>\n
      \\columnfill<\/code> does the job what \\raggedcolumns<\/code> and \\flushcolumns<\/code> do in multicol<\/code>. balance<\/code>, meaning, balanced columns is the default value, the other being auto<\/code>.<\/p>\n
      \n\\Configure{multicols}{columns}\n<\/pre>\n
      This command provides the name of class attribute of the multicolumn chunk of text. You can assign any string of your choice, the default is columns<\/code>.<\/p>\n
      Example<\/h4>\n
      <\/a>Here is an example of a working document that can be used to test these newly introduced features.<\/p>\n
      \n\\documentclass[a4paper]{article}\n\\usepackage{xspace}\n\\usepackage{lipsum}\n\\usepackage[margin=1cm,ignoreall]{geometry}\n\\usepackage{multicol}\n\\columnseprule=.1pt\n\\columnsep=1em\n\n\\begin{document}\n\n\\parindent=0pt\n% For webkit browsers Chrome, for example,\n% kindly remove comment marks from two lines below:\n%\n% \\Configure{columnrulecolor}{#000;}\n% \\Configure{columnrulewidth}{1px}\n\n\\title{Support for Multicolumn Layout in TeX4ht}\n\\author{TeX4ht Project Team}\n\\maketitle\n\n\\lipsum[1]\n\\begin{multicols}{2}[section{Testing the Section Heading}]\n\\lipsum[2-8]\n\\end{multicols}\n\\lipsum[1]\n\\begin{multicols}{3}[section{Three Column Layout}]\n\\lipsum[2-8]\n\\end{multicols}\n\\lipsum[1]\n\\begin{multicols}{4}[section{Four Column Layout}]\n\\lipsum[2-8]\n\\end{multicols}\n\\lipsum[1]\n\\ifx\\HCode\\undefined\\raggedright\\fi\n\\begin{multicols}{11}[section{More Than Ten Columns limit of\n    multicol package}]\n\\lipsum[2-8]\n\\end{multicols}\n\n\\end{document}\n<\/pre>\n
      The HTML output can be viewed here<\/a>.<\/p>\n
      A tarball of all required *.4ht<\/code> files, source, auxiliary and output files can be downloaded from here<\/a>.<\/p>\n
      W3C References<\/h4>\n
      <\/a><\/p>\n
      More detailed information is available at Property Index<\/a> page provided at Word Wide Web Consortium web site. (Generated by Org mode 8.0.6 in Emacs 24.3.1.)<\/p>\n","protected":false},"excerpt":{"rendered":"
      Nasser M. Abbassi had filed a feature request at TeX4ht project for multicolumn support in TeX4ht which is lacking at the moment. This link provides the latest specifications of W3C relating to multicolumn layout in HTML which some of the mainstream browsers support in varying degrees. Our initial efforts are pointed towards multicol package so […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[28,15,16],"tags":[],"class_list":["post-682","post","type-post","status-publish","format-standard","hentry","category-multicolumn","category-tex","category-tex4ht"],"_links":{"self":[{"href":"https:\/\/cvr.cc\/index.php?rest_route=\/wp\/v2\/posts\/682","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=682"}],"version-history":[{"count":0,"href":"https:\/\/cvr.cc\/index.php?rest_route=\/wp\/v2\/posts\/682\/revisions"}],"wp:attachment":[{"href":"https:\/\/cvr.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=682"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/cvr.cc\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=682"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/cvr.cc\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=682"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}