6 创建和管理 Muse 项目

通常你希望自动将一个目录中的所有文件发布为一组特定的输出风格，为此， Muse 允许创建“项目”。下面是一个定义在你的 .emacs 文件中的项目范例。

     (require 'muse-project)
     
     (setq muse-project-alist
           '(("website"			; my various writings
              ("~/Pages" :default "index")
              (:base "html" :path "~/public_html")
              (:base "pdf" :path "~/public_html/pdf"))))

上面定义了一个名为“website”的项目，该项目所有的文件都位于目录 ~/Pages 下，默认的访问页为 index。当该项目被发布时，每一页 将会以 HTML 格式输出到 ~/public_html 目录中，并以 PDF 格式输出到 ~/public_html/pdf 目录中。在项目中的任一页中，你可以使用语法 `[[pagename]]' 创建到其他页的链接。

默认情况下 Muse 要求所有的项目文件具有扩展名 .muse，不具有这个扩展名 的文件将不会被关联到 Muse 模式，也将不会被看作任何项目的一部分，即使这些 文件确确实实在一个项目目录中。

如果你不想使用扩展名 .muse，你可以通过设置 muse-file-extension 的值来自定义扩展名。

如果你不想使用任何扩展名，而是想要 Muse 基于项目文件位置自动探测项目文件， 那么在你的 Muse 设置文件中加入下面两行。

     (setq muse-file-extension nil
           muse-mode-auto-p t)

如果你想要仅仅包括一个目录中的几个文件，那么你需要使用一个正则表达式代替 例子中的 ~/Pages。