development

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
development [23-06-2013 17:14] – [Creating a New Release from Development Code] cwachadevelopment [28-06-2020 21:50] (current) – [Creating a New Release from Development Code] cwacha
Line 18: Line 18:
 To checkout the newest development version, enter the following command on the commandline To checkout the newest development version, enter the following command on the commandline
  
-  svn co https://iaddressbook.svn.sourceforge.net/svnroot/iaddressbook/trunk iaddressbook-dev+  svn co https://svn.code.sf.net/p/iaddressbook/code/trunk iaddressbook-dev
  
 ===== XML-RPC API ===== ===== XML-RPC API =====
Line 44: Line 44:
 ===== Translation ===== ===== Translation =====
  
-Translation into other languages is very easy. Every language definition is stored in a **php**-file which resides in a separate folder for every language below the **//lang//** folder. Example: **//lang/en/lang.php//** contains the english language strings. The folder names for languages are in 2-letter ISO format (en = english, de = german, it = italian etc.).+Translation into other languages is very easy. Every language definition is stored in a **php**-file which resides in a separate folder for every language below the **//lib/lang//** folder. Example: **//lib/lang/en/lang.php//** contains the english language strings. The folder names for languages are in 2-letter ISO format (en = english, de = german, it = italian etc.).
  
 <note important> <note important>
Line 68: Line 68:
 $lang['label_organization'] = 'Company'; $lang['label_organization'] = 'Company';
 </code> </code>
 +
 +===== Templates =====
 +
 +This section describes the HTML template that is currently used. In the current state the template system should be flexible enough to allow you to design a look and feel as you like (and not as the template system likes).
 +
 +The template files have the file ending ''.tpl''. The main file that keeps it all together is called **main.tpl**.
 +
 +  main.tpl
 +     |
 +     +- search.tpl
 +     |
 +     +- tpl_showcontactlist()
 +     |   +- contactlist.tpl
 +     |       +- tpl_contactlist()
 +     |           +- contactlist_item.tpl
 +     |
 +     +- tpl_showperson()
 +         +- person_empty.tpl
 +         |
 +         +- person.tpl
 +         |   +- tpl_addresses()
 +         |   |   +- address.tpl
 +         |   |
 +         |   +- tpl_phones()
 +         |   |   +- phone.tpl
 +         |   |
 +         |   +- tpl_emails()
 +         |   |   +- email.tpl
 +         |   |
 +         |   +- tpl_chathandles()
 +         |   |   +- chathandle.tpl
 +         |   |
 +         |   +- tpl_urls()
 +         |   |   +- url.tpl
 +         |   |
 +         |   +- tpl_relatednames()
 +         |
 +         +- person_edit.tpl
 +             +- tpl_include()
 +             |   +- person_edit_phones.tpl
 +             |
 +             +- tpl_include()
 +             |   +- person_edit_emails.tpl
 +             |
 +             +- tpl_include()
 +             |   +- person_edit_urls.tpl
 +             |
 +             +- tpl_include()
 +             |   +- person_edit_relatednames.tpl
 +             |
 +             +- tpl_include()
 +             |   +- person_edit_chathandles.tpl
 +             |
 +             +- tpl_include()
 +                 +- person_edit_addresses.tpl
 +
 +
 +
 +  * //tpl_showcontactlist()// creates the list of contacts. It basically just inserts the file **contactlist.tpl**
 +  * //tpl_contactlist()// iterates over all contacts and outputs one **contactlist_item.tpl** per contact.
 +
 +
 +  * All other functions work the same way, you should get the hang of it. Remark that **person_edit.tpl** does not call any //tpl_functions// since i thouhgt it would be easier to just inline all the code. Other suggestions are welcome. I have never done a template system before, so it might still have some inconsitencies.
 +
  
 ===== Analysis ===== ===== Analysis =====
Line 81: Line 145:
 This is a MUST-HAVE list. My personal addresses are normally stored inside Apples AddressBook which I find to perfectly fit all my needs. I thought that a web based equivalent, that behaves pretty much the same would be very cool. This is a MUST-HAVE list. My personal addresses are normally stored inside Apples AddressBook which I find to perfectly fit all my needs. I thought that a web based equivalent, that behaves pretty much the same would be very cool.
  
-==== Existing Work ====+==== Existing Work (as of 2007) ====
  
 This is a list of all PHP addressbook applications I found on the web including a short comment why they did not fit my needs. This is a list of all PHP addressbook applications I found on the web including a short comment why they did not fit my needs.
Line 103: Line 167:
 ===== Creating a New Release from Development Code ===== ===== Creating a New Release from Development Code =====
  
-  * update version number in ''/VERSION'' +  * update ''src/VERSION'' 
-  * adjust ''/lib/sql/*.sql'' schemas and db if necessary +  * adjust ''src/lib/sql/*.sql'' schemas and db if necessary 
-  * disable ''/lib/lang/translator.php'' +  * update ''src/README.txt'' and ''src/INSTALL.txt'' 
-  * request updates from translators +  * run ''pkg/pkgmake.sh all'' 
-  * update ''/README.txt'' and ''/INSTALL.txt'' +  * run ''pkg/pkgmake.sh deploy'' 
-  * run ''trunk/pkg/pkgmake.sh'' +  * final test in DEV 
 +  * git tag -a -m "releasing version 4.1.0" release-v4.1.0 
 +  * git push origin --tags 
 +  * run ''pkg/pkgmake.sh all'' 
 +  * run ''pkg/pkgmake.sh deploy'' to DEV site (again) 
 +  * Draft new release in github (Release title: iaddressbook-4.1.0-191) 
 +  * Upload artifacts to github release 
 +  * adjust [[download]] and [[changelog]] 
 +  * run ''pkg/pkgmake.sh deploy'' to DEMO site
  
  • development.1372000443.txt.gz
  • Last modified: 17-11-2016 12:33
  • (external edit)