HTML/CSS 开发规范指南

HTML/CSS开发规范指南

目录

  1. 规范概述
  2. 基本信息
  3. 通用约定
  4. HTML约定
  5. CSS约定
  6. 图像约定
  7. 结语

Ruby 风格指南

序幕

榜样很重要。

——墨菲警官《机器战警》

作为一名 Ruby 开发者,有件事一直困扰着我——Python 社区有一份优秀的编程风格参考文档(PEP-8),而我们迄今还没有一本记录 Ruby 编程风格及最佳实践的官方指南。我确信编程风格很重要,我也相信像 Ruby 这样伟大的黑客社区能够写出这本众望所归的风格指南。

这份指南原本是我司内部的 Ruby 编程指南 (在下所写的),后来,我决定要把这一成果贡献给广大的 Ruby 社区。这个世界再多一份公司内部文件并没有什么不同,然而,由社区推动并制定的一系列 Ruby 编程惯例、最佳实践及代码风格,却能让全世界的 Ruby 开发者都从中获益。

从编写这份指南开始,我收到了很多 Ruby 社区成员的反馈。感谢所有的建议及支持!只要同心协力,我们就能创造一个让每个 Ruby 开发者都从中受益的资源。

顺道一提,如果你对 Rails 感兴趣,你可以看看这份 Ruby on Rails 风格指南 作为补充。

Ruby 风格指南

这份 Ruby 风格指南推荐的是 Ruby 的最佳实践,现实世界中的 Ruby 程序员据此可以写出可维护的高质量代码。我们只说实际使用中的用法。指南再好,但里面说的过于理想化结果大家拒绝使用或者可能根本没人用,又有何意义。

本指南分为几个小节,每一小节由几条相关的规则构成。我尽力在每条规则后面说明理由(如果省略了说明,那是因为其理由显而易见)。

这些规则不是我凭空想象出来的——它们中的绝大部分来自我多年以来作为职业软件工程师的经验,来自 Ruby 社区成员的反馈和建议,以及几个评价甚高的 Ruby 编程资源,像 《Programming Ruby 1.9》 以及 《The Ruby Programming Language》

Ruby 社区尚未就某些规则达成明显的共识,例如字符串字面量的引号、hash 字面量两端是否应该有空格、多行方法链式调用中点运算符的位置。对于这种情况,本指南列出了所有可选的流行风格,你可以任选其一并坚持使用。

本指南会一直更新,随着 Ruby 本身的发展,新的规则会添加进来,过时的规则会被剔除。

许多项目有其自己的编码风格指南(往往是源于本指南而创建)。当项目的风格指南与本指南发生冲突时,应以项目级的指南为准。

你可以使用 Transmuter 生成本指南的 PDF 或 HTML 版本。

RuboCop 项目会自动检查你的 Ruby 代码是否符合这份 Ruby 风格指南。

本指南有以下翻译版本:

目录

Rails 风格指南

序幕

Role models are important.

– 机械战警 Alex J. Murphy

这份指南目的于演示一整套 Rails 3 开发的风格惯例及最佳实践。这是一份与由现存社群所驱动的Ruby 编码风格指南互补的指南。

而本指南中测试 Rails 应用小节摆在开发 Rails 应用之后,因为我相信行为驱动开发
(BDD) 是最佳的软体开发之道。铭记在心吧。

Rails 是一个坚持己见的框架,而这也是一份坚持己见的指南。在我的心里,我坚信 RSpec 优于 Test::Unit,Sass 优于 CSS 以及
Haml,(Slim) 优于 Erb。所以不要期望在这里找到 Test::Unit, CSS 及 Erb 的忠告。

某些忠告仅适用于 Rails 3.1+ 以上版本。

你可以使用 Transmuter 来产生本指南的一份 PDF 或 HTML 复本。

目录

本指南被翻译成下列语言:

给Eclipse提速的7个技巧

大约一个月前,我发表了一篇博客,其中介绍了对Eclipse的爱与恨。 有些人问我如何给Eclipse提速,这篇文章就来讨论这个问题。顺带提一下,这篇文章不是比较IDE,所以不要说你讨厌某个IDE而选择另外一个。这篇文章只是关注如何让Eclipse运行得更快。每个技巧都针对Windows、Linux和MacOS用户详细说明。在使用所有优化技巧之后,Eclipse应该能在10秒内启动,并且比以前运行得更流畅。

这些技巧不仅仅缩短了Eclipse的启动时间,其中大部分技巧还改善了用户体验。例如,更快地打开类、从一处定义跳到另外一处、查看javadoc等。但这些提速无法用时间精确的测量,所以对每条技巧带来的提速效果也没有特定的基准。

Maven+Nexus配置手册

maven–私服的搭建(Nexus的使用)

私服是什么

私服,私有服务器,是公司内部Maven项目经常需要的部件。Nexus是常用的私用Maven服务器,一般是公司内部使用。下载地址是http://www.sonatype.org/nexus/go。默认端口8081,这里我选择最新版nexus-2.11.1-01。

使用Maven构建和管理项目是非常享受的一件事,我们可以从Maven中央仓库下载所需要的构件(artifact),但实际开发中由于种种原因我们需要在架设一个Maven本地代理仓库,如:不方便访问公网、节省带宽和时间、管理自家的共用artifact等等。
nexus_01_01.gif