1. Jason McKesson
  2. gltut


gltut / BuildDistro.lua

Will automatically generate all files from the current sources.
Takes three parameters:
- The destination directory, as a relative directory. Will create it if it does not exist.
- The Mercurial revision number to archive to the destination directory.
- The version number of the tutorials.

require "lfs"

local destDir, hgChangelist, versionNum = ...

--local test = {...}
--print(#test, ...)
assert(#({...}) == 3, "Not enough commandline parameters. You provided: " .. #({...}));


-- Use the other Lua script to copy the HTML to the destination.
local CopyWebsite = assert(loadfile("CopyWebsite.lua"));
CopyWebsite(destDir .. "\\html\\");

--Generate the PDF files.

local cwd = lfs.currentdir();
local BuildPrintBW = assert(loadfile("BuildPrintBWFO.lua"));
BuildPrintBW(cwd .. "\\pdfs\\");
local BuildKindleFO = assert(loadfile("BuildKindleFO.lua"));
BuildKindleFO(cwd .. "\\pdfs\\");
local BuildComputerFO = assert(loadfile("BuildComputerFO.lua"));
BuildComputerFO(cwd .. "\\pdfs\\");

-- Copy other files.
os.execute(string.format([[copy "pdfs\TutorialsPrintBW.pdf" "%s\"]], destDir));
os.execute(string.format([[copy "pdfs\TutorialsKindle.pdf" "%s\"]], destDir));
os.execute(string.format([[copy "pdfs\TutorialsComp.pdf" "%s\"]], destDir));

-- Use Mercurial to get a version in the destination directory.
local clone = [[hg archive -r "%s" "%s"]];
clone = clone:format(hgChangelist, destDir);


-- Generate the ancillary files

local readme = io.open(destDir .. "\\readme.txt", "wt");
OpenGL Tutorials, version %s

This is a series of tutorials on using OpenGL to do graphical rendering.
The code for each tutorial is found in the "Tut *" directories. The code
alone is not enough information to understand what is going on. The actual
documentation is available in several forms.

The HTML form of the documentation can be found by opening the "index.html"
file. There are 3 PDF forms of the documentation. TutorialsComp.pdf is a PDF
that uses very thin margins; it is useful for display on computers (or
tablets). TutorialsPrintBW.pdf is a PDF designed for printing on a black-and-white
printer. TutorialsKindle.pdf is a PDF that is sized specifically for the screen
of the Kindle 2.

The source of the documentation is found in the Documents directory. This
source documentation is in the DocBook 5 format. All other formats were
generated automatically from these source files.
]===], versionNum))

local version = io.open(destDir .. "\\version.txt", "wt");
OpenGL Tutorials.

Version %s
, versionNum))

local index_html = io.open(destDir .. "\\index.html", "wt");
<h1>OpenGL Tutorials</h1>
<p><a href="html/index.html">HTML Tutorials</a></p>