org-publish-tutorial

1 文件导出教程,以及相关的css文件和头部文件

做好准备工作后，就可以导出了 C-c C-e 然后选择相应的格式，就可以导出对应的文件了。
导出到HTML教程
1. 借鉴了lijigang的头文件 css模板https://github.com/lijigang/org-notes-style
2. 头文件

然后在org文件的头部添加上加载头文件的语句就可以了
```
#+SETUPFILE: ~/.emacs.d/org-other-file/org-level-1.org
```
css文件地址 css文件最好是放到跟文件夹内部
直接css嵌入文件内部(我没有使用,作为备用选项)

刚开始调试本地 Emacs Org Mode 发布成网页工程时，往往容易发现 CSS 没有起到应有的效果。

因为 Emacs Org Mode 默认是采用 Web 服务器的方式来导入 CSS 文件的，其中最重要的参数，就是你设置的 Web 服务器根目录。

所以，当你需要在本地调试 Emacs Org Mode 生成的 html 页面，最好的办法是安装一个 Web 服务器，并且把 Emacs 生成的 html 页面放到这个服务器的根目录下进行调试，这样就可以避免 CSS 导入位置出错的问题了。

当然，如果只是想生成供本地阅读的 html（比如说，作为笔记使用的 org 文件，发布成 html 更方便阅读），也可以采用把 CSS 内容直接内嵌到 html 页面里的方式：

首先设置好一个变量，把 CSS 属性导入：
```
;; set the stylesheet string
(setq waterstyle "<style>
 body {
     padding: 50px 150px 50px 150px;
     border-style: solid;
     border-width: 20pt;
     border-color: #790000;
 }

 body, p, li {
         /*font-family: monospace;*/
             font-family: \"Microsoft YaHei\" ! important;
         font-size: 1em;
 }
 /* more CSS style */
              </style>")
```
然后在 org 工程设置里有关添加 CSS 的地方使用该变量，可以使用如下方式来直接把 CSS 内容加进去：
```
:style , waterstyle
```
这样，本地使用 html 页面就会变得非常舒服，不会依赖于外部的 CSS 文件。

2 批量导出文件

教程直接就是配置文件

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; -*- coding: utf-8; lexical-binding: t -*-
;;pengshao-org-publish.el---org-publish相关的配置
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

(require 'ox-publish)
(setq org-publish-project-alist
      '(
         ("psnote-org"
             :base-directory "~/public_note/"
             :base-extension "org"
             :publishing-directory "~/public_site/"
             :recursive t     ;是否递归
             :publishing-function org-html-publish-to-html  ;使用哪个函数来进行publish（注：org 7与8在这个地方有区别）
             :headline-levels 2   ;由于大纲结构也用于列表和任务,因此只有前4个级别用作标题更深的级别会被看作项目列表,我设置的2
             :auto-preamble t     ;自动前言
             :section-numbers t ;章节数字是否显示
             :author "pengshao"   ;作者
             :email "pengshao58@gmail.com"   ;邮箱
             :auto-sitemap t                  ; 自动生成 sitemap.org 文件
             :sitemap-filename "sitemap.org"  ; ... call it sitemap.org (it's the default)...
             :sitemap-title "PengShao's BLOG!"         ; ... with title
             ;;:sitemap-file-entry-format "%d %t"   ;这里采用时间+标题的方式生成sitemap 
             :style-include-default nil  ;禁用默认 css 样式,使用自定义css

             ;作为一个字符串给予 html-head 变量并插入到生成的 html 文件的head部
             ;因此里面的某些字符必须避免转义，比如双引号必须加上反斜杠
             ;href 的赋值不会做如何转换，因此必须确保是在生成的 html 文件能够访问的绝对路径。
             ;html-home/up-format"<div id=\"org-div-home-and-up\"> <a accesskey=\"h\" href=\"/home/index.html\"> UP </a> | <a accesskey=\"H\" href=\"/home/index.html\"> HOME </a></div>"
             ;html-head "<link rel=\"stylesheet\" type=\"text/css\" href=\"/home/css/org.css\"/>"
             :html-postamble "<script async src=\"https://www.googletagmanager.com/gtag/js?id=UA-164487790-1\"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'UA-164487790-1'); </script>"

         )



         ("psnote-static"
             :base-directory "~/public_note/"
             :base-extension "css\\|js\\|png\\|jpg\\|gif\\|pdf\\|mp3\\|ogg\\|swf\\|sh\\|el\\|jpeg\\|html"
             :publishing-directory "~/public_site/"
             :recursive t
             :publishing-function org-publish-attachment
          )


         ("psnote" :components ("psnote-org" "psnote-static"))


        ))


(define-key global-map "\C-cp" 'org-publish)




(provide 'pengshao-org-publish)

3 批量到处文件跳过未修改设置方法(在基本完善了之后,不太需要了,现在用不太到了)

本来认为org只发布修改过的文件是它对比了org文件和导出文件的时间戳。后来我把导出文件删除，又重新发布。发现都跳过了，并没有重新导出文件，可见它并没有对比org文件和导出文件的时间戳后来在家目录下发现了一个目录.org-timestamps 原来所有的东西都在这里放着想不改变org文件而重新导出html等文件可以把这个目录删除，然后现重新发布。
或者直接暴力的 C-u M-x org-purblish 这样也是可以的
Orgmode 发布项目缓存说明在使用 Orgmode 进行 M-x org-publish-project 来进行将 org 文件导出为项目时，发现它会有缓存，即如果 org 文件没有再修改过，它就不会再生成该文件相应的 HTML 文件了。

参数
1. org-publish-use-timestamps-flag 1 (可通过 C-h v 变量名来查看变量的说明及设置) 这个在第一次时可以看到，设置过之后就看不到了。( 我的环境是 Mac+Emacs25.1 )，它显示是否使用时间戳来埋发布。这个就是导致缓存的原因。即对应的文件的的修改时间戳要比它新才会进行发布。
2. org-publish-timestamp-directory 这个就是保存时间戳文件的缓存目录。（删除该目录下的所有文件，即可进行全量重新发布）

4 清除上下标的设置

导出时如果需要目录(类似本文开头), 要在org文件的开头出添加metadata. 默认情况下org-mode会把^, _, []等字符当做latex中的上标,下标和脚注如果不想让org-mode误会, 也要在metadata中注明. 于是, 每次写笔记时, 开头就要加一行

#+OPTIONS: ^:nil _:nil f:nil toc:t

5 导出的html不显示目录

一般文字文章我不喜欢导出html文章不显示目录，toc 选项设置为 nil

6 主页的设置(据说和低版本有区别,我最初用的教程是低版本的,各种错误.)

配置文件选项设置

:auto-sitemap t
:sitemap-filename "sitemap.org"  ; ... call it sitemap.org ...
:sitemap-title "Sitemap"         ; ... with title 'Sitemap'.

然后每次发布这个工程的时候，就会生成一个 sitemap.org 的文件，这个文件会递归地遍历你工程里的所有文件并生成链接，并会生成一个名叫 sitemap.html 的文件。
然后，我们只要在我们的 index.org 里 include 这个文件即可：
```
#+INCLUDE: sitemap.org
```
这样我们就再也不用手动添加页面的索引链接了。
我们可以在每个页面的页脚里把这个 sitemap.org 的链接给加上，方便随手访问这个索引。