Login   Register  
PHP Classes
elePHPant
Icontem

File: docs/coding-standards.md

Recommend this page to a friend!
Stumble It! Stumble It! Bookmark in del.icio.us Bookmark in del.icio.us
  Classes of Jin Nguyen  >  Puja  >  docs/coding-standards.md  >  Download  
File: docs/coding-standards.md
Role: Documentation
Content type: text/plain
Description: Documentation
Class: Puja
Template engine that compiles templates into PHP
Author: By
Last change:
Date: 11 months ago
Size: 1,440 bytes
 

Contents

Class file image Download
Coding Standards
=======

When writing Puja templates, we recommend you to follow these official coding standards:

- Put one (and only one) space after the start of a delimiter ({{, {%, and {#) and before the end of a delimiter (}}, %}, and #}):
{{ foo }}
<pre>
{# comment content #}
{% if foo %}do somthing{% endif %}
</pre>
- Put one (and only one) space before and after the following operators: comparison operators (==, !=, <, >, >=, <= , !), math operators (+, -, /, *, %), logic operators (not, and, or), ~, is, in:
<pre>{{ 1 + 2 }}
{{ a or b }}</pre>

- Do not put any spaces after an opening parenthesis and before a closing parenthesis in expressions:
<pre>{{ 1 + (2 * 3) }}</pre>

- Do not put any spaces before and after string delimiters:
<pre>{{ 'foo' }}
{{ "foo" }}</pre>

- Do not put any spaces before and after the following operators: |, .:
<pre>{{ foo|upper|lower }}
{{ user.name }}</pre>

- Do not put single quote (') and double quote (") before and after the file name in tag <strong>include</strong>, <strong>extends</strong>:
<pre>
   {% include include_file.tpl %}
   {% extends master.tpl %}
</pre>

- Use lower cased and underscored variable names:
<pre>{% set foo = 'foo' %}
{% set foo_bar = 'foo' %}</pre>

- Indent your code inside tags (use the same indentation as the one used for the main language of the file):
<pre>{% block body %}
   {% if true %}
       true
   {% endif %}
{% endblock body %}
</pre>