将标头添加到文件而不更改文件

Question

背景

enscript 命令可以将语法突出显示应用于各种类型的源代码文件，包括 SQL 语句、shell 脚本、PHP 代码、HTML 文件等。我正在使用 enscript 为技术手册生成 300dpi 的源代码图像，以便：

• 根据实际源代码生成书籍内容。
• 源代码与本书一起分发，无需任何修改。
• 在编写本书时运行并测试脚本。

问题

以下 shell 脚本几乎按照需要执行转换：

#!/bin/bash

DIRNAME=$(dirname $1)
FILENAME=$(basename $1)

# Remove the extension from the filename.
BASENAME=${FILENAME%%.*}
FILETYPE=${FILENAME##*.}

LIGHTGRAY="#f3f3f3"

enscript --escapes --color -f Courier10 -X ps -B -1 --highlight=$FILETYPE \
  $2 -h -o - $1 | \
  gs -dSAFER -sDEVICE=pngalpha -dGraphicsAlphaBits=4 -dNOPAUSE -r300 \
  -sOutputFile=$BASENAME.png -dBackgroundColor=16$LIGHTGRAY > /dev/null && \
  convert -trim $BASENAME.png $BASENAME-trimmed.png && \
  mv $BASENAME-trimmed.png $BASENAME.png

问题是背景不是浅灰色。根据 enscript 手册页，--escapes (-e) 选项指示文件（即 $1 code>) 中嵌入了 enscript 特定的控制序列。

添加控制序列意味着必须复制代码，这违背了单一源的目的。

解决

方案 enscript 文档暗示应该可以在运行脚本之前将两个文件连接在一起（目标和“标头”），以创建第三个文件：

^@shade{0.85}                  -- header line
#!/bin/bash                    -- start of source file

然后在执行命令后删除第三个文件完成。

问题

Q.1. 在不使用第三个文件的情况下，将控制序列和源文件通过管道传送到 enscript 程序的更有效方法是什么？ ？

Q.2. 还有哪些其他选项可用于自动突出显示书籍的语法，同时满足我所描述的单一源要求？ （例如，用 LyX 写书并使用 LaTeX 命令进行导入和语法突出显示。）

Answer 1

Q1 您可以使用大括号“{}”进行 I/O 重定向：

{ echo "^@shade{0.85}"; cat $1; } |
enscript --color -f Courier10 -X ps -B -1 --highlight=$FILETYPE $2 -h -o - |
gs -dSAFER -sDEVICE=pngalpha -dGraphicsAlphaBits=4 -dNOPAUSE -r300 \
   -sOutputFile=$BASENAME.png -dBackgroundColor=16$LIGHTGRAY > /dev/null &&
convert -trim $BASENAME.png $BASENAME-trimmed.png &&
mv $BASENAME-trimmed.png $BASENAME.png

这假设 enscript 在未给出显式文件名的情况下读取其标准输入；如果没有，您可能需要使用一个选项（可能是“-i -”）或一些更严重的魔法，甚至可能是 bash 中的“进程替换”。

您还可以使用括号来运行子 shell：

(echo "^@shade{0.85}"; cat $1) | ...

请注意，cat 之后的分号对于大括号来说是必需的，而对于括号则不需要（并且在左大括号之后需要一个空格） - 例如shell 脚本的奥秘。

Q2 我没有任何替代方案可以提供。当我制作一本书时（20 年前，使用 troff），我编写了一个程序将源代码转换为必要的标记，以便这本书是从源代码生成的，但通过自动化过程。

（300 dpi 的分辨率足够高吗？）

编辑

要解决解释转换脚本本身中嵌入的转义序列的 enscript 程序：

{ cat ../../enscript-header.txt $1; } |

Answer 2

Q2：将 LaTeX 与列表 包。