diff --git a/doc/_build/doctrees/environment.pickle b/doc/_build/doctrees/environment.pickle index db482ee..64cfe2a 100644 --- a/doc/_build/doctrees/environment.pickle +++ b/doc/_build/doctrees/environment.pickle Binary files differ diff --git a/doc/_build/doctrees/license.doctree b/doc/_build/doctrees/license.doctree index 1a8d5fc..be3eca3 100644 --- a/doc/_build/doctrees/license.doctree +++ b/doc/_build/doctrees/license.doctree Binary files differ diff --git a/doc/_build/doctrees/setup.doctree b/doc/_build/doctrees/setup.doctree index a5953d5..3fe2cef 100644 --- a/doc/_build/doctrees/setup.doctree +++ b/doc/_build/doctrees/setup.doctree Binary files differ diff --git a/doc/_build/html/_sources/license.txt b/doc/_build/html/_sources/license.txt index d14f097..9d427c5 100644 --- a/doc/_build/html/_sources/license.txt +++ b/doc/_build/html/_sources/license.txt @@ -22,7 +22,13 @@ RRZE Icon Set ------------- -*CreativeCommons Licence* +**CreativeCommons Licence** The RRZE Icon Set is licenced under a Creative Commons Licence. Please see the website for the current licence text. + +More information about the Project could be found here: +http://rrze-icon-set.berlios.de/licence.html + +Special thanks to: +* Franziska Sponsel (created additional Icons specially for our Project) diff --git a/doc/_build/html/_sources/setup.txt b/doc/_build/html/_sources/setup.txt index f5ef626..1ed7d64 100644 --- a/doc/_build/html/_sources/setup.txt +++ b/doc/_build/html/_sources/setup.txt @@ -12,12 +12,23 @@ .. note:: Please be aware that the following steps only work if you're really in that DIR. If you consider adding a subfolder name to the commands those woun't work ! * Run the Installation from a Shell (not Python) - >>> bootstrap.py - >>> bin/buildout + + .. code-block:: bash + + $ bootstrap.py + $ bin/buildout + * Vertify that everything was setup correclty and your branch fullfills the version requirements by running it's own test module - >>> bin/test + + .. code-block:: bash + + $ bin/test + * Now you're able to run mailman using - >>> bin/mailman + + .. code-block:: bash + + $ bin/mailman Mailman Client / REST Api ------------------------- @@ -27,18 +38,25 @@ Once again start by branching the code which is on Launchpad ->>> bzr branch lp:mailman.client + .. code-block:: bash + + $ bzr branch lp:mailman.client .. note:: We've successfully tested our functionality with Revision 16 - In case the Client gets updated which it surely will in future we can't guarentee that it is compatible anymore. As you only want to run the Client and not modify it's code you're fine with running the install command from within the directory. At the moment this requires Sudo Priveledges as files will copied to the Python Site-Packages Directory which is available to all users. ->>> sudo python setup.py install + .. code-block:: bash + + $ sudo python setup.py install .. note:: If you want to change parts of the Client you can use the development option which will create a Symlink instead of a Hardcopy of all files: ->>> sudo python setup.py develop + + .. code-block:: bash + + $ sudo python setup.py develop All changes will apply once you restart Mailman itself. @@ -139,12 +157,17 @@ 'mailman_django', .. note:: - Makes sure that Django knows about our directory as an App and creates needed Tables () when ->>> running manage.py syncdb + Makes sure that Django knows about our directory as an App and creates needed Tables () when running + + .. code-block:: bash + + $ python manage.py syncdb Now that you know about all these you might start the development server. As usual in Django this is done by running ->>> python manage.py runserver + .. code-block:: bash + + $ python manage.py runserver within the Django Site Directory - as usual the default address is localhost:8000 Of course it will only be able to start once our app is in place as well. @@ -153,10 +176,15 @@ ------------------ First get the files, and make sure you paste them into your Project directory and adjust it's name to the appropriate configuration you've made earlier in the Django Site. Remeber our default is mailman_django ->>> bzr branch lp:mailmanwebgsoc2011 + .. code-block:: bash + + $ bzr branch lp:mailmanwebgsoc2011 .. note:: We've tested Revision 172 + +.. note:: + We're planning to ease up installation by creating an egg Test the Sites functionality ---------------------------- @@ -164,7 +192,9 @@ Run the following in the Site Directory ->>> python manage.py test + .. code-block:: bash + + $ python manage.py test .. note:: Please be aware that we want to run a development instance of mailman you need to stop the stable one first and the tests will open it's own mailman temporily. diff --git a/doc/_build/html/license.html b/doc/_build/html/license.html index 4d1cc2b..009e917 100644 --- a/doc/_build/html/license.html +++ b/doc/_build/html/license.html @@ -66,9 +66,13 @@

RRZE Icon Set

-

CreativeCommons Licence

+

CreativeCommons Licence

The RRZE Icon Set is licenced under a Creative Commons Licence. Please see the website for the current licence text.

+

More information about the Project could be found here: +http://rrze-icon-set.berlios.de/licence.html

+

Special thanks to: +* Franziska Sponsel (created additional Icons specially for our Project)

diff --git a/doc/_build/html/searchindex.js b/doc/_build/html/searchindex.js index 5fadfe6..3891a0f 100644 --- a/doc/_build/html/searchindex.js +++ b/doc/_build/html/searchindex.js @@ -1 +1 @@ -Search.setIndex({objects:{tests:{tests:[3,0,0]}},terms:{all:[3,1],code:[3,1],prefil:3,four:3,kati:3,runserv:1,dirnam:1,follow:1,decid:1,under:2,introduc:1,merchant:2,everi:[3,1],string:3,far:[3,1],offlin:1,util:3,context_processor:1,special:1,contenttyp:1,administr:3,new_list:3,did:1,button:3,list:3,"try":3,item:[],adjust:1,quick:1,setup:[3,1],dir:1,pleas:[3,1,2],modelbackend:1,impli:2,httpresponseredirect:3,cfg:[],seper:1,past:1,second:1,download:1,further:3,compat:1,index:3,what:3,appear:[3,1],sum:[],abl:1,current:2,delet:3,version:[1,2],"new":3,net:1,"public":2,absolut:1,gener:2,remeb:1,here:[3,1],modif:1,ubuntu:1,path:1,along:2,modifi:[3,1,2],sinc:3,valu:1,search:0,vertifi:1,anymor:1,jame:3,doctest:3,action:3,chang:[3,1],mailman_media:1,via:3,appli:1,app:[0,1,3],foundat:2,api:[0,1],instal:[0,1],middlewar:1,from:[3,1],would:1,commun:1,doubl:3,perm:3,next:1,websit:[1,2],few:[3,1],call:[3,1],recommend:1,type:3,web_host:3,mailman_django:[0,1],abspath:1,ital:[],site:[0,1,3],trail:1,stick:1,particular:2,hold:1,unpack:1,account:3,join:1,prepar:1,work:[3,1],dev:3,itself:1,can:[3,1,2],purpos:2,tar:1,sudo:1,templat:1,topic:3,want:[3,1],contribut:[0,2],cours:1,end:[3,1],georg:3,how:3,instead:[3,1],config:1,css:1,updat:1,resourc:[0,3],after:[3,1],usabl:3,befor:1,wrong:1,authentif:[3,1],data:1,postfix:1,bind:1,bootstrap:1,django:[0,1,3],inform:3,allow:[3,1],fallback:1,listnam:3,help:3,style:1,directli:3,fit:2,better:1,requir:[3,1],onc:[3,1],mail:3,hidden:1,main:[],might:1,guarente:1,them:[3,1],"return":3,thei:1,python:[3,1],auth:[3,1],mention:1,now:[3,1],term:2,benst:1,somewher:1,name:[3,1],edit:3,simpl:1,level:1,separ:3,easili:1,each:3,debug:1,found:3,went:3,mailman_test_bindir:1,domain:3,replac:[],realli:[3,1],redistribut:2,"static":[],connect:1,our:[3,1],todo:3,dependeci:1,logout:3,space:[],publish:2,api_us:1,content:[0,1,3],rest_serv:1,got:[3,1],correct:3,earlier:1,free:[1,2],cooki:3,reason:1,base:1,mailmanweb:[],lists_of_domain:1,put:1,org:2,"40mail":3,launch:1,could:[3,1],membership:3,keep:1,thing:1,place:[3,1],root_urlconf:1,requireti:[],view:[3,1],first:[3,1],softwar:2,rang:[],render:1,feel:1,media_root:1,natti:1,alreadi:1,done:[3,1],least:3,stabl:1,installed_app:1,open:1,gpl:[0,2],differ:1,rrze:[0,2],hardcopi:1,licens:[0,2],system:[3,1],messag:[3,1],licenc:2,fullfil:1,"final":3,shell:1,option:[3,1,2],real_nam:3,copi:[1,2],specifi:3,gsoc:1,part:[1,2],mm_membership:3,priveledg:1,serv:1,enjoi:1,provid:3,new_domain:3,project:1,were:1,posit:3,fqdn_listnam:3,pre:[],ani:[1,2],packag:1,have:[3,1,2],tabl:1,need:[3,1],element:1,florian:1,destroi:1,client:[0,1,3],note:1,without:2,indic:3,singl:3,even:2,sure:[3,1],distribut:2,shall:3,usernam:[3,1],object:3,letter:3,watt:3,"class":[3,1],icon:[0,2],don:1,bzr:1,url:[3,1],doc:3,later:[3,1,2],hardcod:3,temporili:1,doe:3,pars:3,usual:1,came:3,text:2,liza:3,session:1,permiss:[3,1],fine:1,redirect:3,access:[3,1],onli:[3,1],launchpad:1,copyright:2,configur:1,should:[3,1,2],new_list1:3,suppos:1,hope:2,media_url:1,nearli:1,get:[3,1],"__file__":1,stop:1,csrf:1,subscript:3,restart:1,template_dir:1,common:2,restadmin:1,where:1,summari:3,set:[0,1,2,3],see:[3,1,2],domain_admin:3,result:1,respons:3,fail:1,awar:[3,1],statu:3,mailman3a7:1,someth:1,between:[3,1],"import":3,awai:1,email:3,realnam:3,correclti:1,advertis:3,subfold:1,addit:3,both:[3,1],last:1,plugin:1,admin:[3,1],howev:1,instanc:1,context:1,delete_list:3,let:3,login:[3,1],com:[3,1],load:3,simpli:1,point:1,instanti:3,address:[3,1],header:[],non:1,linux:3,backend:[3,1],mailman:[0,1,2,3],coupl:[3,1],"0a7":1,been:3,compon:1,much:1,unsubscrib:3,subscrib:3,upcom:1,togeth:1,i18n:1,ngeorg:3,those:1,"case":[3,1],creativecommon:2,therefor:3,gnu:2,align:1,abov:3,mail_host:3,everyon:1,authentication_backend:1,list_own:3,archiv:3,revis:1,decor:1,develop:[0,1,3],welcom:0,author:3,receiv:2,media:1,make:[3,1],same:[3,1],handl:1,html:1,split:1,document:[0,3],finish:3,http:[3,1,2],moment:1,http_host:3,user:[3,1],implement:3,expand:3,appropri:1,framework:3,api_pass:1,well:[3,1],membership_set:3,exampl:[3,1],command:1,thi:[3,1,2],english:3,everyth:[3,1],latest:1,just:1,rest:[0,1],mailman3:[0,1],webui:1,restbackend:1,languag:3,easi:1,project_path:1,list_summari:3,add:[3,1],lawrenc:1,save:3,modul:[3,1],bin:1,applic:[0,1],which:[3,1],unter:[0,2],know:1,gsoc_mailman:1,press:3,password:[3,1],mailmanwebgsoc2011:1,like:1,template_context_processor:1,success:3,restpass:1,server:1,href:3,setup_mm:3,either:[3,2],page:[0,1,3],www:[1,2],right:[3,1],creation:3,some:[3,1],home:1,successfulli:1,buildout:1,djangoproject:[3,1],confirm:3,woun:1,select:3,slash:1,testobject:3,localhost:1,refer:3,machin:3,core:1,run:1,bold:[],symlink:1,step:1,repositori:1,post:3,mm_new_domain:3,stage:3,about:1,central:3,usa:3,mass_subscrib:3,acl:3,act:3,fals:3,processor:1,own:[3,1],addus:3,status_cod:3,within:[3,1],warranti:2,creativ:2,contrib:1,your:[3,1,2],manag:1,log:3,"40exampl":3,execut:1,print:3,"long":1,custom:1,avail:[3,1],start:[3,1],includ:[3,1],suit:[0,1,3],systers_django:[],"function":[0,1,3],head:3,form:3,descrip:1,link:1,translat:3,teardown_mm:3,line:3,"true":3,succe:1,made:1,render_mailman_them:1,possibl:1,"default":1,displai:3,below:3,memebership:3,otherwis:1,more:[3,2],extend_ajax:1,creat:[3,1],request:3,dure:1,exist:[3,1],file:[1,2],syncdb:1,check:[3,1],inc:2,again:1,when:1,detail:2,gettext:3,other:1,futur:1,branch:1,test:[0,1,3],you:[3,1,2],why:3,consid:1,bullet:[],directori:1,descript:3,mailman_them:1,mass:3,time:1,escap:3},objtypes:{"0":"py:module"},titles:["Welcome to mailman_django’s documentation!","Installation","Contributions:","Using the Django App - Developers Resource"],objnames:{"0":"Python module"},filenames:["index","setup","license","using"]}) \ No newline at end of file +Search.setIndex({objects:{tests:{tests:[3,0,0]}},terms:{all:[3,1],code:[3,1],prefil:3,four:3,kati:3,runserv:1,dirnam:1,follow:1,decid:1,mailman_them:1,under:2,introduc:1,merchant:2,everi:[3,1],string:3,far:[3,1],offlin:1,util:3,context_processor:1,contenttyp:1,administr:3,new_list:3,did:1,button:3,list:3,"try":3,item:[],adjust:1,quick:1,setup:[3,1],dir:1,pleas:[3,1,2],modelbackend:1,impli:2,core:1,cfg:[],seper:1,past:1,second:1,download:1,further:3,compat:1,index:3,what:3,appear:[3,1],sum:[],abl:1,current:2,delet:3,new_list1:3,franziska:2,"new":3,net:1,"public":2,gener:2,remeb:1,here:[3,1,2],modif:1,ubuntu:1,path:1,along:2,modifi:[3,1,2],sinc:3,valu:1,search:0,vertifi:1,anymor:1,jame:3,doctest:3,action:3,chang:[3,1],mailman_media:1,via:3,appli:1,app:[0,1,3],foundat:2,api:[0,1],sponsel:2,instal:[0,1],middlewar:1,from:[3,1],would:1,commun:1,doubl:3,perm:3,next:1,websit:[1,2],few:[3,1],call:[3,1],recommend:1,type:3,web_host:3,mailman_django:[0,1],abspath:1,ital:[],list_own:3,trail:1,berlio:2,stick:1,particular:2,hold:1,unpack:1,account:3,join:1,prepar:1,work:[3,1],dev:3,archiv:3,can:[3,1,2],purpos:2,tar:1,sudo:1,templat:1,topic:3,want:[3,1],contribut:[0,2],cours:1,end:[3,1],georg:3,how:3,instead:[3,1],simpl:1,css:1,updat:1,resourc:[0,3],earlier:1,usabl:3,befor:1,membership:3,authentif:[3,1],hardcopi:1,postfix:1,bind:1,bootstrap:1,element:1,inform:[3,2],allow:[3,1],fallback:1,egg:1,listnam:3,help:3,style:1,directli:3,fit:2,better:1,requir:[3,1],onc:[3,1],mail:3,hidden:1,main:[],might:1,guarente:1,them:[3,1],"return":3,thei:1,python:[3,1],auth:[3,1],mention:1,now:[3,1],term:2,benst:1,somewher:1,name:[3,1],edit:3,config:1,level:1,separ:3,easili:1,each:3,debug:1,found:[3,2],went:3,mailman_test_bindir:1,domain:3,replac:[],realli:[3,1],redistribut:2,"static":[],connect:1,our:[3,1,2],todo:3,special:[1,2],logout:3,space:[],publish:2,your:[3,1,2],content:[0,1,3],rest_serv:1,got:[3,1],correct:3,after:[3,1],free:[1,2],cooki:3,reason:1,base:1,mailmanweb:[],lists_of_domain:1,put:1,org:2,"40mail":3,launch:1,could:[3,1,2],wrong:1,keep:1,thing:1,place:[3,1],root_urlconf:1,requireti:[],view:[3,1],first:[3,1],softwar:2,rang:[],render:1,feel:1,media_root:1,natti:1,alreadi:1,done:[3,1],least:3,stabl:1,installed_app:1,open:1,gpl:[0,2],differ:1,rrze:[0,2],data:1,licens:[0,2],system:[3,1],messag:[3,1],licenc:2,fullfil:1,"final":3,shell:1,option:[3,1,2],real_nam:3,copi:[1,2],specifi:3,gsoc:1,part:[1,2],mm_membership:3,priveledg:1,serv:1,enjoi:1,provid:3,new_domain:3,project:[1,2],were:1,posit:3,fqdn_listnam:3,pre:[],ani:[1,2],packag:1,have:[3,1,2],tabl:1,need:[3,1],django:[0,1,3],florian:1,destroi:1,client:[0,1,3],note:1,without:2,indic:3,singl:3,even:2,sure:[3,1],distribut:2,shall:3,usernam:[3,1],object:3,plan:1,letter:3,watt:3,"class":[3,1],icon:[0,2],don:1,bzr:1,url:[3,1],doc:3,later:[3,1,2],hardcod:3,temporili:1,doe:3,pars:3,latest:1,came:3,text:2,liza:3,session:1,permiss:[3,1],fine:1,line:3,redirect:3,absolut:1,onli:[3,1],launchpad:1,copyright:2,configur:1,should:[3,1,2],version:[1,2],suppos:1,hope:2,media_url:1,nearli:1,get:[3,1],"__file__":1,stop:1,csrf:1,awai:1,restart:1,template_dir:1,common:2,restadmin:1,where:1,summari:3,set:[0,1,2,3],see:[3,1,2],domain_admin:3,result:1,respons:3,fail:1,awar:[3,1],statu:3,someth:1,between:[3,1],"import":3,subscript:3,email:3,realnam:3,correclti:1,advertis:3,subfold:1,addit:[3,2],both:[3,1],last:1,plugin:1,admin:[3,1],howev:1,instanc:1,context:1,delete_list:3,let:3,login:[3,1],com:[3,1],load:3,simpli:1,point:1,instanti:3,address:[3,1],header:[],non:1,linux:3,backend:[3,1],mailman:[0,1,2,3],coupl:[3,1],"0a7":1,been:3,compon:1,much:1,unsubscrib:3,subscrib:3,upcom:1,togeth:1,i18n:1,ngeorg:3,those:1,"case":[3,1],creativecommon:2,therefor:3,gnu:2,align:1,abov:3,mail_host:3,everyon:1,authentication_backend:1,site:[0,1,3],itself:1,revis:1,decor:1,develop:[0,1,3],welcom:0,author:3,receiv:2,media:1,make:[3,1],same:[3,1],handl:1,html:[1,2],split:1,document:[0,3],finish:3,http:[3,1,2],moment:1,http_host:3,user:[3,1],implement:3,expand:3,appropri:1,framework:3,api_pass:1,well:[3,1],membership_set:3,exampl:[3,1],command:1,thi:[3,1,2],english:3,everyth:[3,1],usual:1,just:1,rest:[0,1],mailman3:[0,1],webui:1,restbackend:1,languag:3,easi:1,project_path:1,list_summari:3,add:[3,1],lawrenc:1,save:3,modul:[3,1],futur:1,bin:1,applic:[0,1],which:[3,1],unter:[0,2],know:1,gsoc_mailman:1,press:3,password:[3,1],mailmanwebgsoc2011:1,template_context_processor:1,like:1,success:3,restpass:1,server:1,href:3,setup_mm:3,either:[3,2],page:[0,1,3],www:[1,2],right:[3,1],creation:3,some:[3,1],home:1,successfulli:1,buildout:1,djangoproject:[3,1],confirm:3,woun:1,thank:2,select:3,slash:1,testobject:3,localhost:1,refer:3,machin:3,httpresponseredirect:3,run:1,bold:[],symlink:1,step:1,repositori:1,post:3,mm_new_domain:3,stage:3,about:[1,2],central:3,usa:3,mass_subscrib:3,acl:3,act:3,fals:3,processor:1,own:[3,1],addus:3,status_cod:3,within:[3,1],warranti:2,creativ:2,contrib:1,api_us:1,manag:1,log:3,"40exampl":3,execut:1,print:3,"long":1,custom:1,avail:[3,1],start:[3,1],includ:[3,1],suit:[0,1,3],systers_django:[],"function":[0,1,3],head:3,form:3,descrip:1,link:1,translat:3,teardown_mm:3,eas:1,"true":3,succe:1,made:1,render_mailman_them:1,possibl:1,"default":1,access:[3,1],displai:3,below:3,memebership:3,otherwis:1,more:[3,2],extend_ajax:1,creat:[3,1,2],request:3,dure:1,exist:[3,1],file:[1,2],syncdb:1,check:[3,1],inc:2,again:1,when:1,detail:2,gettext:3,other:1,dependeci:1,branch:1,test:[0,1,3],you:[3,1,2],why:3,consid:1,bullet:[],directori:1,descript:3,mailman3a7:1,mass:3,time:1,escap:3},objtypes:{"0":"py:module"},titles:["Welcome to mailman_django’s documentation!","Installation","Contributions:","Using the Django App - Developers Resource"],objnames:{"0":"Python module"},filenames:["index","setup","license","using"]}) \ No newline at end of file diff --git a/doc/_build/html/setup.html b/doc/_build/html/setup.html index c63c141..fb02d51 100644 --- a/doc/_build/html/setup.html +++ b/doc/_build/html/setup.html @@ -76,30 +76,27 @@ -
  • -
    Run the Installation from a Shell (not Python)
    -
    >>> bootstrap.py
    ->>> bin/buildout
    +
  • Run the Installation from a Shell (not Python)

    +
    +
    $ bootstrap.py
    +$ bin/buildout
     
    -
  • -
    +
  • -
  • -
    Vertify that everything was setup correclty and your branch fullfills the version requirements by running it’s own test module
    -
    >>> bin/test
    +
  • Vertify that everything was setup correclty and your branch fullfills the version requirements by running it’s own test module

    +
    +
    $ bin/test
     
    -
  • -
    +
  • -
  • -
    Now you’re able to run mailman using
    -
    >>> bin/mailman
    +
  • Now you’re able to run mailman using

    +
    +
    $ bin/mailman
     
    -
  • -
    +
  • @@ -108,24 +105,28 @@

    Next thing you need to do is installing the Plugin used for communication with non-mailman-code parts like our WebUI. Within the Client Branch we’ve put both, Classes to access the Core which are run as a Plugin and some Python Bindings. The Python Bindings were used later on within our Django Application to access the Server. Failing to install the Client would result in an offline version of WebUI

    Once again start by branching the code which is on Launchpad

    -
    >>> bzr branch lp:mailman.client
    +
    +
    $ bzr branch lp:mailman.client
     
    +

    Note

    We’ve successfully tested our functionality with Revision 16 - In case the Client gets updated which it surely will in future we can’t guarentee that it is compatible anymore.

    As you only want to run the Client and not modify it’s code you’re fine with running the install command from within the directory. At the moment this requires Sudo Priveledges as files will copied to the Python Site-Packages Directory which is available to all users.

    -
    >>> sudo python setup.py install
    +
    +
    $ sudo python setup.py install
     
    +

    Note

    -

    If you want to change parts of the Client you can use the development option which will create a Symlink instead of a Hardcopy of all files:

    -
    -
    >>> sudo python setup.py develop
    +

    If you want to change parts of the Client you can use the development option which will create a Symlink instead of a Hardcopy of all files:

    +
    $ sudo python setup.py develop
     
    +

    All changes will apply once you restart Mailman itself.

    @@ -239,40 +240,50 @@ ‘django.contrib.sites’, ‘django.contrib.admin’, ‘mailman_django’,

    -
    +

    Note

    -

    Makes sure that Django knows about our directory as an App and creates needed Tables () when

    +

    Makes sure that Django knows about our directory as an App and creates needed Tables () when running

    +
    +
    $ python manage.py syncdb
    +
    -
    >>> running manage.py syncdb
    -
    -

    Now that you know about all these you might start the development server. As usual in Django this is done by running

    -
    >>> python manage.py runserver
    +
    +
    $ python manage.py runserver
     
    +

    within the Django Site Directory - as usual the default address is localhost:8000 Of course it will only be able to start once our app is in place as well.

    Django Application

    First get the files, and make sure you paste them into your Project directory and adjust it’s name to the appropriate configuration you’ve made earlier in the Django Site. Remeber our default is mailman_django

    -
    >>> bzr branch lp:mailmanwebgsoc2011
    +
    +
    $ bzr branch lp:mailmanwebgsoc2011
     
    +

    Note

    We’ve tested Revision 172

    +
    +

    Note

    +

    We’re planning to ease up installation by creating an egg

    +

    Test the Sites functionality

    We’ve added our own test-suite to the Django App which will be executed together with the Django Test. Last thing you should do is running these tests. If they fail you did something wrong, if they succeed you can enjoy the site.

    Run the following in the Site Directory

    -
    >>> python manage.py test
    +
    +
    $ python manage.py test
     
    +

    Note

    Please be aware that we want to run a development instance of mailman you need to stop the stable one first and the tests will open it’s own mailman temporily.

    diff --git a/doc/setup.rst b/doc/setup.rst index f5ef626..1ed7d64 100644 --- a/doc/setup.rst +++ b/doc/setup.rst @@ -12,12 +12,23 @@ .. note:: Please be aware that the following steps only work if you're really in that DIR. If you consider adding a subfolder name to the commands those woun't work ! * Run the Installation from a Shell (not Python) - >>> bootstrap.py - >>> bin/buildout + + .. code-block:: bash + + $ bootstrap.py + $ bin/buildout + * Vertify that everything was setup correclty and your branch fullfills the version requirements by running it's own test module - >>> bin/test + + .. code-block:: bash + + $ bin/test + * Now you're able to run mailman using - >>> bin/mailman + + .. code-block:: bash + + $ bin/mailman Mailman Client / REST Api ------------------------- @@ -27,18 +38,25 @@ Once again start by branching the code which is on Launchpad ->>> bzr branch lp:mailman.client + .. code-block:: bash + + $ bzr branch lp:mailman.client .. note:: We've successfully tested our functionality with Revision 16 - In case the Client gets updated which it surely will in future we can't guarentee that it is compatible anymore. As you only want to run the Client and not modify it's code you're fine with running the install command from within the directory. At the moment this requires Sudo Priveledges as files will copied to the Python Site-Packages Directory which is available to all users. ->>> sudo python setup.py install + .. code-block:: bash + + $ sudo python setup.py install .. note:: If you want to change parts of the Client you can use the development option which will create a Symlink instead of a Hardcopy of all files: ->>> sudo python setup.py develop + + .. code-block:: bash + + $ sudo python setup.py develop All changes will apply once you restart Mailman itself. @@ -139,12 +157,17 @@ 'mailman_django', .. note:: - Makes sure that Django knows about our directory as an App and creates needed Tables () when ->>> running manage.py syncdb + Makes sure that Django knows about our directory as an App and creates needed Tables () when running + + .. code-block:: bash + + $ python manage.py syncdb Now that you know about all these you might start the development server. As usual in Django this is done by running ->>> python manage.py runserver + .. code-block:: bash + + $ python manage.py runserver within the Django Site Directory - as usual the default address is localhost:8000 Of course it will only be able to start once our app is in place as well. @@ -153,10 +176,15 @@ ------------------ First get the files, and make sure you paste them into your Project directory and adjust it's name to the appropriate configuration you've made earlier in the Django Site. Remeber our default is mailman_django ->>> bzr branch lp:mailmanwebgsoc2011 + .. code-block:: bash + + $ bzr branch lp:mailmanwebgsoc2011 .. note:: We've tested Revision 172 + +.. note:: + We're planning to ease up installation by creating an egg Test the Sites functionality ---------------------------- @@ -164,7 +192,9 @@ Run the following in the Site Directory ->>> python manage.py test + .. code-block:: bash + + $ python manage.py test .. note:: Please be aware that we want to run a development instance of mailman you need to stop the stable one first and the tests will open it's own mailman temporily.