Отформатируйте HTML-документ в режиме Org

11

По умолчанию в режиме экспорта по умолчанию в орг-режиме автор помещается в виде поста в нижней части страницы.

Но я хотел бы экспортировать бумажный документ с автором между заголовком и рефератом. Можно ли как-нибудь разместить автора после заголовка?

И можно ли пометить реферат как реферат? Я использовал разделители

#+BEGIN_abstract
...
#+END_abstract

пометить текст как реферат, но он отображается как обычный абзац (без цитаты, как отступ). Можно ли получить правильный отступ для абстрактного и локализованного ярлыка?

ceving
источник
2
Для абстрактных требований используйте css. ...будет упакован как <div class="abstract"><p>...</p></div>. Чтобы иметь название, похожее на LaTeX, возможно, вам следует заполнить отчет об ошибке. А пока используйте макрос {{{AUTHOR}}}и фрагменты, @@html:whatever@@чтобы построить то, что вы хотите.
Расм

Ответы:

10

Может быть что-то вроде этого (протестировано с LaTeX и 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

Обратите внимание, что html-headerтакже может быть сгенерировано через org-html-preamble. Также обратите внимание, что from org 8.3 org-latex-title-commandможет использоваться для настройки заголовка как строки формата.

Расмус
источник
2

Взгляните на исходный код, кажется, что нет возможности сделать это.

Я не уверен, что вы действительно хотите, просто укажите два возможных способа:

  1. Просто добавьте #+BEGIN_HTML ... #+END_HTMLблок, чтобы написать то, что вы хотите. (Содержимое, написанное в нем, будет обрабатываться как полностью HTML.) Но вам может потребоваться добавить #+OPTIONS: toc: nilотключение оглавления, иначе автор будет помещен в оглавление.

  2. Переопределите функцию экспорта и делайте что хотите (обратите внимание на строки 50 ~ 52), просто поместите следующий код после (require 'ox-html)в ваш файл конфигурации:

      (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>"))        
    
kuanyui
источник
3
Это абсолютно неправильный способ к этому !! Желательно, чтобы вы создали производную копию, увидели org-export-define-derived-backendи добавили новый шаблон в :translate-alist. Для конкретных примеров проверьте ox-beamer.el, ox-koma-script.elи, например ox-s5.el.
Расмус
1

Самая сложная проблема, с которой я столкнулся, - это условное оформление различных разделов и условная нумерация различных разделов. Это решение для обеих этих проблем.

Вот моя статья:

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

Прежде всего, это включает в себя файл org с некоторыми дополнительными опциями. Этот файл, названный style.orgвыше, устанавливает экспорт HTML для загрузки пользовательской таблицы стилей и устанавливает несколько параметров LaTeX. Если вы не экспортируете в LaTeX, вам это не понадобится.

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

Чтобы отобразить это как бумажный HTML, достаточно немного CSS (сохранено в 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;
}

Однако номера разделов будут неправильными. Режим Org может содержать нумерацию всех разделов или ни одного. Бумаги, как правило, нуждаются в цифрах в разделах тела, но не в Резюме и Резюме. Следующий фрагмент кода заставит Org ставить числа перед регулярными секциями, но подавлять числа, если свойство :NUMBERS: noустановлено:

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

Это хорошо работает для экспорта LaTeX, но не для экспорта HTML. С помощью современного CSS браузеры могут сделать нумерацию за вас (добавлено 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;
}

Благодаря этому вы можете экспортировать вашу статью как в LaTeX, так и в HTML.

bastibe
источник
« Режим Org может содержать нумерацию всех разделов или ни одного ». Хм, а как насчет передачи собственности UNNUMBERED: tв заголовок? Из ORG-NEWS: заголовки, для которых свойство не UNNUMBEREDравно нулю, теперь экспортируются без номеров разделов, независимо от их уровней. Собственность наследуется детьми.
Расм
@rasmus, это круто! Однако, насколько я могу судить, это было введено только в org-mode 8.3, который еще не выпущен.
Бастиб
Он реализован в мастере и работает на всех бэкэндах. Орг 8,3 находится на пороге. То, что он не был выпущен, означает, что это идеальное время для его тестирования и публикации отчетов об ошибках (при необходимости)!
Расм