title: Clojure 代码规范(中文)
tags:

  • clojure
  • 代码规范
  • 指南
  • 风格
  • 翻译
    categories: Guide

Clojure 代码规范

Role models are important.

– Officer Alex J. Murphy / RoboCop

原文地址:https://github.com/bbatsov/clojure-style-guide

这份Clojure代码规范旨在提供一系列的最佳实践,让现实工作中的Clojure程序员能够写出易于维护的代码,并能与他人协作和共享。一份反应真实需求的代码规范才能被人接收,而那些理想化的、甚至部分观点遭到程序员拒绝的代码规范注定不会长久——无论它有多出色。

这份规范由多个章节组成,每个章节包含一组相关的规则。我会尝试去描述每条规则背后的理念(过于明显的理念我就省略了)。

这些规则并不是我凭空想象的,它们出自于我作为一个专业软件开发工程师长久以来的工作积累,以及Clojure社区成员们的反馈和建议,还有各种广为流传的Clojure编程学习资源,如《Clojure Programming》、《The Joy of Clojure》等。

这份规范还处于编写阶段,部分章节有所缺失,内容并不完整;部分规则没有示例,或者示例还不能完全将其描述清楚。未来这些问题都会得到改进,只是请你了解这一情况。

你可以使用Transmuter生成一份本规范的PDF或HTML格式的文档。

本指南的翻译可在以下几种语言中:

目录

GitHub 秘籍

GitHub秘籍 Awesome

Git 和 Github 秘籍,灵感来自于 Zach Holman 在 2012 年 Aloha Ruby Conference 和 2013 年 WDCNZ 上所做的演讲:Git and GitHub Secrets(slides) 和 More Git and GitHub Secrets(slides)。

其他语言版本: English, 한국어, 日本語, 简体中文, 正體中文.

目录

markdown学习资料汇总

说明

自从学习使用 markdown 以来,收集的学习资料、软件工具、使用指南等,如果你没有听说过或者还没有体验过markdown 进行写作文章,强烈建议 have a try !

markdown 介绍

Markdown 是一种轻量级标记语言,它允许人们“使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档”。 - wikipedia

前端资源收集

前端收集

在前端路上摸索前行,在这里分享自己长期关注的前端开发相关的优秀网站、博客、以及活跃开发者。欢迎更新,以下各排名不分先后顺序。

自己 RSS 长期订阅了一些IT 和技术相关博客,这里是我Feedly 输出的opml,可直接导入一些RSS 阅读器:
https://github.com/foru17/luolei-dotfiles/blob/master/feedly.opml

====

前端收集图谱

此部分为@jikeytang 贡献

image

给程序员的开源、免费图书集合

books-collection 给程序员的开源、免费图书集合

To programmer’s open source and free books collection.

In this project, we will constantly update collection,
if you are interested, you can continue to focus on, click
Watch or Star.

I am improving and expanding the documentation all the time. If you’d like to help this project, please consider corrected, expanding, or adding documentation where you see a need. Every little bit of help you provide in turn improves books-collection.The easiest way to contribute your documentation is to send it to the Issues

给程序员的开源、免费书籍收集,图书集合。

本项目中所列出的图书均由人工校验过,放心可用。

本项目将不断更新收集,如果你感兴趣,可以持续关注, 点 Watch 或者 Star ,查看Github中watch、star的用法

同时,欢迎你提出宝贵的意见,或者投稿。使用 issues

说明:标志:us:为英文,:cn:为中文, :arrow_down:为可以下载的附件,