leiningen构建工具的project.clj配置

英文不大好，给自己做个参考。错误肯定存在。
英文地址：https://github.com/technomancy/leiningen/blob/master/sample.project.clj

;;================================================================================
;;这是一个包含注释的project.clj文件。
;;包含了所有选项。可以视为一个配置样本。
;;包含了比”lein帮助教程”更详细的注释
;;================================================================================

;; 这是一个项目名叫 "sameple" 
;; 组名(或者公司网站名之类的，group-id)叫 "org.example"
;; 版本(version)为"1.0.0-SNAPSHOT"的项目（project）
(defproject org.example/sample "1.0.0-SNAPSHOT" 
  ;;除了这一点，你可能前面加上反引号（unquote），或~，对它求值（eval）。（这个注释不是我也不是很明白）

  ;; 这个描述文本有助于仓库搜索（比如clojars仓库）
  :description "A sample project"
  
  :url "http://example.org/sample-clojure-project"
  
  ;;邮件列表。没啥好说的
  :mailing-list {:name "sample mailing list"
                 :archive "http://example.org/sample-mailing-list-archives"
                 :other-archives ["http://example.org/sample-list-archive2"
                                  "http://example.org/sample-list-archive3"]
                 :post "[e-mail]"
                 :subscribe "[e-mail]"
                 :unsubscribe "[e-mail]"}
  
  ;;license这个也没啥好说的
  :license {:name "Eclipse Public License - v 1.0"
            :url "http://www.eclipse.org/legal/epl-v10.html"
            :distribution :repo
            :comments "same as Clojure"}
  
  ;;依赖的格式类似：[group-id/project-name version]
  ;; classifier ：它表示在相同版本下针对不同的环境或者jdk使用的jar,如果配置了这个元素，则会将这个元素名在加在最后来查找相应的jar
  ;; exclusions : 用来排除相应的重复依赖。比如log4j下包含了a.jar。spring.jar也包含了a.jar，但是两个版本不同，则需要排除掉一个，避免冲突。
  :dependencies [[org.clojure/clojure "1.1.0"]
                 [org.clojure/clojure-contrib "1.1.0"]
                 [org.jclouds/jclouds "1.0-RC6" :classifier "jdk15"]
                 [log4j "1.2.15" :exclusions [javax.mail/mail
                                              javax.jms/jms
                                              com.sun.jdmk/jmxtools
                                              com.sun.jmx/jmxri]]]
  
  ;; 只用于开发阶段的依赖。打包部署将不包含这些依赖。
  :dev-dependencies [[org.clojure/swank-clojure "1.2.1"]]
  
  ;; 全局的一个依赖排除。
  :exclusions [org.apache.poi/poi
               org.apache.poi/poi-ooxml]
			   
  ;;在project.clj改变或者库文件目录（:library-path directory）为空时，重新获取依赖。
  :checksum-deps true
  
  ;;如果版本低于这个就警告
  :min-lein-version "1.3.0"
  
  ;; 如果这个选项为false，那么获取依赖的时候，lib目录将被清空。
  ;; 如果要lib目录不被清空，请将它设为true
  :disable-deps-clean false

  ;; 禁用隐式的clean
  :disable-implicit-clean true
  
  ;; Delete .class files that do not have a corresponding package in
  ;; the src/ directory. Workaround for Clojure bug CLJ-322. Causes problems
  ;; with protocols in upstream libraries; false by default. Set to
  ;; true to delete all non-project classes or set to a seq of regexes
  ;; to only delete class files that match one of the regexes.
  （这个翻译我觉的可能有问题，故保留）
  ;; 不存在src/目录，删除所有.class文件
  ;; 为了解决Clojure bug CLJ-322, 可以将其设置为true，或者定义一个正则序列，仅删除不匹配的class文件。
  :clean-non-project-classes true
  
  ;; 如果 :clean-non-project-classes 设置为true
  ;; 你可以设置这个正则，用来保留匹配的class文件。
  :class-file-whitelist #"^(org/example|clojure)"
    
  ;; 在clean阶段其他文件将被删除（除了:compile-path 和 jars/uberjars）。
  ;; %s这个符号将被替换成当前项目的版本号
  :extra-files-to-clean ["tmp" "sample-%s.tar"]
    
  ;; 如果你不能精确匹配到你要删除的文件名
  ;; 你可以使用正则表达（从项目根目录对文件名进行匹配）
  ;; 默认为 #"^$NAME-.*\.jar$".
  :regex-to-clean #"hs_err_pid.*"
  
  ;; 项目的checkout路径
  :checkout-deps-shares [:source-path :test-path
                         ~(fn [p] (str (:root p) "/lib/dev/*"))]
						 
  ;; 在启动时加载hooks中的namespaces
  ;; Hooks一般来自插件，但也可能包含在你的项目source中
  :hooks [leiningen.hooks.difftest]
  
  ;; Predicates to determine whether to run a test or not. See tutorial.
  ;; 决定是否运行测试。请参考tutorial
  :test-selectors {:default (fn [t] (not (or (:integration v) (:regression v))))
                   :integration :integration
                   :regression :regression}
				   
  ;; 如果设置这个为true。将加载所有和leiningen.hooks.*匹配的namespaces。
  ;; 警告！！！：很明显的将导致加载依赖过多，启动起来比蜗牛还慢  
  :implicit-hooks false
  
  
  ;; （提示：ahead-of-time (AOT) compiler 是一个实现时间提前编译的编译器）  
  ;; gen-class和java互操作所需的将被提前编译。:namespaces 在这里是个别名
  ;; 设置一个正则将编译所以匹配的
  :aot [org.example.sample]
  
  
  ;; 打包成jar文件的入口函数
  ;; 设置 :skip-aot 元数据用来做其他事情。例如运行shell或者task。
  :main org.example.sample
  
  ;; 在repl启动的时候自动加载这个namespace
  :repl-init sample.repl-helper
  
  ;;和:repl-init一样，不过已经是过时的东西了，所以请使用:repl-init。
  :repl-init-script "src/main/clojure/init.clj"
  
  ;; 这些将传递给 clojure.main/repl; 查看他们的细节
  :repl-options [:prompt (fn [] (print "your command, master? ") (flush))]
  
  ;; 自定义repl的监听端口
  :repl-port 4001
  :repl-host "0.0.0.0"
  
  ;; A form to prepend to every form that is evaluated inside your project.
  ;; Allows working around the Gilardi Scenario: http://technomancy.us/143
  :project-init (require 'clojure.pprint)
  
  ;; 超时重连。默认为100
  :repl-retry-limit 1000
  
  ;; 对所有的反射调用进行警告
  :warn-on-reflection true
  
  ;; 仓库配置。即使没配置，maven的中央仓库也依然会被查找。
  :omit-default-repositories true
  :repositories {"java.net" "http://download.java.net/maven/2"
                 "sonatype"
                 {:url "http://oss.sonatype.org/content/repositories/releases"
                  ;; If a repository contains  releases only; setting :snapshots
                  ;; to false will speed up dependency checking.
                  :snapshots false
                  ;; You can also set the policies for how to handle :checksum
                  ;; failures to :fail, :warn, or :ignore. In :releases, :daily,
                  ;; :always, and :never are supported.
                  :releases {:checksum :fail
                             :update :always}}
                 ;; Repositories named "snapshots" and "releases" automatically
                 ;; have their :snapshots and :releases disabled as appropriate.
                 "snapshots" {:url "http://blueant.com/archiva/snapshots"
                              ;; Also supports :private-key and :passphrase.
                              :username "milgrim" :password "locative.1"}
                 "releases" {:url "http://blueant.com/archiva/internal"
                             :username "milgrim" :password "locative.1"}}
  
  ;; 开发依赖的仓库
  :deploy-repositories {"releases" {:url "http://blueant.com/archiva/internal/releases"
                                    :username "milgrim" :password "locative.1"}
                        "snapshots" "http://blueant.com/archiva/internal/snapshots"}
  
  ;; 源文件路径
  :source-path "src/main/clojure"
  ;; 编译后的文件路径
  :compile-path "target/classes" ; for .class files
  ;; 打包所需jar文件路径
  :library-path "target/dependency" ; for .jar files
  ;; 单元测试源文件路径
  :test-path "src/test/clojure"
  ;; 配置文件路径
  :resources-path "src/main/resource" ; non-code files included in classpath/jar
  ;; 测试配置文件路径
  :dev-resources-path "src/test/resource" ; added to dev classpath but not jar
  ;; 本地依赖查找路径
  :native-path "src/native"        ; where to look for native dependencies
  ;; 目标路径
  :target-dir "target/  "          ; where to place the project's jar file
  ;; 额外的类路径
  :extra-classpath-dirs ["script"] ; more classpath entries not included in jar
  ;; jar包名
  :jar-name "sample.jar"           ; name of the jar produced by 'lein jar'
  ;; 一样的，jar包名。uberjar是可执行的jar包
  :uberjar-name "sample-standalone.jar" ; as above for uberjar
  ;; 从~/.m2自定义classpath，而不是拷贝到:library-path.
  :local-repo-classpath true
  
  ;; java文件的编译目录
  :javac-options {:destdir "classes/"}
  :java-source-path "src/main/java" ; location of Java source
  ;; Leave the contents of :source-path out of jars (for AOT projects)
  :omit-source true
  ;; 匹配的jar包将被排除
  :jar-exclusions [#"(?:^|/).svn/"]
  ;; 一样的东东，只针对于uberjar
  :uberjar-exclusions [#"META-INF/DUMMY.SF"]
  ;; 对jar's manifest设置任意的键值对。
  :manifest {"Project-awesome-level" "super-great"}
  
  ;; 设置jvm选项
  :jvm-opts ["-Xmx1g"]

  ;; 如果你的项目是一个Leiningen插件，设置这个跳过subprocess步骤
  :eval-in-leiningen false
  
  ;; 解决Clojure's agent的线程池问题。 
  ;; If you see RejectedExecutionException using
  ;; futures or agents, you may be working with a plugin that doesn't
  ;; take this workaround into account yet--see the "Threads" section
  ;; of doc/PLUGINS.md. This key will disable Leiningen's workaround.
  ;; It may cause some other plugins to fail to exit when they finish.
  :skip-shutdown-agents true
  
  ;; 设置一个多模块的maven项目的父项目。
  :parent [org.example/parent "0.0.1" :relative-path "../parent/pom.xml"])

;; You can use Robert Hooke to modify behaviour of any task function,
;; but the prepend-tasks function is shorthand that is more convenient
;; on tasks that take a single project argument.

;; 你可以使用Robert Hooke去修改任何task函数的行为。
(use '[leiningen.core :only [prepend-tasks]]
     '[leiningen.deps :only [deps]]
     '[leiningen.clean :only [clean]]
     '[leiningen.pom :only [pom]])

;; 缩略名字参数调用
(prepend-tasks #'deps clean pom)