RubyGems - cyberweb - Versions diffs - 0.4.174 → 0.5.225 - Mend

cyberweb 0.4.174 → 0.5.225

Potentially problematic release.

This version of cyberweb might be problematic. Click here for more details.

Files changed (625) hide show

data/doc/todo/TODO_FOR_THE_CYBERWEB_PROJECT.md DELETED Viewed

@@ -1,1089 +0,0 @@
-# =========================================================================== #
-# === TODOs for the Cyberweb Project
-# =========================================================================== #
--------------------------------------------------------------------------------
-(1) Add www-support for the simple widgets project.
-This may take a longer while so before we go to do that, perhaps
-first make libui+ruby-gtk3 support better. Then at a later point
-we can perhaps improve support for simple widgets in the cyberweb
-project.
-------------------------------------------------------------------------------
-(2) - add some way to collect or generate
-       good CSS and re-use them somehow
-also document to other people how this is done.
--------------------------------------------------------------------------------
-(3) -
-require "http/server"
-# === response?
-def response?
-  "Hello world! The time is #{Time.now}"
-end
-server = HTTP::Server.new(8080) { |request|
-  # What to show in response.
-  HTTP::Response.ok "text/plain",
-    response?
-}
-puts "Listening on http://0.0.0.0:8080"
-server.listen
-^^^ add ?time
-or something to display the time.
-^^^ this was now implemented
-document it, test it, and then when it works, remove the entry here.
--------------------------------------------------------------------------------
-(4) - Make a flexible base directory and document it.
-      This should also be set-able via yaml files.
-  perhaps scan:
-    if has_dir? yaml/base_dir.yml
-    end
-then document it, also in FEATURES
-and then upload this.
-^^^ such a file must be allowed to overrule any other setting!
-and work on a per-project basis.
-try_to_use_per_project_settings:
--------------------------------------------------------------------------------
-(5) - write a forum for the web_object-project, in yaml.
-^^^ make this work hmmmm then
-show to the users how to work it
-as a proof-of-concept.
-^^^ and rewrite the project TOO!
-Well this works somewhat. Needs to be improved still.
--------------------------------------------------------------------------------
-(6) - Add openID support. everyone likes openID so lets add that
--------------------------------------------------------------------------------
-(7) - extend jquery examples, like via:
-        https://www.freecodecamp.org/news/the-best-jquery-examples/
-        https://www.w3schools.com/jquery/jquery_examples.asp
-<meta name="DCTERMS.language" content="eng" />
-^^^
-https://terms.tdwg.org/wiki/dcterms:language
--------------------------------------------------------------------------------
-(8) - <meta name="dcterms.created" content="2015-07-21">
-^^^^ this should be supported..
--------------------------------------------------------------------------------
-(7) - consider adding:
-  form.label
-  form.check_box
-  form.text_field
-but think this through first.
--------------------------------------------------------------------------------
-(9) - http://asciimath.org/
-^^^ integrate this.
--------------------------------------------------------------------------------
-(11) - $(document).ready(function(){
-    $("p").click(function(){
-        $(this).hide();
-    });
-});
-^^ add:
-div() {
-}
-on_click_hide('id_here')
-----
-We can animate any element, such as a simple image:
-<div id="clickme">
-  Click here
-</div>
-<img id="book" src="book.png" alt="" width="100" height="123">
-// With the element initially shown, we can hide it slowly:
-$( "#clickme" ).click(function() {
-  $( "#book" ).hide( "slow", function() {
-    alert( "Animation complete." );
-  });
-});
--------------------------------------------------------------------------------
-(9) - investigate charts in javascript
-http://n3-charts.github.io/line-chart/#/home
-https://d3js.org/
-http://smoothiecharts.org/
--------------------------------------------------------------------------------
-(10) add a simple and documented way to convert from csv into
-     table format
-csv_from_file_to_table
-or something liket hat.
-class method
-Cyberweb.
-This has been implemented but not yet documented.
--------------------------------------------------------------------------------
-images_css 'bblack1'
-^^^ in webobject will mean that we have black border 1
-for all images by default
-ENABLE AND DOCUMENT THIS!!!!!!!
-.
--------------------------------------------------------------------------------
-- add more jquery thingies
--------------------------------------------------------------------------------
-- ability to use different CSS templates quickly
-  to change the look and style of any site
--------------------------------------------------------------------------------
--> Ability to generate static html sites.
-   The whole layout should be also put into static html and
-   then upload to a remote host! \o/
--------------------------------------------------------------------------------
-in img:
-  img 'FOO/BAR'
-und wenn es hinter keine Endung .png oder .jpg gibt, dann machen
-wir ein glob und versuchen irgend etwas zu finden.
--------------------------------------------------------------------------------
-- Wir erstellen eine inline .css Datei.
-Die nur genau jene Elemente enthält, die in einer webpage auch vorkommen
-können.
-This already works like:
-   pre found_these_css_classes?.join(''+"\n")
-What is missing is:
-  (a) Fetch all these entries (use a little class, a converter...)
-  (b) put this into a giant string and generate an inline css for this
--------------------------------------------------------------------------------
--> Integriere Sinatra-Funktionalität in WebFoundation, also
-   langsam Sinatra erlernen. Insbesondere das Routing.
--------------------------------------------------------------------------------
-Flexible Menügenerierung:
-Schneiden Sie mit dem grafischen Editor Menüs auf Bedürfnisse von Man-
-^^ allow us to create easy menus (meta menus):
-  menu 'foo','bla','ble'
-^^^ Shall make a menu with an added mouse-over effect.
-screw that - add css-only menus
-add + document them
-remove this here, then upload to rubygems
--------------------------------------------------------------------------------
-# ======================================================================== #
-# This is a clone of Webmin. In addition to what webmin allows, the
-# features of this webmin clone will be manifold, such as the ones
-# that are listed below.
-# ======================================================================== #
-# URL:
-#   localhost/PROGRAMMING_LANGUAGES/RUBY/SRC/cyberweb/lib/cyberweb/webmin_components/webmin.cgi
-# ======================================================================== #
-rf webmin
-# ======================================================================== #
-# FINISHED AND COMPLETED FEATURES FOR THE WEBMIN-CYBERSPRAWL SUBPROJECT.
-# ======================================================================== #
-- Ability to define own tags via web_foundation    [DONE]
-- Show aliases                                     [DONE] (alias tag)
-- Show sys information                             [DONE] (sys tag)
-- Burn an ISO, or, ability to burn an iso, like cdrecord
-  Hmmmm. This can be done via the class:
-    class BurnISO
-  Also make an input formular and checkboxes for that.
-  _ = BurnISO.new(ARGV)
-  _.burn :dvd
-  _.run
-  ^^^ Das geht zwar aber ... das input field ist noch nit so cool.
-      wir sollten das mal über das WebInterface testen.
-- Create an ISO for a linux system using purely the www, then you can
-  dump it somewhere and install your linux distribution. First version
-  is already realized via $RUBY_GLINUX/RModuleMaker.rb but it is
-  not perfect yet. WILL DO THIS LATER, ONCE WHEN SLAX IS MORE
-  STABLE.                               [HALF DONE...hmmm]
-  ADD a formular for this too.
-- Use it to compile a program on your system. [HALF DONE, problems
-                                               with permissions ;< ]
-- Maybe have an IRC Server via the web as well
-  hmm... hmm hmmmmmmmmmm
-- Start webrick                               [DONE but buggy]
-- Allow user comments into a formular, so that they can
-  post feedback etc.. first version into text file.
-                [DONE but could be improved a lot, adding
-                metadata etc to it or use/hookup to a database...]
-- make it so that in something like a mud, we can display
-  information on the www, like number of people etc..
-  You know, kinda helpful admin work. [NOT YET DONE]
-- realize a browser game, similar to TR but simpler.    [NOT YET DONE]
-- add something like quicknote    [NOT YET DONE]
-- extend file viewer... we want to syntax highlight
-  certain tags for instance... in an easy manner [NOT YET DONE]
-- start and stop servers
-- edit apache config files easily [NOT YET DONE]
-- sql browser + sql dump [NOT YET DONE]
-- add/delete users [NOT YET DONE]
-- stats net stuts [NOT YET DONE]
-- be able to login (via cyber_login.rb)    [STARTED BUT NOT YET DONE]
-- Generate spreadsheets via rubyspreadsheet. [HALF DONE]
-- Use the info from install_these_binaries, to tell the user
-  what belongs to which package [NOT YET STARTED BUT A SIMPLE TASK]
-- modify grub file via webmin      [HALF DONE]
-- ability to display screenshots ie. " Show Images:   1-4 | 5-7   "
-  and also thumbnails maybe with external rmagick addons (wtf???)
-  unkie APR 2008:
-     Besser als keine icons zu sammeln wäre es, dass deine sprache
-     bestimmte verzeichnisse einlesen kann und diese bilder nach
-     id oder namen ausgeben kann - evtl auch nach Größe.
--------------------------------------------------------------------------------
-- dig through the php docu and integrate things that seem useful.
--------------------------------------------------------------------------------
-- Work through How2Do and look if we can streamline / integrate stuff.
-  bl how2do; rf how2do
--------------------------------------------------------------------------------
-- Todo bei webmin.cgi überarbeiten/abarbeiten.
-    rf webmin
-    pwdrbsrc
-    cd WWW/cybersprawl
-    bl webmi*
-    bl *bio*
-    bl $RUBY_SRC/www/cybersprawl/cybersprawl_requires.rb
-   ADD html/css colourizer (???)
-   Hmm eventuell das man das ganze ansehen kann farbig...
-   Und auch den biology_server.cgi verbessern - der soll irgendwann so
-   gut sein, das ich quasi ein biologisches Job-Offering damit erfüllen
-   kann/könnte.  rf bioserver
-   Also unter anderem:
-     -> Fasta Search durchführen können
-     -> Postgre und MySQL Anbindung haben (Activerecord ansehen ...)
-   Über weitere Verbesserungen nachdenken, vor allem über Wege, das ganze
-   SCHNELLER zu machen, auch sicherer UND VOR ALLEM FEATURES REINHAUN.
-   Baue ein ruby CMS, so wie trac, für Irgendein Projekt.
-   Einen 1:1 Klon. Am besten für die Gobolinux Scripts und mittels
-   cybersprawl realisieren.
-     http://nanoc.stoneship.org/
-# =========================================================================== #
-# For more things, ask our users so we can adapt to their needs.
-# =========================================================================== #
-(1)
-Das folgende snippet hier macht extra characters
-um die "" quotes herum. Das sollte nit sein:
-   sbr 'Via jumpers you can quickly change to another directory.','','jumpers'
-   s2 'Expressed in another way, jumpers are "'
-   s2 'Bookmarks for Terminals','dodgerblue'
-   sbr '".'
-(2)
- div_fin {} is not working as expected. WHY NOT!
--------------------------------------------------------------------------------
-- add support for erb.
-first extend this on
-todoc: bl erb; rf ruby erb
-then add it.
--------------------------------------------------------------------------------
-- Reach a point where we can simply copy a remote webpage, and transform all
-  of its components into the logic of a local page.
-    bl $CYBERWEB/standalone_classes/turn_html_into_cyberweb.rb
--------------------------------------------------------------------------------
-- fieldset.id = 'bla'
-^^^ Jedes HTML Element, das registriert ist, muss ein OpenStruct sein.
-  class Foo < OpenStruct
-  end
-  foo = Foo.new
-  foo.id = 'This is Foo'
-Aber wieso? Hmmm. Unsure whether to keep this.
-Hmmm.
-Cyberweb.fieldset.id 'ok'
-Eventually sollte das einen default Wert setzen.
-Aber ich weiss nicht...
--------------------------------------------------------------------------------
-propel.targetPackage = lib.model
-propel.packageObjectModel = true
-propel.project = blog
-propel.database = mysql
-propel.database.createUrl = mysql://localhost/
-propel.database.url = mysql://blog:blog@localhost/blog
-propel.mysql.tableType = InnoDB
-^^^ können wir daraus etwas lernen? Ja.
-w.database = mysql
-^^^ verwende mysql database.
-w.database = sqlite
-w.database = postgresql
-yup yup yup.
-Aber was machen wir dann? Wie holen wir daten da raus?
-Noch keine Ahnung.
--------------------------------------------------------------------------------
-extend on dragula, so that we can do fancier stuff
--------------------------------------------------------------------------------
-- Wir brauchen einen weg das letzte Tag anzusprechen. Beispiel:
-  img 'LAYOUT.png','mar8px FLL'
-Dieses Image sollte man dann so verwenden können.
-  last_object.onmousedown = 'dragstart(this)'
-Aber im Moment verwenden wir das gar nit.
-  set_last_tag_used() # bl $CYBER/foundation/tag.rb
-  ^^^ THis will already store the last ID too.
-Ok, seit Dezember 2014 ist es nun möglich das letzte Tag zu verwenden.
--------------------------------------------------------------------------------
-- Feed some class arbitrary html and convert this into
-  cyberweb-conforming generators.
--------------------------------------------------------------------------------
-=== We must redirect output into the web object.
-Perhaps we should do another rewrite, where we write up the default
-tests first. And clean up as we go.
-^^^^
-Let's see:
-w {
-  title 'bla'
-  main_css 'bklablalba'
-  use_jquery
-} # Up until that part this will have stored all stuff
-  # until the <body> tag
-p {
-  h2 'Hello world!'
-}
-^^^ this here must be redirected into the webobject.
-hfin # this is the final trigger that will invoke our object.
-# it is </html>, but it also equal to:
-  web_object.serve
-Also enable PDF Generation via prawn once the above works.
-Combine this then with the web framework above.
-def generate_pdf()
-  pdf = Pdf.new
-end
-WebObject.new
-Prawn..
-require 'prawn'
-Prawn::Document.generate('/Depot/Information/hello.pdf') { |pdf|
-  text("Hello Prawn!")
-}
--------------------------------------------------------------------------------
-- Consider switching to a database-layout and enable a plugin
-  structure with different database-adapters.
-  ^^^ The above should probably also store everything into
-      a database.
--------------------------------------------------------------------------------
-- Try to add activerecord. For this to work, we must first work a
-  bit with activerecord. (And maybe we should try to install rails)
--------------------------------------------------------------------------------
-Sending an email is as simple as using the composeAndSend()
-method from an action:
-$this->getMailer()->composeAndSend(
-  'from@example.com', 'to@example.com', 'Subject', 'Body'
-);
-Find out how to send an email:
-  email.content("bblablabla oder lies von einer datei ein..:").send_to(:mama)
-  ^^^ und das auch in html <form>
-  form
-    input.id("content")
-    input.send_to("content")
-    input.button # click button
-We can try to use the mail gem.
-This can work through sendmail but logically sendmail must exist.
-  http://localhost/PROGRAMMING_LANGUAGES/RUBY/SRC/cyberweb/test/testing_email.cgi
--------------------------------------------------------------------------------
-Anschauen ob man den pretty_url kerl da mit den installable
-URLs installieren kann.
-Kann man, und zwar über url_action.
-Aber da klappt was mit den requires nicht.
-Das sehen wir uns zu einem späteren Zeitpunkt erneut an.
-^^^ Das irgendwie ermöglichen das wir da auch was
-    installieren können.
-^^^ Das geht aber net so ohne weiteres, weil man hierzu
-    die RBT scripts requiren wuss.
-Die funzen zur zeit aber net mit WebFoundation HMMMM.
-Also bevor wir das hier testen können, müssen wir die RBT
-Scripts adaptieren. Die RBT Scripts müssen auch über das
-WWW verwendbar sein!!!!! Das muss dann ein Teil von
-Ruby-Webmin (cybermin) werden, also das Testen.
-^^^ Nein das geht mit Easycompile.
--------------------------------------------------------------------------------
-html { head; body { p { "I'm awesome!" } } }
-^^^ the cyberweb framework should allow this as well
-include Cyberweb
-include HtmlTags
-html { head; body { p { "I'm awesome!" } } }
-Hmmmm.
--------------------------------------------------------------------------------
-Von Markaby lernen heisst siegen lernen -> anschauen was
-man da verwenden kann. Die haben einen HTML Generator
-der brauchbar ist:
-  https://github.com/markaby/markaby
--------------------------------------------------------------------------------
-=== IMPROVE THE FRAMES-CODE PART OF CYBERWEB.
-Right now we can do frames like so:
-  w.frame_left  'foo.cgi'
-  w.frame_right 'bla.cgi'
-  w.use_frames()
-OR:
-  w.use_frames(
-    :left => 'foo.cgi', :right => 'bla.cgi'
-  )
-OR:
-  w.frames(
-      left:  'foo.cgi',
-      right: 'bla.cgi'
-  )
-The problem with that is that we require two more pages here,
-foo.cgi and bla.cgi. This is ok for complicated pages - but
-what if we wish to just use some html in one page?
-We should be able to do this instead:
-  w.frame_left:  '<h2>Some testing</h2><p>Hi folks...
-content missing yet ...</p>'
-Without doing a new page! We want completely dynamic html pages.
-So, we will first check that the above syntax works, and document
-this properly. And when it works, we move on to the next step.
-frameset('30,40') { 'FRAME_LEFT.html,FRAME_RIGHT.html' }
-Hmm. Das klappt, glaube ich... testen, dann entfernen.
--------------------------------------------------------------------------------
-Globally enable drag-all functionality for all images on a webpage.
-By using something like:
-w {
-  enable 'drag_all_images'
-}
-and perhaps...
-  drag_all_images
-directly
-and perhaps:
-  drag 'all_images'
-  drag '+images'
-  drag 'images+'
-This has been enabled, sort of, but it does not work as intended. :(
-Test it, then document it, then upload.
-Irgendwas stimmt da tatsächlich nicht.... ich check das nicht.
--------------------------------------------------------------------------------
-=== Extend Webmin functionality
--------------------------------------------------------------------------------
-Debug Toolbar
-Irgendwann, wenn wir mal WebApps schreiben, machen wir so eine
-Debug Toolbar. Die sollte auch status information anzeigen können.
-Also see:
-  http://django-debug-toolbar.readthedocs.org/en/1.3/panels.html
--------------------------------------------------------------------------------
-Gegeben ist:
-  read_display 'foo'
-Nun wollen wir eine Möglichkeit haben, herauszufinden:
-  (a) Wo diese Methode definiert ist.
-  (b) Den Quellcode der Methode anzuzeigen IN der Webpage.
-debug_method "read_display 'foo'"
-Siehe hierzu die beiden Klassen:
-  method_searcher.rb
-  find_end.rb
-Das geht eigentlich schon über die DiamondShell.
--------------------------------------------------------------------------------
-Factor out:
-  CGI.new.params
-So that we don't depend on ruby-cgi anymore.
-Perhaps as a first step, we will copy all of cgi into cyberweb,
-and then slowly phase it.
--------------------------------------------------------------------------------
-Wenn eine CSS klasse verlinkt wird, sie aber nicht existiert,
-dann reporten wir das im debug mode.
-^^^^^^^^^^^^
--------------------------------------------------------------------------------
-https://github.com/rdoc/rdoc/blob/master/lib/rdoc/encoding.rb#L21-46
-^^^ das is cool... wir sollten das eines Tages implementieren,
-    so ein line highlighting.
-    if params.include?('#') and params.include?('-') and params.include?('L')
-    # Assume a Range.
-Wir sollten das in Teilen implementieren.
-Zuerst einmal alle Zeilen ansehen.
-?show_source
-^^^ add this
-http://localhost/MISC/SITEMAP.cgi?show_source
-Now this works. We have to add some highlight-thingy though.
--------------------------------------------------------------------------------
-- improve on dragula
-dragula([document.getElementById(left), document.getElementById(right)], {
-  moves: function (el, container, handle) {
-    return handle.className === 'handle';
-  }
-});
- ^^^ add handles,
-also perhaps images as these handles
--------------------------------------------------------------------------------
-img 'chemistry/teflon'
-^^^ also enable this here
-so that we don't have to specify the full location.
--------------------------------------------------------------------------------
- - ?sys_information also does not work.
-rf sitemap ?sys_information
--------------------------------------------------------------------------------
-- in cyberweb, find a way to add a special environment so that
-  my variables are also known.
-Cyberweb.add_this_environment_variable(hash_here)
-This method now exists and it also works; we have to generate all
-my variables first before this can work completely.
-This may require another project ... hmmm...
--------------------------------------------------------------------------------
-- finish the cgi? environment
-  right now there is a bug so that does not work.
--------------------------------------------------------------------------------
-Scroll down with a delay through jquery.
-  Add it!
--------------------------------------------------------------------------------
-also ... we need to be able to describe a valid HTML document
-w {
-}
-^^^ the above should give us a full valid HTML document,
-all within the constraints of w {}.
-# =========================================================================== #
-# === W
-#
-# Usage example:
-#   W.new
-# =========================================================================== #
-module Cyberweb
-# =========================================================================== #
-# === w
-# =========================================================================== #
-def w(i = ARGV, &block)
-  @web_object ||= Cyberweb::Webobject.new(i, &block)
-end
-class Webobject # require 'w'; W.new
-  # We store everything into the string()-method here.
-  attr_accessor :string; alias string? string
-  # ========================================================================= #
-  # === initialize
-  # ========================================================================= #
-  def initialize(
-      i = nil,
-      run_already = true,
-      &block
-    )
-    reset
-    set_input(i)
-    if block_given?
-      @block_was_given = true
-      add_to_html_tag '<html><head>
-<meta http-equiv="content-type" content="ttp-equiv; charset=UTF-8" >'
-      instance_eval(&block)
-    end
-    run if run_already
-  end
-  # ========================================================================= #
-  # === title
-  # ========================================================================= #
-  def title(i = 'VIENNA - WIEN')
-    HtmlTags.title(i)
-  end
-  # ========================================================================= #
-  # === reset                                                     (reset tag)
-  # ========================================================================= #
-  def reset
-    @string = ''
-    @block_was_given = false
-  end
-  # ========================================================================= #
-  # === set_input
-  # ========================================================================= #
-  def set_input(i = '')
-    i = i.first if i.is_a? Array
-    i = i.to_s.dup if i
-    @input = i
-  end
-  # ========================================================================= #
-  # === input?
-  # ========================================================================= #
-  def input?
-    @input
-  end
-  # ========================================================================= #
-  # === hfin
-  # ========================================================================= #
-  def hfin
-    HtmlTags.add('</body>'+N,'</html>'+N)
-  end
-  # ========================================================================= #
-  # === to_s
-  # ========================================================================= #
-  def to_s
-    @string
-  end
-  # ========================================================================= #
-  # === add
-  # ========================================================================= #
-  def add(i = nil)
-    @string << i if i
-  end; alias _ add
-  # ========================================================================= #
-  # === run                                                         (run tag)
-  # ========================================================================= #
-  def run
-    add HtmlTags[] # Obtain all elements that were stored in HtmlTags.
-    if @block_was_given and !@string.include?('</html>')
-      add hfin
-    end
-  end
-  # ========================================================================= #
-  # === add_to_html_tag
-  # ========================================================================= #
-  def add_to_html_tag(i = '<head>')
-    HtmlTags.add(i)
-  end
-  # ========================================================================= #
-  # === sbody
-  #
-  # Start of body tag.
-  # ========================================================================= #
-  def sbody
-    add_to_html_tag '</head><body>'
-  end
-end; end
-if __FILE__ == $PROGRAM_NAME
-  include Cyberweb
-  result = w {
-    title 'joe'
-    sbody
-    h2 'Yo there'
-    h3 'Ok there'
-  }
-  e result
-end # w.rb
-# bar = Bar.new # But we want foo to add into @string.
-# e bar.string
--------------------------------------------------------------------------------
-FS_BIGGER
-^^^ when a CSS class is not found, report it.
-This exists now in the file:
-    all_css_classes.rb
--------------------------------------------------------------------------------
-add support for gettext
-  http://sevenseacat.net/
-An introduction to I18n with Gettext
-Gettext is an established standard for doing i18n and l10n in any
-kind of applications, not just web applications. So how does it work?
-In your template files, you can now use the helper function gettext
-to mark where translated text should go. If you've generated a new
-Phoenix app using Phoenix 1.1, an example of this will already be
-done in web/templates/page/index.html.eex -
-  <h2><%= gettext "Welcome to %{name}", name: "Phoenix!" %></h2>
--------------------------------------------------------------------------------
-- clone the functionality of webmin
--------------------------------------------------------------------------------
-- we need to add:
-  on_mouse_hover:
-     bg: orange
--------------------------------------------------------------------------------
-- we must be able to play local video files
--------------------------------------------------------------------------------
-https://jqueryui.com/resizable/
-add support for resizable; when this is done,
-perhaps move one down the line from
-there adn continue
-would be nice to have all of jquery supported.
-https://jqueryui.com/resizable/
-^^^ take this example
--------------------------------------------------------------------------------
-javascript charts
-- start with google charts, but branch out to other charts lateron as well.
- This sorta works but we have to continue this, then add docu.
- https://developers.google.com/chart/interactive/docs/quick_start
--------------------------------------------------------------------------------
- # self.append_to_tables << result if result # Store the result in our Tables.
- ^^^ this does not work no clue why not
--------------------------------------------------------------------------------
-import io.kweb.*
-import io.kweb.dom.element.*
-fun main(args : Array<String>) {
-  Kweb(port = 8091) {
-    doc.body.new {
-      p().text("Hello world with Kweb!")
-    }
-  }
-  ^^^ das p.text('FOOBAR')
-  ist interessamnt
-  überlegen ob wir das in html tags oder cyberweb integrieren
-  sollten - eher in cyberweb, so das html_tags clean bleibt.
--------------------------------------------------------------------------------
-be able to read up a .html page and
-"convert" it into a .cgi page;
-including the option to dump the html again,
-including sanitiziation
--------------------------------------------------------------------------------
-add a html->markdown converter
--------------------------------------------------------------------------------
-write a webforum, simple one with
-yaml files first
-and /tmp or so
-a temp dir
-^^^ document if we have a temp dir and where it it is as well
--------------------------------------------------------------------------------
-https://wiki.gentoo.org/wiki/Portage
-steal the tip-box there
--------------------------------------------------------------------------------
-The fancy popup thingy, that we ingegrated into studium -. also somehow
-generate this via cyberweb hmmmmm.
-Cyberweb.popup_widget(text: 'bla bla bla')
-^^^ add balloon thingy to cyberweb
-+ documentation
-AND a way to use Cyberweb.return_balloon
-or something like that to returh a stylesheet or so
--------------------------------------------------------------------------------
-15) build a big CSS string that is then displayed. perhaps
-   also store it into some file or so. Or at the least
-   offer that possibility to save it.
-   ^^^ Well ... storing has to be re-thought.
--------------------------------------------------------------------------------
-- search for web-related projects on rubygems.
--------------------------------------------------------------------------------
-(16) Make sure that gathering all CSS classes works properly.
--------------------------------------------------------------------------------
-(17) make sure that a HTML-dumper works. It does via the
-.save functionality but perhaps we have to simplify the
-API and add a standalone bin/ file for that functionality.
-And check the documetnation.
--------------------------------------------------------------------------------
-(18) continue objectified tags and add a table to the docu to
-     explain which variants are objectified already.
-     Add them all.
-     ^^^^ Not sure whether all will be added or not. At one
-     point in the future we should also join to an OOP
-     variant of the www.
--------------------------------------------------------------------------------