texlab 0.0.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,16 @@
+source "http://rubygems.org"
+
+gem "rake4latex"
+gem "plusminus"
+gem "easystats"
+gem "to_latex"
+gem "gnuplot"
+gem "latex"
+
+group :development do
+  gem "rspec", "~> 2.8.0"
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.8.3"
+  gem "rcov", ">= 0"
+end

data/Gemfile.lock

@@ -0,0 +1,54 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.3)
+    easystats (0.1.0)
+    flt (1.3.0)
+    git (1.2.5)
+    gnuplot (2.4.1)
+    jeweler (1.8.3)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.6.5)
+    knut_tools (0.1.0)
+    latex (0.1.3)
+    log4r (1.1.10)
+    nio (0.2.5)
+      flt (>= 1.0.0)
+    plusminus (0.1.0)
+      nio
+    rake (0.9.2.2)
+    rake4latex (0.1.3)
+      knut_tools
+      log4r
+      rake
+    rcov (1.0.0)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+    to_latex (0.4.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  easystats
+  gnuplot
+  jeweler (~> 1.8.3)
+  latex
+  plusminus
+  rake4latex
+  rcov
+  rdoc (~> 3.12)
+  rspec (~> 2.8.0)
+  to_latex

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Bernát Kalló
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,19 @@
+= texlab
+
+Description goes here.
+
+== Contributing to texlab
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2012 Bernát Kalló. See LICENSE.txt for
+further details.
+

data/README.txt

@@ -0,0 +1,5 @@
+= TEXLAB
+
+TEXLAB is a software toolkit for authoring documents and do complex calculations in the same file. It is based on _latex_, _ruby_, _gnuplot_ and _vim_.
+
+

data/Rakefile

@@ -0,0 +1,50 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "texlab"
+  gem.homepage = "http://github.com/cie/texlab"
+  gem.license = "MIT"
+  gem.summary = %Q{a tool to create documents with latex and ruby}
+  gem.description = %Q{texlab a toolkit based on erb that for creating documents and doing calculations at the same time. It is capable to output the proper number of significant digits, generate tables and plots using gnuplot. It has a simple DSL.}
+  gem.email = "kallo.bernat@gmail.com"
+  gem.authors = ["Bernát Kalló"]
+  gem.executables = ["texlab-compile"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "texlab #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.0

data/bin/texlab-compile

@@ -0,0 +1,48 @@
+#!/usr/bin/env ruby
+# encoding: ASCII-8bit
+
+
+
+
+require 'erb'
+require 'to_latex'
+
+$: << File.expand_path(__FILE__+"/../../lib")
+
+class TEXERB < ERB
+end
+
+begin
+  # load code
+  #
+  infile = ARGV[0] || fail
+  outfile = ARGV[1] || infile.sub(/(\.texlab)?$/, ".tex")
+
+  src = nil
+  File.open infile do |f|
+    src = f.read
+  end
+  fail if !src
+
+rescue
+        STDERR.puts File.basename($0) + " <inputfile> <outputfile>"
+        STDERR.puts <<EOU
+  Compile texlab inputfile to tex. 
+EOU
+
+else
+
+  # load boot code
+  File.open File.expand_path(__FILE__+"/../../lib/texlab/boot.rb") do |f|
+    src = "<%\n" << f.read << "\n%>\n" << src
+  end
+
+  # run erb
+  erb = TEXERB.new(src.untaint, nil, "%>", "$_erbout")
+
+  File.open outfile, "w" do |f|
+    f.print erb.result(TOPLEVEL_BINDING.taint)
+  end
+
+end
+

data/bin/texlab-console

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+
+
+require 'pp'
+
+def get_binding
+  binding
+end
+
+begin
+  # load code
+  src = $<.read
+  fail unless src
+rescue
+        STDERR.puts File.basename($0) + " [inputfile] [ > outputfile]"
+        STDERR.puts <<EOU
+  Debug texlab inputfile in console. 
+EOU
+else
+
+  # load boot code
+  File.open File.expand_path(__FILE__+"/../../lib/texlab/boot.rb") do |f|
+    src = "<%\n" << f.read << "\n%>\n" << src
+  end
+
+  b = get_binding
+
+  # run erb
+  erb = ERB.new(src.untaint, nil, "%>", "$_erbout")
+  $_src = erb.src
+  b.eval $_src + expr
+
+
+  def getline
+    print "texlab> "
+    STDIN.gets
+  end
+
+  # run REPL
+  while s = getline do
+    begin
+      pp b.eval(s)
+    rescue 
+      STDERR << $! << $!.backtrace.join("\n") << "\n"
+    end
+  end
+
+end
+

data/doc/readme.texlab

@@ -0,0 +1,284 @@
+<%
+  documentHeader :usePackages => { 
+    :babel => "magyar", :inputenc=>"utf8" }
+%>
+\begin{document}
+
+
+Helló!
+
+Ez a TEXLAB program rövid leírása.
+
+TEXLAB fájlból először tex fájlt kell csinálni a texlab-compile paranccsal, aztán lehet futtatni pdflatex-szel így:
+
+ruby "......./texlab-compile.rb" "..../a-te-fájlod.texlab" 
+
+pdflatex "....../a-te-fájlod.tex"
+
+
+Ez, amit olvasol, egy TEXLAB fájl. A TEXLAB fájlban Ruby és LaTeX kódok váltogatják egymást. LaTeX kóddal kezdődik, és Ruby módba a kisebb-százalék jelekkel lehet átmenni, illetve a százalék-nagyobb jelekkel visszamenni.
+
+A százalékjelek között lehet ruby parancsokat adni. Az egyik ilyen parancs a documentHeader, amit a fájl elején látsz. Ez elkészíti a LaTeX fájl elejére írandó sorokat A paraméterei:
+
+usePackages: milyen csomagokat használjunk. A babel csomag a nyelvi speciális dolgokat csinálja. Az inputenc-nek kell megadni, hogy milyen formátumú a fájl. Ezeken kívül is jónéhány csomagot alapból betölt.
+
+twocolumn: ha true, akkor kéthasábos lesz a dokumentum
+
+fontsize: "12pt", "11pt" vagy "10pt" (default). a fontméret.
+
+landscape: true esetén a dokumentum fekvő lapon lesz.
+
+
+
+
+
+
+
+
+A másik parancs a puts, ami kiír egy kifejezést:
+
+<% puts "Helló" %>
+
+A sor elején lévő százalékjel is átvisz ruby módba.
+
+% puts ":)"
+
+Ha LaTeX megjegyzést szeretnél írni, akkor sajnos dupla százalékjelet kell írni:
+
+%% Ez egy latex megjegyzés, senki se fogja látni.
+
+A harmadik lehetőség, hogy ha egy Ruby kifejezés értékét szeretnéd betenni a fájlba, akkor a kisebb-százalék-egyenlő jellel kell nyitni:
+
+<%= "Helló" %>
+
+Ez lényegében ugyanolyan, mint a puts.
+
+
+A Rubyban lehet matematikai kifejezéseket írni. Pl. öt meg öt az <%= 5+5 %>. A hatványozás **, a tizedestörtekben pont van.
+
+Tudsz definiálni változókat:
+<% alma = 29*2 %>
+
+Most <%=alma%> darab almánk van.
+
+A konstansok nagybetűvel kezdődnek. Két konstansunk is van, <%= E %> és <%=PI%>. Te is definiálhatsz konstast:
+<% R=8.314 %>
+
+A számokra meg lehet adni a pm (pluszminusz) metódussal hibahatárt: <%= 12.5.pm(0.00005).to_latex%>. Ilyenkor kézzel kell konvertálni Latex képletté a to\_latex metódussal, különben az eredeti szám jelenik meg. Ha puts-t használsz, akkor nem kell, mert automatikusan megcsinálja.
+<% puts 13.5.pm(0.000005) %>
+
+Relatíve is meg lehet adni a hibát <%= 0.5.pm_rel(0.01).to_latex %>
+
+Szép exponenciális alakokat tud csinálni: <%= 0.00000000012.pm_rel(0.01).to_latex%>.
+
+
+
+
+Vannak függvényeink. 90 fok az <%=radians(90)%> radián, ennek a szinusza <%=sin(radians(90))%>. Ha egyértelmű, hogy mit akarsz, akkor nem muszáj kiírni a zárójeleket, hanem írhatod pl., hogy <%=sin radians 90%>. De ha erre nagyon rászoksz, még sok gondot fog okozni :).
+
+Te is definiálhatsz füvvgényeket:
+<% 
+  def cosh(x)
+    (E**x + E**(-x))/2
+  end
+%>
+cosh 4 = <%=cosh(4)%>
+De ez a függvény már amúgy is létezik.
+
+Az adatokat néha érdemes listában tárolni:
+<%
+  adatok = [1,2,3]
+%>
+<%=adatok%>
+
+Ezeken végig lehet menni kétféleképpen is:
+
+<%
+  for a in adatok
+    puts a
+    puts " alma "
+  end
+%>
+
+vagy
+
+<%
+  adatok.each do |a|
+    puts a
+    puts " alma "
+  end
+%>.
+
+Az adatokat néha érdemes hash-ben tárolni:
+
+<%
+  test = {
+    m: 9.1,
+    V: 8.1
+  }
+%>
+A test tömege <%=test.m%>, térfogata <%=test.V%>, sűrűsége <%=test.m/test.V%>.
+
+A program tud számolni hibaterjedést, úgyhogy érdemes megadni minden adatban a hibahatárt, hogy az eredmény szebb legyen:
+
+<%
+  test = {
+    m: 9.1.pm(0.05),
+    V: 8.10.pm(0.02)
+  }
+%>
+A test tömege <%=test.m.to_latex%>, térfogata <%=test.V.to_latex%>, sűrűsége <%=(test.m/test.V).to_latex%>.
+
+
+Táblázatokat lehet csinálni.
+<%
+  table("cím") do
+    row("sorcím") do
+      column("oszlopcím") do
+        "érték"
+      end
+    end
+  end
+%>
+
+Lehet több oszlopot és sort is. A do..end helyett lehet kapcsos zárójelet használni
+<%
+  table("állatok") do
+    row("okos") do
+      column("nagy") { "kutya" }
+      column("kicsi") { "macska" }
+    end
+    row("buta") do
+      column("nagy"){ "bálna" }
+      column("kicsi"){ "egér" }
+    end
+  end
+%>
+
+Lehet több szintű oszlopokat is, de többszintű sorokat (még) nem.
+<%
+  table("adatok") do
+    row("test1") do
+      column("tömeg") do
+        column("előtte"){ 90.0.pm(1) }
+        column("utána"){ 0.00075.pm_rel(0.05) }
+      end
+    end
+  end
+%>
+
+Figyeld meg, hogy a .to\_latex automatikusan megtörténik, tehát itt sem kell kiírni, akárcsak a puts-nál.  Azt is figyeld meg, hogy mindig table, row, column a sorrend az egymásba ágyazásnál.
+
+Érdemes az adatokat ciklusból táblázatba konvertálni:
+<%
+  table("számolás") do
+    adatok.each do |a|
+      row(a) do
+        column("kétszerese") { a*2 }
+      end
+    end
+  end
+%>
+
+A rowTitle opcióval lehet megadni, hogy mi legyen a sarokban. Így lehet csinálni szorzótáblát:
+<%
+  table("Szorzótábla", rowTitle: "x") do
+    (1..10).each do |i|
+      row(i) do
+        (1..10).each do |j|
+          column(j) { i*j }
+        end
+      end
+    end
+  end
+%>
+
+A lehetséges beállítások: \\
+placement: "H" - legyen a táblázat pont itt, és ne külön lapon. \\
+rowTitle: a sarokban mi legyen \\
+a többit lásd http://rubydoc.info/gems/latex/LatexFile:table
+
+Összetett táblázatok:
+<%
+  tables("Táblák") do
+    table("Első") do
+      row("h") do
+        column("valami") {"k"}
+      end
+    end
+    table("Második") do
+      row("x") do
+        column("semmi") {"o"}
+      end
+    end
+  end
+%>
+
+Grafikonok:
+
+<%
+  plot "$x^2$ függvény" do
+    dataset "x**2"
+  end
+%>
+
+Adatpontok:
+<%
+  plot "adatok", xlabel: "$x$", ylabel: "$x^2$"  do
+    dataset do
+      data(0, 0**2)
+      data(1, 1**2)
+      data(2, 2**2)
+      data(3, 3**2)
+      data(4, 4**2)
+      data(5, 5**2)
+    end
+  end
+%>
+
+Illesztés:
+<%
+  a,b = fit "a*x+b", via: "a,b" do
+    dataset do
+      data(0, 0**2)
+      data(1, 1**2)
+      data(2, 2**2)
+      data(3, 3**2)
+      data(4, 4**2)
+      data(5, 5**2)
+    end
+  end
+%>
+$<%=a.to_latex%>x+<%=b.to_latex%>$
+
+Illesztett egyenes a grafikonon:
+<%
+  plot "adatok", xlabel: "$x$", ylabel: "$x^2$"  do
+    dataset do
+      data(0, 0**2)
+      data(1, 1**2)
+      data(2, 2**2)
+      data(3, 3**2)
+      data(4, 4**2)
+      data(5, 5**2)
+    end
+    dataset "#{a}*x+#{b}", title: "illesztett egyenes"
+  end
+%>
+
+Változók használata szövegben: <%= "Helló, #{a}!" %>
+
+
+Makrók:
+
+<%
+  macro kij: "k_{ij}"
+%>
+
+Használata: Latexben: \kij a négyzeten vagy $\kij^2$, rubyban: <%= $kij %> a négyzeten vagy <%= :kij.to_latex %> a négyzeten vagy <%= :kij + "^2" %> vagy <%= "$ #{$kij} ^ 2 $" %> vagy ennek a rövidítése: <%= "$ #$kij ^ 2 $" %>. Szóval mindenféle krix-kraxszal elő lehet hozni.
+
+Az egész csak akkor működik rendesen, ha a makró nevében CSAK BETŰK vannak.
+
+Figyeld meg, hogy a makró automatikusan átmegy math módba, úgyhogy mindegy hogy dollárjelek közé teszed vagy nem. A :kij + valami egy bónusz egyszerűsítés, ez is magától átmegy math módba.
+
+\end{document}