Formatta un documento HTML con la modalità Org


11

L'impostazione predefinita della modalità Org durante l'esportazione HTML è di mettere l'autore nel postambolo nella parte inferiore della pagina.

Ma vorrei esportare un documento come un documento con l'autore tra il titolo e l'abstract. È possibile in qualche modo posizionare l'autore dopo il titolo?

Ed è possibile etichettare l'abstract come un abstract? Ho usato i delimitatori

#+BEGIN_abstract
...
#+END_abstract

per contrassegnare il testo come abstact ma viene visualizzato come un normale paragrafo (senza virgolette come il rientro). È possibile ottenere il rientro giusto per l'abstract e un'etichetta localizzata?


2
Per i requisiti astratti utilizzare css. ...sarà avvolto come <div class="abstract"><p>...</p></div>. Per avere un titolo LaTeX come forse dovresti compilare una segnalazione di bug. Per ora usa la macro {{{AUTHOR}}}e i frammenti @@html:whatever@@per creare quello che vuoi.
rasmus

Risposte:


10

Forse qualcosa del genere (testato con 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

Si noti che html-headerpotrebbe anche essere generato tramite org-html-preamble. Si noti inoltre che da org 8.3 org-latex-title-commandpuò essere utilizzato per personalizzare il titolo come una stringa di formato.


2

Dai un'occhiata al codice sorgente, sembra che non ci sia alcuna opzione per farlo.

Non sono sicuro di quello che vuoi davvero, basta fornire due possibili modi:

  1. Aggiungi un #+BEGIN_HTML ... #+END_HTMLblocco per scrivere quello che vuoi. (Il contenuto in esso scritto verrà trattato come totalmente HTML.) Ma potrebbe essere necessario aggiungere #+OPTIONS: toc: nilper disabilitare il sommario o l'autore verrà inserito nel sommario.

  2. Ridefinisci la funzione di esportazione e fai quello che vuoi (nota la riga 50 ~ 52), inserisci il seguente codice (require 'ox-html)nel tuo file di configurazione:

      (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
Questo è assolutamente il modo sbagliato per farlo !! Preferibilmente, è necessario creare un supporto derivato, vedere org-export-define-derived-backende aggiungere il nuovo modello a :translate-alist. Per esempi concreti ox-beamer.el, controllare ox-koma-script.ele ad es ox-s5.el.
rasmus

1

Il problema più difficile che ho riscontrato in questo è lo stile condizionale di diverse sezioni e la numerazione condizionale di diverse sezioni. Questa è una soluzione per entrambi questi problemi.

Ecco il mio documento:

#+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:

Innanzitutto, questo include un file org con alcune opzioni aggiuntive. Questo file, chiamato style.orgsopra, imposta l'esportazione HTML per caricare un foglio di stile personalizzato e imposta alcune opzioni LaTeX. Se non esporti in LaTeX, non ti serviranno.

#+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}

Per renderlo come HTML simile alla carta, è sufficiente un po 'di CSS (salvato in 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;
}

Tuttavia, i numeri di sezione saranno errati. La modalità Org può numerare tutte le sezioni o nessuna. Le carte in genere hanno bisogno di numeri sulle sezioni del corpo, ma non dell'estratto e del sommario. Il seguente pezzo di codice farà in modo che Org metta i numeri davanti alle sezioni regolari, ma sopprimili se la proprietà :NUMBERS: noè impostata:

(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))

Funziona bene per l'esportazione LaTeX, ma non per l'esportazione HTML. Con i CSS moderni, i browser possono eseguire la numerazione per te (aggiunto 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;
}

Con ciò, puoi esportare la tua carta su LaTeX e HTML.


"La modalità Org può numerare tutte le sezioni o nessuna ." Uhm, che ne dici di passare la proprietà UNNUMBERED: ta un titolo? Da ORG-NEWS: i titoli, per i quali la proprietà UNNUMBEREDè diversa da zero, vengono ora esportati senza numeri di sezione indipendentemente dai loro livelli. La proprietà è ereditata dai bambini.
rasmus

@rasmus è fantastico! Tuttavia, per quanto posso dire, questo è stato introdotto solo in modalità org 8.3, che non è ancora stato rilasciato.
bastibe,

È implementato in master e funziona su tutti i backend. Org 8.3 è a portata di mano. Il fatto che non sia stato rilasciato significa che è il momento perfetto per testarlo e pubblicare segnalazioni di bug (se necessario)!
rasmus
Utilizzando il nostro sito, riconosci di aver letto e compreso le nostre Informativa sui cookie e Informativa sulla privacy.
Licensed under cc by-sa 3.0 with attribution required.