/[cvs]/joko/doc/SampleTasks/joko_2003-01.html
ViewVC logotype

Diff of /joko/doc/SampleTasks/joko_2003-01.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.39 by joko, Sat Jan 25 14:03:21 2003 UTC revision 1.69 by joko, Mon Jan 27 04:03:32 2003 UTC
# Line 1  Line 1 
1  <html>  <html>
2    <head>
3      <title>joko's sample notes - 2003-01 - InventoryCleanupAndRefactoring</title>
4      <link href="/horde/css.php?app=chora" rel="stylesheet" type="text/css" />
5    </head>
6  <body>  <body>
7    
8    
9  <pre>  <pre>
10    
11    
12    AIMS:
13      - Convert this document into a data-structure and back.
14      - Don't loose a bit of information.
15      - Make possible to link to all resources available.
16    
17    for working with it
18      - global metadata
19        - cvs-loginfo/commitinfo
20      - ItemMetadata
21        - ItemStatus (open, closed and stuff)
22        - ItemAuthor
23        - ItemType
24        - ItemIdentifier
25        - references/associations to/from
26      - word metadata
27        - link to target
28        - show target as ...
29      - overview of all gathered metadata (at the bottom)
30    
31    for rendering it
32        - render <target> at <locator> as <that-type> [in <this-mode>] [to this <othertarget>]
33    
34    
35  joko@netfrag.org - sample stack:  joko@netfrag.org - sample stack:
36    
37    o [task by joko] introduced "dispatchmail" to add mail2news-functionality to "recieveMail" (collector@netfrag.org)    o [task by joko] introduced "dispatchmail" to add mail2news-functionality to "recieveMail" (collector@netfrag.org)
# Line 430  x configured Apache for serving news.net Line 459  x configured Apache for serving news.net
459     x /etc/init.d/apache reload     x /etc/init.d/apache reload
460     x test: http://news.netfrag.org/     x test: http://news.netfrag.org/
461        
     
   
462  o new module for cvs-repository?  o new module for cvs-repository?
463     o nfo/layouts/fs/skel/data2     o nfo/layouts/fs/skel/data2
464     o checkout to /data on quepasa.netfrag.org     o checkout to /data on quepasa.netfrag.org
# Line 564  x new email-addresses@netfrag.org: Line 591  x new email-addresses@netfrag.org:
591    x sysadmin@netfrag.org    x sysadmin@netfrag.org
592    x faq@netfrag.org    x faq@netfrag.org
593        
594  x setup newsportal (by Florian Amrhein)  x --rework|*reworked*-- apache-layout - check into repository as something root is responsible for!
595    
596    x --setup|*setting up*-- newsportal (by Florian Amrhein)
597    x url: http://florian-amrhein.de/newsportal/    x url: http://florian-amrhein.de/newsportal/
598    x cd /home/service/download    x cd /home/service/download
599    x mkdir newsportal    x mkdir newsportal
600    x cd newsportal    x cd newsportal
601    x wget http://florian-amrhein.de/newsportal/download/newsportal-0.24.tar.gz    x wget http://florian-amrhein.de/newsportal/download/newsportal-0.24.tar.gz
602    x mkdir -p /data/www/virtual/netfrag/sites/news/apps/newsportal/    x mkdir -p /data/www/virtual/netfrag/sites/news/apps/newsportal/
603    x tar -xzf newsportal-0.24.tar.gz --directory=/data/www/virtual/netfrag/sites/news/apps/newsportal/    x tar -xzf newsportal-0.24.tar.gz --directory=/data/www/global/apps/newsportal/
604      x add to /data/www/virtual/netfrag/conf/applications.conf
605  o rework apache-layout - check into repository as something root is responsible for!      Alias /webnews/ /data/www/global/apps/newsportal/
606      x configure in /data/www/global/apps/newsportal/config.inc
607        // newsserver setup
608        $server="news.netfrag.org";
609        $server_auth_user="webnews";
610        $server_auth_pass="web123";
611      x add to /etc/news/nnrp.access:
612        # 2003-01-26, joko
613        *:Read Post:webnews:web123:*
614      x modify groups.txt
615        <nfo.* - add all groups here>
616        o TODO: AUTOUPDATE here!
617      x add to the index-page:
618        xR set INSERTION="<link href="/horde/css.php?app=chora" rel="stylesheet" type="text/css" />"
619        x grep -rin "<head" *
620          doc/readme-deutsch.html:4:</head>
621          doc/faq.html:4:</head>
622          doc/history.txt:234:- fehlender </head> Tag ergaenzt
623          doc/readme-english.html:4:</head>
624          doc/history.txt~:233:- fehlender </head> Tag ergaenzt
625          extras/frames/thread_frameset.php:10:</head>
626          head.inc:5:</head>
627        x cvs add head.inc
628        x cvs commit -m "+ initial commit" head.inc
629        x <modify head.inc>
630          x nano head.inc
631          x <jump to line 5> STRG+W + T: 5
632          xR <insert INSERTION>
633          xR <insert [ENTER]>
634          x <save file> STRG+O + [ENTER]
635        x test: <hit reload on <a href="http://www.netfrag.org/webnews/">http://www.netfrag.org/webnews/</a>>
636          o TODO: RefactorThisHtmlRef to WebNews
637        o view message in some MimeViewer or HtmlViewer (Horde?)
638          o -> use a MessageViewer with MimeCapabilities and HtmlCapabilities
639      x Why newsportal and no other?
640        x directly connects to nntp-daemon
641        x has local spool (o TODO: purge regularly?)
642        x highly customizable
643          x added custom css-stylesheet and changed something at content-rendering-level without any problems
644          x visit cvs.netfrag.org to look at the changes made to the newsportal codebase:
645            x -> <a href="http://cvs.netfrag.org/nfo/hosts/quepasa.netfrag.org/data/www/global/apps/newsportal/">newsportal at cvs.netfrag.org</a>
646              o TODO: RefactorThisLink
647        x it's just easy!
648      x setup dispatchrequest for http://news.netfrag.org
649        x cd /data/www/virtual/netfrag/sites/news/
650        x create symlink
651          x ./.symlinkrc
652        x copy over from webcvs
653          x cp ../webcvs/index.php .
654          x mkdir .dispatch
655          x cd .dispatch
656          x cp ../webcvs/.dispatch/config.php .
657          x cp ../webcvs/.dispatch/index.php .
658        x cvs add ...
659        x cvs commit ...
660      x added|*adding* dispatcher at http://news.netfrag.org
661        x used and mungled DispatchRequest(->cvs, ->doc, ->search)  for this purpose
662          o IdeaFor ParseDoc: expand: cvs=JumpToCvs, doc=JumpToDoc, search=SearchFor
663            x examples for the JumpToCvs mechanism are shown on <a href="http://netfrag.org/~joko/computing/overview/topics/>computing/overview/topics</a>
664        x tested http://cvs.netfrag.org/ - still working...
665        o AddedFeatures to DispatchRequest:
666          x JumpToNewsgroup: http://news.netfrag.org/nfo.tutos.sysadmin/
667            e.g. ->http://netfrag.org/webnews/thread.php?group=nfo.links.computing
668          o JumpToThread: NotYetImplemented! DoWeReallyNeedThis?
669          o JumpToArticle: http://news.netfrag.org/nfo.sysadmin.tutos/id/b0shbj$l9s$1@quepasa.netfrag.org
670          x JumpToArticle: http://news.netfrag.org/nfo.links.computing/id/44
671            e.g. ->http://netfrag.org/webnews/article.php?id=44&group=nfo.links.computing
672          
673    
674  o NfoWeb  o NfoWeb
675    o add WikiPages:    o add WikiPages:
# Line 601  o viewcvs & yakka Line 697  o viewcvs & yakka
697  o IconForNetfrag.Org?  o IconForNetfrag.Org?
698    o fav.ico?    o fav.ico?
699        
700  x install viewcvs  x --*installed*|install-- viewcvs
701    x apt-get install viewcvs    x apt-get install viewcvs
702      x configured:      x configured:
703        x /var/lib/cvs        x /var/lib/cvs
# Line 612  x install viewcvs Line 708  x install viewcvs
708          x added to '/data/www/virtual/netfrag/conf/applications.conf' in our case          x added to '/data/www/virtual/netfrag/conf/applications.conf' in our case
709        x added '<link href="/horde/css.php?app=chora" rel="stylesheet" type="text/css" />' to '/etc/viewcvs/templates/header.ezt'        x added '<link href="/horde/css.php?app=chora" rel="stylesheet" type="text/css" />' to '/etc/viewcvs/templates/header.ezt'
710    
711  o rendering proposals for TaviWorkflow  o rendering *proposals* for TaviWorkflow
712    o Linking|Referencing (WikiWords, PureExplicitLinkExtrapolation, NamedLinks)    o Linking|Referencing (WikiWords, PureExplicitLinkExtrapolation, NamedLinks)
713    o Coloring    o Coloring
714      o [o=red, x=green, R=red, r=green]      o [o=red, x=green, R=red, r=green]
715    
716  o shortcut: TestApache to run 'apachectl configtest' (WikiForSystemAdministration)  o *shortcut*: TestApache to run 'apachectl configtest' (WikiForSystemAdministration)
717    
718  x web-based newsreader? twig!  x web-based newsreader? twig!
719    x apt-get install twig    x apt-get install twig
# Line 713  o WikiWords in CvsCommitMessages? (via y Line 809  o WikiWords in CvsCommitMessages? (via y
809    
810  x http://cvs.netfrag.org/bareface/yakka/?tarball=1  x http://cvs.netfrag.org/bareface/yakka/?tarball=1
811    
812    o [source:/link/to/source-code]   (most times a '.cvslink' - hmmm?)
813       [source:<projectname>]
814    
815    o HelpMe
816    
817    o [snapshot:/link/to/snapshot]
818       [snapshot:<projectname>]
819    
820    o dispatchrequest - a multipurpose request dispatcher
821      o integrate:
822        x redirector at cvs.netfrag.org ...
823        o ... and news.netfrag.org
824      o JumpToCvs (.cvslink-mechanism)
825      o how was it done?
826        x cd /data/www/virtual/netfrag/sites/webcvs/.dispatch
827        x ln -s /data/www/global/apps/dispatchrequest .
828        
829      
830    o buildhtml -> makedoc
831    
832    o TWIG & yakka?
833    
834    o rename: dispatchmail -> dispatchmessage
835    
836    c rename: dispatchrequest -> forwardrequest?
837    
838    o readrc of bashrc|perlrc|xmlrc
839    
840    x setup TWIG
841      x cd /usr/share/doc/twig
842      x cd /data/www/virtual/netfrag/conf/
843      x nano applications.conf
844      x add line: Alias /twig/ /usr/share/twig/
845      x had to modify /etc/apache/conf/httpd.conf:
846        x added: 'index.php3'
847            <IfModule mod_dir.c>
848                DirectoryIndex index.html index.htm index.shtml index.cgi index.php index.php3
849            </IfModule>
850        x added: '.php3'
851            AddType application/x-httpd-php .php .php3
852        x /etc/init.d/apache reload
853        x cd /etc/twig
854          x modify config.inc.php3
855        x cd /usr/share/twig/setup
856          x mysql
857            x use mysql
858            x insert into user (host, user, password) values ('localhost', 'www-data', password(''));
859            x insert into db values ('localhost', 'twig', 'www-data', 'Y','Y','Y','Y','Y','Y','N','Y','Y','Y');
860            x create database twig;
861            x flush privileges;
862          x database-schema
863            x gunzip twig.table.mysql.gz
864            x mysql twig < twig.table.mysql
865            
866    x setup arbitrary packet and bind to csm-system (Collaborative Software Management)
867      x pinstall twig
868        x apt-get install twig
869        x cd /etc
870        x cvs add twig
871        x cd twig
872        x cvs add *
873        x cvs add .htaccess
874        x cvs commit -m "+ initial commit"
875      
876    
877    o remove html from phpWiki: ('http://'!!!) (->https!!!)
878      <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
879        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
880      <link rel="copyright" title="GNU General Public License" href="http://www.gnu.org/copyleft/gpl.html#SEC1" />
881      <link rel="author" title="The PhpWiki Programming Team" href="http://phpwiki.sourceforge.net/phpwiki/ThePhpWikiProgrammingTeam" />
882    
883    o force https for: (authentication purposes - anonymous is http!)
884      o horde
885      o tutos
886      
887    x dpkg -x twig_2.7.5-4_all.deb tmp/
888    
889    o TWIG & OpenLDAP!?
890    
891    x ApacheMasterLayoutRefactoring: quepasa.netfrag.org:
892      x removed /data/www/doc to /data/www/global/apps
893        x test:
894          x cd /data/www/virtual
895          x grep -ri "/data/www/doc" *
896          x cd /data/www/global
897            x grep -ri "/data/www/doc" *
898            x apps/twiki/
899              x lib/TWiki.cfg
900              x bin/.htaccess
901            x conf/twiki-httpd
902              ---> just change between 'global' and (e.g.) 'virtual/netfrag' for switching between scopes   ;-)
903              ---> the container (folder)-structure at global and sub-virtual level must match almost exactly to make this possible!!!!!
904            x conf/virtualdomains-httpd/
905            x doc/twiki/
906      x removed: /data/www/virtual/netfrag/pub to /data/www/virtual/netfrag/sites/public
907        x cd virtual/netfrag/conf
908          x grep -ri "/pub" *
909            x modify httpd.conf and applications.conf
910      x apachectl configtest
911        Syntax error on line 345 of /etc/apache/httpd.conf:
912        DocumentRoot must be a directory
913        x disabled there completely
914        x now in /data/www/global/conf/httpd.conf
915          DocumentRoot /data/www/virtual/netfrag/sites/public
916      x apachectl configtest
917        fopen: No such file or directory
918        apache: could not open document config file /data/www/conf/twiki-httpd.conf
919        x mv /data/www/global/conf/twiki-httpd.conf /data/www/virtual/netfrag/conf/
920        x nano /data/www/virtual/netfrag/conf/applications.conf to match new path
921      x apachectl configtest
922        fopen: No such file or directory
923        apache: could not open document config file /data/www/conf/tutos-httpd.conf
924        x cd virtual/netfrag
925        x grep -rin "www/conf" *
926        x edit applications.conf:21
927          x was: Include /data/www/conf/tutos-httpd.conf
928          x is: Include /data/www/global/conf/tutos-httpd.conf
929      x apachectl configtest
930        Warning: DocumentRoot [/data/www/virtual/netfrag/sites/webnews] does not exist
931        fopen: No such file or directory
932        apache: could not open document config file /data/www/conf/dynamic.conf
933        x grep -rin webnews *
934          x edit applications.conf:30
935            x was: Alias /webnews/ /data/www/global/apps/newsportal/
936            x is: Alias /webnews/ /data/www/global/apps/newsportal/
937          x edit httpd.conf:74
938            x was: DocumentRoot /data/www/virtual/netfrag/sites/webnews
939            x is: DocumentRoot /data/www/virtual/netfrag/sites/news
940         x cd global/conf
941         x grep -rin www/conf *
942          x STDOUT-PARSE:
943            httpd.conf:14:#Include /data/www/conf/httpd-php-perl.conf
944            httpd.conf:16:#Include /data/www/conf/virtualdomains-httpd.conf
945            httpd.conf:29:Include /data/www/conf/dynamic.conf
946              ->FILE-MODIFY: httpd.conf:29:Include /data/www/global/conf/dynamic.conf
947      x apachectl configtest
948          root@quepasa:/data/www/global/conf# apachectl configtest
949          configuring dynamic domain "golf5.de"
950          configuring dynamic domain "smartmen.de"
951          configuring dynamic domain "ballonflug.de"
952          Syntax OK
953      x /etc/init.d/apache restart
954      x testing "http://netfrag.org/" fails
955      x testing "http://netfrag.org/index.php"
956        x makes redirect to "http://netfrag.org/nfoweb/" but fails there
957      x tail -f tail -f /data/www/virtual/netfrag/log/error_log
958        [Sun Jan 26 15:32:04 2003] [error] [client 217.231.119.195] File does not exist: /data/www/virtual/netfrag/pub/
959        [Sun Jan 26 15:33:02 2003] [error] [client 217.231.119.195] File does not exist: /data/www/virtual/netfrag/pub/
960        [Sun Jan 26 16:37:37 2003] [error] [client 217.231.119.195] Symbolic link not allowed: /data/www/virtual/netfrag/sites/public/nfoweb/
961        [Sun Jan 26 16:38:08 2003] [error] [client 217.231.119.195] Symbolic link not allowed: /data/www/virtual/netfrag/sites/public/nfoweb/
962        [Sun Jan 26 16:40:10 2003] [error] [client 217.231.119.195] Symbolic link not allowed: /data/www/virtual/netfrag/sites/public/nfoweb/
963    
964    
965    o register:
966      public.netfrag.org -> http://netfrag.org
967      secure.netfrag.org -> https://netfrag.org
968      
969    o netfrag.org: DispatchRequest for http://netfrag.org/nfoweb/!
970    o netfrag.org: DispatchRequest for http://netfrag.org/rrr/!
971    
972    o IntroduceMergePoint at http://netfrag.org/doc/
973      o MiniHowto
974      o faqs (e.g. from news://news.netfrag.org/nfo.faq.users
975    
976    o what about an "AUTOSAVE"-feature for UltraEdit when leaving the window or
977      o an AUTOCOMMIT on that very event (maybe integrated with a counter)
978      
979    o write scripts to iterate recursively through directories under specified path ...
980      o ... and do some actions on each directory, e.g.
981      o execute some specified .dot-files (e.g. .pod2htmlrc, .symlinkrc, .makedocrc)
982      
983    x CVSSpam in action:
984      10146 ?        S      0:00 /usr/sbin/sshd
985      10148 ?        S      0:00 /usr/sbin/sshd
986      10149 ?        S      0:00 cvs server
987      10150 ?        S      0:00 cvs server
988      10151 ?        S      0:00 /bin/login
989      10155 ?        S      0:00 /usr/bin/ruby -w /var/lib/cvs/CVSROOT/collect_diffs.rb --to joko@netfrag
990      10158 ?        S      0:00 /usr/bin/ruby /var/lib/cvs/CVSROOT/cvsspam.rb /tmp/#cvs.loginfo.10149.10
991      
992    x as Chora'sStylesheet has come active (by accident) when viewing this file view web
993       we should include this as a fixed default making horde our default stylesheet delivery engine (for now)
994    
995    o link-checker for netfrag.org
996    
997    o dispatcher for style.netfrag.org redirecting to <link href="/horde/css.php?app=chora" rel="stylesheet" type="text/css" />?
998      o styleme.php
999      o brandme.php
1000      
1001    
1002    
1003    o mini-howto: "HttpRedirect"
1004    
1005    o how to refactor the MiniHowtos?
1006      o into a wiki? wikis seem to miss offline/distributed capabilities! (for now)
1007      x into pod
1008        x build offline
1009        o build online
1010      o into DocBook?
1011      o into tavi? (or "TaviWorkflow"?)
1012      o but: LinkWithWikiAutomagically to get everything together
1013        o look at the InterwikiMechanism
1014        o look at the various WikiPluginArchitectures
1015        o look at YakkaDev!
1016    
1017    o a LinkageExample: RenderThis(html4|text|html3|pdf) with [[yakka]] and [[tavi-workflow]]!
1018      o this could mean:
1019        o use the declared formats as output filters for viewing target in other formats / styles
1020    
1021    o proposal for hierarchical structure (and HomePage) of netfrag.org
1022      ~overview -> SomeWiki -> Overview
1023        ~projects (include some common text here)
1024        ~users (include some common text here)
1025          - Page: UserArea
1026          - Page: ~users
1027      ~projects -> SomeWiki-> Projects
1028      ~users (include former page "User area" (now UserArea) automagically at the bottom here! (WikiInclude?))
1029        ~rabit (raBit's router - psl.no-ip.com)
1030        ~natraj (sam's place - optix)
1031        ~joko (joko's)
1032        ~bareface (->yakka)
1033    
1034    o MasterWorkflow:
1035      -> TheThreeGoodThings
1036        -> HaveIdea -> WriteDown (RefactorLater) -> WriteDownMore -> WriteDownAssociations -> WriteDownEvenMoreIfNotStoppedByExternalInfluences
1037        -> RefactorIdeas -> Categorize -> AddNotes -> AddTasks
1038        -> DoThings -> ReadTasks -> DoTasks
1039      -> TheFourthBadThing: TimeTrackAllThis  ;-)  (it seems to be not so far away....)
1040    
1041    o what do we need / what do we do?
1042      --- researcher
1043        o OnlineReading
1044        (o SelectItemsForDownload)  <- want-to-have
1045        (o DownloadItems)  <- want-to-have
1046      --- researcher
1047        o OfflineReading
1048        x ClumsyOfflineReading  <- status-quo
1049          (o NiceOfflineReading)  <- want-to-have
1050          (o OfflineArchiving)  <- want-to-have
1051        o OfflineEditing (text, html, pod, tavi)
1052        o OnlinePublishing (<all - everything what has been rendered or archived offline>)
1053      --- engine
1054        o LiveDispatching (ContentEncoding, ContentConversion, EnvelopeEncapsulation, GatewayToXyz)
1055          o OfflineRendering (html, text, pdf, chm)
1056      --- reader
1057        o OnlineReading (<everything that has been published>)
1058        (o SelectItemsForDownload)  <- want-to-have
1059        (o DownloadItems)  <- want-to-have
1060        o OfflineReading (pdf, chm)
1061    
1062    o link to http://teamsonar.no-ip.com
1063    
1064    o mail announces to announce@netfrag.org
1065    
1066    o no symlinks in webroot anymore? use ApacheAliases?
1067    
1068    o MiniHowto: NfoLinkageSystem(->news.nfo.announce)
1069      o this declaration could mean:
1070        o UseResources:
1071          o look up "NfoLinkageSystem" as subject in newsgroup "news.nfo.announce" on default newsserver
1072        o RenderThisWay:
1073          o embed into document - html3
1074          o embed into document - dhtml (ExpandTree, CollapseTree)
1075          o LinkToIt (JumpToMechanism(->minihowto))
1076    
1077    o php: appcontrol: reads .appcontrolrc-files recursively from directories and adds/removes users or sets passwords
1078        according to specification in there
1079    
1080    o source-code parser which creates documentation with wiki techniques
1081      o pod2tavi -> tavi2html
1082      o phpDoc <- tavi-plugin?
1083    
1084    o integrate yakka and newsportal:
1085      o make a yakka-page of embedded news-articles / threads / thread-parts (a NewsComposition) (->YakkaPageMetadata)
1086        o article-sources
1087          o all items from one news-server
1088          o !!! from different news-servers !!!
1089        o add a "CommentThis"-links to each item when rendering
1090        o when user posts the answer on YakkaEditPage
1091          o make yakka post to the article's associated news-server (read from YakkaItemMetadata)
1092          o wait until new article is published, then ...
1093            o ... add to NewsComposition (update YakkaPageMetadata) (->AsynchronousBackendDaemon)
1094            o ... use/introduce a MetaItem "New" into YakkaPageMetadata (at TopLevel)
1095              which shows NewItems(->self, ->live) per thread or newsgroup
1096      
1097    o download this and that - e.g.:
1098      o phpMyadmin(->archive.software.phpMyAdmin)
1099        o this requires 'archive.software' to have ...
1100          o ... a ListSearchHandler (searches nodelist below 'archive.software' only)
1101          o ... a RecursiveSearchHandler (searches nodelist below 'archive.software' and all subfolders recursively)
1102          o make this available as a ResourceHandler via a DispatchRequest sitting at
1103            o http://netfrag.org/archive/?base=software&search=phpMyAdmin
1104            o http://archive.netfrag.org/
1105    
1106    x rename newsgroup nfo.csm to nfo.caesar (Collaborative And Easy System Management)
1107      x ctlinnd newgroup nfo.caesar
1108      x /etc/init.d/inn stop
1109      x cd /var/spool/news/nfo
1110      x cp csm/* caesar/
1111      
1112      o /usr/lib/news/bin/makehistory
1113      
1114      
1115    o MiniHowto: KerberizedSystem (->~jonen)
1116    
1117    o RefWords -> LookUpDb -> SearchDb
1118    
1119  </pre>  </pre>
1120    
Legend:
Removed from v.1.39  
changed lines
  Added in v.1.69
MailToCvsAdmin">MailToCvsAdmin
 ViewVC Help
Powered by ViewVC 1.1.26 RSS 2.0 feed