Formate um papel HTML com o modo Org


11

O padrão do modo organizacional durante a exportação de HTML é colocar o autor no postamble na parte inferior da página.

Mas eu gostaria de exportar um documento como um documento com o autor entre o título e o resumo. É possível, de alguma forma, colocar o autor após o título?

E é possível rotular o resumo como abstrato? Eu usei os delimitadores

#+BEGIN_abstract
...
#+END_abstract

para marcar o texto como abstact, mas é renderizado como um parágrafo normal (sem aspas como recuo). É possível obter o recuo correto para o resumo e um rótulo localizado?


2
Para os requisitos abstratos, use css. ...será embrulhado como <div class="abstract"><p>...</p></div>. Para ter um título semelhante ao LaTeX, talvez você deva preencher um relatório de bug. Por enquanto, use a macro {{{AUTHOR}}}e os trechos @@html:whatever@@para criar o que deseja.
rasmus

Respostas:


10

Talvez algo assim (testado com LaTeX e HTML)

#+TITLE: An Orged Paper
#+AUTHOR: Rasmus
#+DATE: A Dark Day for Science 

#+RESULTS: html-header

#+begin_abstract
#+begin_center
{{{html-only(*Abstract*)}}}
#+end_center
my long abstract that is longer than one line. my long abstract that is longer than one line.
#+end_abstract
#+toc: headlines
* Introduction
Please read my paper!
* Data
~{0,1}~
* Conclusion
Something deep and profound

{{{html-only(------------)}}}
* styles                                                           :noexport:
#+HTML_HEAD_EXTRA: <style type="text/css">
#+HTML_HEAD_EXTRA: <!--
#+HTML_HEAD_EXTRA:   .header_title {font-size: 2em; font-weight: bold;}
#+HTML_HEAD_EXTRA:   .header_author {font-size: 1.5em; font-weight: bold;text-align:center;}
#+HTML_HEAD_EXTRA:   .header_date {text-align:center;}
#+HTML_HEAD_EXTRA:   .header_date .timestamp {font-size:1em; color:#000000;}
#+HTML_HEAD_EXTRA:   .abstract {max-width: 30em; margin-left: auto; margin-right: auto;}
#+HTML_HEAD_EXTRA: -->
#+HTML_HEAD_EXTRA: </style>

#+OPTIONS: toc:nil

#+MACRO: html-only (eval (if (org-export-derived-backend-p org-export-current-backend 'html) "$1" ""))

#+NAME: html-header
#+BEGIN_SRC emacs-lisp :results raw :exports (if (org-export-derived-backend-p org-export-current-backend 'html) "results" "none")
  "#+begin_header
  ,#+begin_header_author
  {{{AUTHOR}}}
  ,#+end_header_author
  ,#+begin_header_date
  {{{DATE}}}
  ,#+end_header_date
  ,#+end_header
"
#+END_SRC

Observe que o html-headertambém pode ser gerado via org-html-preamble. Observe também que from org 8.3 org-latex-title-commandpode ser usado para personalizar o título como uma string de formato.


2

Dê uma olhada no código fonte, parece que não há opção para fazer isso.

Não sei o que você realmente deseja, apenas forneça duas maneiras possíveis:

  1. Basta adicionar um #+BEGIN_HTML ... #+END_HTMLbloco para escrever o que você deseja. (O conteúdo escrito nele será tratado como totalmente HTML.) Mas pode ser necessário adicionar #+OPTIONS: toc: nilpara desativar o sumário ou o autor será colocado no sumário.

  2. Redefina a função de exportação e faça o que quiser (linha de aviso 50 ~ 52), basta colocar o seguinte código depois (require 'ox-html)no seu arquivo de configuração:

      (defun org-html-template (contents info)
        "Return complete document string after HTML conversion.
      CONTENTS is the transcoded contents string.  INFO is a plist
      holding export options."
        (concat
         (when (and (not (org-html-html5-p info)) (org-html-xhtml-p info))
           (let ((decl (or (and (stringp org-html-xml-declaration)
                  org-html-xml-declaration)
                 (cdr (assoc (plist-get info :html-extension)
                     org-html-xml-declaration))
                 (cdr (assoc "html" org-html-xml-declaration))
    
                 "")))
             (when (not (or (eq nil decl) (string= "" decl)))
         (format "%s\n"
             (format decl
                 (or (and org-html-coding-system
                      (fboundp 'coding-system-get)
                      (coding-system-get org-html-coding-system 'mime-charset))
                     "iso-8859-1"))))))
         (org-html-doctype info)
         "\n"
         (concat "<html"
           (when (org-html-xhtml-p info)
             (format
              " xmlns=\"http://www.w3.org/1999/xhtml\" lang=\"%s\" xml:lang=\"%s\""
              (plist-get info :language) (plist-get info :language)))
           ">\n")
         "<head>\n"
         (org-html--build-meta-info info)
         (org-html--build-head info)
         (org-html--build-mathjax-config info)
         "</head>\n"
         "<body>\n"
         (let ((link-up (org-trim (plist-get info :html-link-up)))
         (link-home (org-trim (plist-get info :html-link-home))))
           (unless (and (string= link-up "") (string= link-home ""))
             (format org-html-home/up-format
               (or link-up link-home)
               (or link-home link-up))))
         ;; Preamble.
         (org-html--build-pre/postamble 'preamble info)
         ;; Document contents.
         (format "<%s id=\"%s\">\n"
           (nth 1 (assq 'content org-html-divs))
           (nth 2 (assq 'content org-html-divs)))
         ;; Document title.
         (let ((title (plist-get info :title)))
           (format "<h1 class=\"title\">%s</h1>\n" (org-export-data (or title "") info)))
         ;; Author
         (let ((author (plist-get info :author)))
           (format "<h2 class=\"author\">%s</h2>\n" (org-export-data (or author "") info)))
         contents
         (format "</%s>\n"
           (nth 1 (assq 'content org-html-divs)))
         ;; Postamble.
         (org-html--build-pre/postamble 'postamble info)
         ;; Closing document.
         "</body>\n</html>"))        
    

3
Este é absolutamente o caminho errado para isso! De preferência, você precisa criar um backup derivado, ver org-export-define-derived-backende adicionar o novo modelo ao :translate-alist. Para exemplos concretos ox-beamer.el, verifique ox-koma-script.ele , por exemplo ox-s5.el.
rasmus

1

O problema mais difícil que me deparei com isso é o estilo condicional de seções diferentes e a numeração condicional de seções diferentes. Esta é uma solução para esses dois problemas.

Aqui está o meu artigo:

#+TITLE: Complex Tracking of Awesome Things
#+AUTHOR: Bastibe
#+INCLUDE: style.org

* Abstract
:PROPERTIES:
:NUMBERS: no
:HTML_CONTAINER_CLASS: abstract
:END:

Lorem ipsum dolor sit amet...

* Introduction
:PROPERTIES:
:NUMBERS: no
:END:

* Methodology

* Results

* Conclusion

* Acknowledgements
:PROPERTIES:
:NUMBERS:  no
:END:

Primeiro, isso inclui um arquivo organizacional com algumas opções adicionais. Esse arquivo, chamado style.orgacima, define a exportação HTML para carregar uma folha de estilos personalizada e define algumas opções do LaTeX. Se você não estiver exportando para o LaTeX, não precisará deles.

#+LANGUAGE: en
#+OPTIONS: tags:nil html-postamble:nil # toc:nil
#+STARTUP: nofold hideblocks
#+BIND: org-latex-title-command ""

#+HTML_MATHJAX: path:"MathJax/MathJax.js"
#+HTML_HEAD: <link rel="stylesheet" type="text/css" href="style.css" />

#+LATEX_CLASS: article
#+LATEX_CLASS_OPTIONS: [a4paper, 12pt]
#+LATEX_HEADER: \usepackage{setspace}
#+LATEX_HEADER: \onehalfspacing
#+LATEX_HEADER: \usepackage{fontspec}
#+LATEX_HEADER: \setmainfont{Cambria}
#+LATEX_HEADER: \setmonofont{PragmataPro}
#+LATEX_HEADER: \usepackage{polyglossia}
#+LATEX_HEADER: \setdefaultlanguage{english}
#+LATEX_HEADER: \usepackage[a4paper, scale=0.8]{geometry}
#+LATEX_HEADER: \usepackage{amsmath}
#+LATEX_HEADER: \usepackage{units}
#+LATEX_HEADER: \usepackage{titling}
#+LATEX_HEADER: \usepackage{listings}
#+LATEX_HEADER: \lstset{basicstyle=\ttfamily\footnotesize,showstringspaces=false}
#+LATEX_HEADER: \usepackage[hang]{caption}

Para renderizar isso como HTML em formato de papel, basta um pouco de CSS (salvo em style.css:

#content {
    max-width: 80ex;
    position: relative;
    margin: 5px auto;
    font-family: Cambria;
    text-align: justify;
    -moz-hyphens: auto;
}

.abstract {
    max-width: 65ex;
    margin: 5px auto;
    margin-top: 4em;
    margin-bottom: 4em;
    content: none;
}

p {
    text-indent: 5ex;
    margin-bottom: 0;
    margin-top: 0;
}

No entanto, os números das seções estarão incorretos. O modo organizacional pode numerar todas as seções ou nenhuma. Os documentos normalmente precisam de números nas seções do corpo, mas não no Resumo e no Resumo. O seguinte trecho de código fará com que a organização coloque números na frente de seções regulares, mas suprime os números se a propriedade :NUMBERS: noestiver definida:

(defun headline-numbering-filter (data backend info)
  "No numbering in headlines that have a property :numbers: no"
  (let* ((beg (next-property-change 0 data))
         (headline (if beg (get-text-property beg :parent data))))
    (if (string= (org-element-property :NUMBERS headline) "no")
        (cond ((eq backend 'latex)
               (replace-regexp-in-string
                "\\(part\\|chapter\\|\\(?:sub\\)*section\\|\\(?:sub\\)?paragraph\\)"
                "\\1*" data nil nil 1))
              ((eq backend 'html)
               (replace-regexp-in-string
                "\\(<h[1-6]\\)\\([^>]*>\\)"
                "\\1 class=\"nonumber\"\\2" data nil nil)))
      data)))

(setq org-export-filter-headline-functions '(headline-numbering-filter))

Isso funciona bem para a exportação LaTeX, mas não na exportação HTML. Com o CSS moderno, os navegadores podem fazer a numeração para você (anexado a style.css):

/* do not show section numbers */
span.section-number-2 { display: none; }
span.section-number-3 { display: none; }
span.section-number-4 { display: none; }
span.section-number-5 { display: none; }
span.section-number-6 { display: none; }

/* use LaTeX-style names for the counters */
h1 { counter-reset: section; }
h2 { counter-reset: subsection; }
h3 { counter-reset: subsubsection; }
h4 { counter-reset: paragraph; }
h5 { counter-reset: subparagraph; }

.nonumber::before { content: none; }

h2::before {
    content: counter(section) " ";
    counter-increment: section;
}

h3::before {
    content: counter(section) "." counter(subsection) " ";
    counter-increment: subsection;
}

h4::before {
    content: counter(section) "." counter(subsection) "." counter(subsubsection) " ";
    counter-increment: subsubsection;
}

h5::before {
    content: counter(section) "." counter(subsection) "." counter(subsubsection) "." counter(paragraph) " ";
    counter-increment: paragraph;
}

h6::before {
    content: counter(section) "." counter(subsection) "." counter(subsubsection) "." counter(paragraph) "." counter(subparagraph) " ";
    counter-increment: subparagraph;
}

Com isso, você pode exportar seu papel para o LaTeX e o HTML.


"O modo organizacional pode numerar todas as seções ou nenhuma ." Uhm, que tal passar a propriedade UNNUMBERED: tpara uma manchete? De ORG-NEWS: Os títulos, para os quais a propriedade UNNUMBEREDé nula, agora são exportados sem números de seção, independentemente de seus níveis. A propriedade é herdada por filhos.
rasmus

@rasmus isso é incrível! No entanto, tanto quanto posso dizer, isso foi introduzido apenas no modo org 8.3, que ainda não foi lançado.
bastibe

É implementado no master e funciona em todos os back-ends. A organização 8.3 está à porta. O fato de não ter sido lançado significa que é o momento perfeito para testá-lo e publicar relatórios de erros (conforme necessário)!
rasmus
Ao utilizar nosso site, você reconhece que leu e compreendeu nossa Política de Cookies e nossa Política de Privacidade.
Licensed under cc by-sa 3.0 with attribution required.