====== Redmine Project Mgmt ======

**//"Redmine is a flexible project management web application"//**

  * issue-ticket system, timetracker, forum, news, wiki, etc., etc., etc., etc., 
  * ruby on rails
  * cross plattform, cross database

----
\\

==== Installation ====

**this steps work in squeeze as well (02.2012):**

  * [[http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_on_Debian_Wheezy_Testing_with_MySQL_and_Apache2-Passenger|redmine.org/...HowTo_Install_Redmine_on_Debian_Wheezywith_MySQL_and_Apache2-Passenger]]

=== Upgrade ===

  * debian stable version is veeery ooold (oh really?)

**use backports!** 

Add this line
  deb http://backports.debian.org/debian-backports squeeze-backports main
to your sources.list (or add a new file to /etc/apt/sources.list.d/)
Run 
  apt-get update

To install or upgrade $any package from backports run:

  apt-get -t squeeze-backports install "package"


  * see: http://backports-master.debian.org/Instructions/


=== Jessie ===

You need to use mysql2 adapter - see redmine upgrade doc for more info

----
\\

==== Themes ====

  * Theme List: http://www.redmine.org/projects/redmine/wiki/Theme_List

----
\\
==== Plugins ====

  * Howto install plugins: http://www.redmine.org/projects/redmine/wiki/Plugins
  * List of all Plugins: http://www.redmine.org/projects/redmine/wiki/Plugin_List

----
\\
==== Useful plugins ====


=== wiki-html-utility ===

**embed HTML:**

  {{html(<br/><br/>)}}


**inject an external JS or CSS file:**

  {{js_url('http://www.domain.com/js/widget.js')}}
	
  {{css_url('http://www.domain.com/css/styles.ui.css')}}
  

  * install this: https://github.com/mexitek/redmine_wiki_html_util/blob/master/README.textile
  * info: http://www.arlocarreon.com/blog/redmine/redmine-wiki-html-utility/


----
\\
==== Email Notifications ====

Using exim inside a vserver. do NOT configure it in configuration.yml, but in email.yml
take care to use spaces, not tabs ^^

  production:
    delivery_method: :smtp
    smtp_settings:
      address: 127.0.0.1
      port: 25
      domain: projects.synoptx.net
      authentication: :none


this finally helped:
https://library.linode.com/web-applications/project-management/redmine/debian-5-lenny#sph_configure-email-service



----
\\
==== Etherpad-Lite Embed! ====

you can embed an iframe anywhere on the page, when you install the 'wiki-html-utility' plugin.

  {{html( 
     <iframe src='http://redmine.tld:9001/p/redmine-535?showControls=true&showChat=true&showLineNumbers=true'  width="100%" height="600">
  )}}


\\
CSS is not really required, but you could inject a file like this:
  {{css_url('http://redminehostname.info/stylesheets/etherpadiframe.css')}}

 * idea by: http://rschulte.com/etherpad-and-redmine-hack-how-we-are-embedding-collaborative-documents-redmine
 * a few more embed params: https://github.com/Pita/etherpad-lite/wiki/Embed-Parameters