☰

使用 LuaLaTeX 和 SQLite3

tag-icon • tag-icon luatex
使用 LuaLaTeX 和 SQLite3

我正在嘗試從 LuaLaTeX 存取 SQLite 資料庫，但無法載入已安裝的lsqlite3套件。到目前為止，這是我嘗試過的：

  1. 安裝了全新的 Xubuntu 14.04
  2. 安裝了完整的 TeX Live 2014
  3. 安裝了Luarocks（順便安裝了Lua5.1）

  4. 使用Luarocks安裝lsqlite3

    uwe@luabuntu:/media/uwe$ luarocks 列表

    安裝的岩石：

    lsqlite3 0.9.1-2（已安裝）-/usr/local/lib/luarocks/rocks

  5. package.path在以下 TeX 文件中附加了以下內容：

    \documentclass{article}    
\usepackage{luacode}

\begin{document}

\begin{luacode*}
  package.path="/usr/local/lib/luarocks/rocks;/usr/local/lib/luarocks/rocks/lsqlite3; 
  /usr/local/lib/lua/5.1/lsqlite3.so" .. package.path

  require("lsqlite3")
\end{luacode*}

Hello Lua!

\end{document}

我收到的錯誤如下：

! LuaTeX error [\directlua]:3: module 'lsqlite3' not found:
  no field package.preload['lsqlite3']
  [luatexbase.loader] Search failed
  [kpse lua searcher] file not found: 'lsqlite3'
  [kpse C searcher] file not found: 'lsqlite3'
  [oberdiek.luatex.kpse_module_loader]-eroux Search failed
stack traceback:
  [C]: in function 'require'
  [\directlua]:3: in main chunk.
\luacode@dbg@exec ...code@maybe@printdbg {#1} #1 }

l.9 \end{luacode*}

必須設定什麼才能讓 LuaLaTeX 找到lsqlite3包？

編輯

我已嘗試根據以下評論調整所有內容：

  1. 調整後/usr/local/texlive/2014/texmf.cnf
  2. 將所有內容放入範例中

  3. lsqlite3使用以下範例仍然會出現有關缺少模組的錯誤

    \documentclass{article}
\directlua{
require "lualoader"
}

\usepackage{fontspec}
\usepackage[english]{babel}
\begin{document}

\directlua{package.path='/usr/local/share/lua/5.1/?.lua;/usr/local/share/lua/5.1/?/init.lua;/home/uwe/.luarocks/share/lua/5.1/?.lua;/home/uwe/.luarocks/share/lua/5.1/?/init.lua;/usr/share/lua/5.1//?.lua;/usr/share/lua/5.1//?/init.lua;./?.lua;/usr/local/share/lua/5.1/?.lua;/usr/local/share/lua/5.1/?/init.lua;/usr/local/lib/lua/5.1/?.lua;/usr/local/lib/lua/5.1/?/init.lua;/usr/share/lua/5.1/?.lua;/usr/share/lua/5.1/?/init.lua'
package.cpath='/usr/local/lib/lua/5.1/?.so;/home/uwe/.luarocks/lib/lua/5.1/?.so;./?.so;/usr/local/lib/lua/5.1/?.so;/usr/lib/x86_64-linux-gnu/lua/5.1/?.so;/usr/lib/lua/5.1/?.so;/usr/local/lib/lua/5.1/loadall.so'
require "lualoader"
}

\directlua{%
local sqlite3 = require("lsqlite3")
local db = sqlite3.open_memory()

db:exec[[
  CREATE TABLE test (id INTEGER PRIMARY KEY, content);

  INSERT INTO test VALUES (NULL, 'Hello World');
  INSERT INTO test VALUES (NULL, 'Hello Lua');
  INSERT INTO test VALUES (NULL, 'Hello Sqlite3')
]]

for row in db:nrows("SELECT * FROM test") do
  tex.print(row.id .. " : ".. row.content )
end

}
\end{document}

答案1

可以修改 中的套件載入機制Lua。在 的情況下LuaTeX，kpse庫用於載入模組，而不是使用package.path和 的預設機制package.cpath。所以設定這些變數不會有任何效果。但是沒有什麼可以阻止我們使用模組來使用這兩種方法Lua，lualoader.lua.將下面的程式碼片段儲存為包含文件的目錄中的檔案：

-- lualoader.lua
-- this is copied from luatexbase.loader
local make_loader = function(path, pos, loadfunc)
  local default_loader = package.searchers[pos]
  local loader = function(name)
    local file, _ = package.searchpath(name,path)
    if not file then
      local msg = "\n\t[lualoader] Search failed"
      local ret = default_loader(name)
      if type(ret) == "string" then
        return msg ..ret
      elseif type(ret) == "nil" then
        return msg
      else
        return ret
      end
    end
    local loader,err = loadfunc(file, name)
    if not loader then
      return "\n\t[lualoader] Loading error:\n\t"..err
    end
    return loader
  end
  package.searchers[pos] = loader
end

local binary_loader = function(file, name)
  local symbol = name:gsub("%.","_")
  return package.loadlib(file, "luaopen_"..symbol)
end

make_loader(package.path,2,loadfile)
make_loader(package.cpath,3, binary_loader)

我們使用該函數在表中的指定索引處插入搜尋或的make_loader函數。對於 lua 文件，對於二進位模組。我們還需要根據模組的類型使用不同的函數來載入模組。我們使用檔案和稍微複雜的函數來使用二進位模組。package.pathpackage.cpathpackage.searchers23loadfileLuapackage.loadlib

例如，我們可以嘗試lsqlite3從以下位置載入LuaTeX：

\documentclass{article}
\directlua{
require "lualoader"
}

\usepackage{fontspec}
\usepackage[english]{babel}
\begin{document}
\directlua{%
local sqlite3 = require("lsqlite3")

local db = sqlite3.open_memory()

db:exec[[
  CREATE TABLE test (id INTEGER PRIMARY KEY, content);

  INSERT INTO test VALUES (NULL, 'Hello World');
  INSERT INTO test VALUES (NULL, 'Hello Lua');
  INSERT INTO test VALUES (NULL, 'Hello Sqlite3')
]]

for row in db:nrows("SELECT * FROM test") do
  tex.print(row.id .. " : ".. row.content )
end

}
\end{document}

使用該標誌運行 LuaLaTeX 非常重要--shell-escape，因為預設情況下二進位庫是被阻止的。您可以使用它--shell-escape執行外部程式並呼叫二進位庫。

此範例產生：

在此輸入影像描述

編輯：

作為烏威指出，luarocks由某些 Linux 套件管理器安裝可能無法正常運作。我在 Fedora 上經歷過這個，所以我luarocks從原始碼安裝。另一種解決方案可能是設定package.path命令package.cpath列出的目錄

luarocks path

在我自己的系統上，這會產生：

$ luarocks path
export LUA_PATH='/home/michal/.luarocks/share/lua/5.2/?.lua;/home/michal/.luarocks/share/lua/5.2/?/init.lua;/usr/local/share/lua/5.2/?.lua;/usr/local/share/lua/5.2/?/init.lua;/usr/share/lua/5.2/?.lua;/usr/share/lua/5.2/?/init.lua;/usr/lib/lua/5.2/?.lua;/usr/lib/lua/5.2/?/init.lua;./?.lua'
export LUA_CPATH='/home/michal/.luarocks/lib/lua/5.2/?.so;/usr/local/lib/lua/5.2/?.so;/usr/lib/lua/5.2/?.so;/usr/lib/lua/5.2/loadall.so;./?.so'

因此修改後的序言將是：

\directlua{    
package.cpath = '/home/michal/.luarocks/lib/lua/5.2/?.so;/usr/local/lib/lua/5.2/?.so;/usr/lib/lua/5.2/?.so;/usr/lib/lua/5.2/loadall.so;./?.so'
package.path = '/home/michal/.luarocks/share/lua/5.2/?.lua;/home/michal/.luarocks/share/lua/5.2/?/init.lua;/usr/local/share/lua/5.2/?.lua;/usr/local/share/lua/5.2/?/init.lua;/usr/share/lua/5.2/?.lua;/usr/share/lua/5.2/?/init.lua;/usr/lib/lua/5.2/?.lua;/usr/lib/lua/5.2/?/init.lua;./?.lua'
require "lualoader"
}

答案2

截至 2017 年 5 月，CTAN 上有一個名為lua套件載入器，它允許您修改 LuaTeX 中的預設包搜尋行為。

載入後luapackageloader，執行 arequire將首先嘗試基於預設 kpse 的搜尋器。如果沒有找到該模組，它也會嘗試從 Lua 的package.path和值載入套件package.cpath。

使用範例

\documentclass{article}    
\usepackage{luacode}
\usepackage{luapackageloader}

\begin{document}

\begin{luacode*}
  package.path="/usr/local/lib/luarocks/rocks;/usr/local/lib/luarocks/rocks/lsqlite3; 
  /usr/local/lib/lua/5.1/lsqlite3.so" .. package.path

  require("lsqlite3")
\end{luacode*}

Hello Lua!

\end{document}

附加說明：您可以eval $(luarocks path)在 shell 上使用環境變數設定包路徑，Lua 解釋器將自動選擇這些變數。這樣，你就不需要擺弄package.path自己了。

答案3

根據評論這個問題，我有以下行/usr/local/texlive/2014/texmf.cnf：

CLUAINPUTS  = .;$SELFAUTOLOC/lib/{$progname,$engine,}/lua//;/usr/lib/{$progname,$engine,}/lua//

但我的luarocks list給定：

Installed rocks:

lsqlite3
   0.9.1-2 (installed) - /usr/lib/luarocks/rocks-5.2

因此您可能需要根據您的安裝調整第二條路徑。

答案4

概括

正在尋找包裹

  • 在普通的Lua中，包是在package.path和中搜尋的package.cpath。

  • 在 LuaTeX 中，預設使用 kpse 搜尋包。

  • 有兩種方法可以修改 LuaTeX 搜尋包的位置

  1. 修改 kpse 的行為

    修改texmf.cnf檔案、變數LUAINPUTS和CLUAINPUTS.

  2. 讓Lua加載自package.(c)path，然後修改那些

    • 使用\usepackage{luapackageloader}，可以在 kpse 和 中搜尋包package.(c)path。

    • 的值package.(c)path可以由使用者在 Lua 代碼本身中手動設置，但是最好設定環境變數例如LUA_PATH，LUA_CPATH.

      如果您eval $(luarocks path)在 bash 中執行，則從該 bash shell 產生的所有進程都會繼承環境變數。

二進位包

  • 如果包裹需要二進位檔案，--shell-escape必須通過。

版本控制

  • 封裝版本必須相容Lua版本。在Lua中執行print(_VERSION)檢查。

    若要指定 luarocks 的特定版本，請執行例如luarocks --lua-version 5.3 path.

相關內容