我处于一个棘手的位置,必须介绍一些工作,这些工作本来就比他们要适应的工作困难。我想简化这种过渡,可以在我选择的软件中做出明智的选择。我无法强制使用任何特定软件,但我对最终产品负有个人责任,因此我可以使参与此工作流程的其他人越有效,我将做的工作就越少必须自己做。

最基本的需要是不会让孩子们感到恐惧的LaTeX编辑器。我有几个作者,以及一些忙于生成内容的翻译和证明读者。迄今为止,这大部分已在Word中完成。文件已通过电子邮件和USB记忆棒传递。失去跟踪谁拥有最新版本或对旧副本进行编辑,从而使完成的工作繁琐似乎是一件很常规的事情。结果,人们已经保护了自己的计算机及其角色,每个人都试图充当“最新” Word文件的“规范”持有人。当然,这些态度并不能真正解决问题,但是它们将使我难以引入更好的工作流程(至少对于第一个或两个项目而言)。

当作品最终在这种折磨的成长中幸存下来并准备出版时,它会作为Word文件发送到印刷厂。那里有些笨拙的人将其全部转换为可打印的格式,重新排版整个作品(其质量变化很大)并将其发送给印刷厂。不幸的是,最终的编辑,转换和排版通常永远不会使它退缩,因此,即使是作者/版权所有者,我们也没有可以重新发行的最终数字版本。它需要再次被黑客入侵。对于在周期的早期就摆脱困境的作者和翻译来说,这似乎是“容易的”,但是最终结果却是纠结在一起的陈旧项目网络,这些项目无法提供仅凭一本印刷品就能产生的持续价值。

我现在正在接管其中一些最后步骤。为了使自己理智,我尝试在整个使用过程中建议更改用法。简短的版本是我希望所有内容直接创作(或翻译)成LaTeX文件,所有文件处理都必须在Git中进行版本控制。不幸的是,我很清楚,参与这些项目的大多数人都可能将这两种技术的复杂性视为黑魔法。这使我既可以教授又可以支持我建议的任何解决方案。

除非有人抽出一个集成程序包,并且其工作流程铺开了红地毯,但我的计划是限制工作流程(对于除了我自己之外的所有人都可以使用)三个软件:一个git repo管理器,一个带有一些LaTeX smarts(和PDF查看器)的文本编辑器以及一些用于协调的项目管理软件。第一个可能是Gitbox,第二个可能是Gitlab。剩下的就是我要寻找推荐的编辑器。基本要求是:


这些人大多数都使用OSX,因此我更喜欢该平台固有的功能,不仅是小部件的外观,而且还提供了一种整体使用模式,对于那些不喜欢这种功能的人来说,不会太陌生
这些接口应该杂乱无章,有利于需要大量输入而又不停下来确保“代码编译”的作家/翻译者使用。
文件处理应该足够直观,以至于如果我设置每本书git仓库,它们可以轻松创建和编辑* .tex母版文件或* .sty文件,而不必担心* .sty或我放入其中的任何其他东西
应该有最少的LaTeX语法助手。理想情况下,如果有工具栏或我可以对其进行自定义的工具栏,以便对其进行设置,以便仅提供所需的标记选项: br />脚注
粗体/斜体强调


某种基本的预览。这可能不是完整LaTeX编译运行的输出,但应提供足够的视觉反馈,使他们可以确信自己已正确输入数据。
处理非英语文本编码。土耳其语本地化UI是理想的选择,但不是必需的,因为我的大多数用户都可以使用英语。所需要的是,编辑器不要阻塞非英语输入数据,该输入数据几乎全部是土耳其语。文件将需要使用UTF-8编码(并且编译将是LuaLaTex / XeTeX之一)。

是否存在符合这些要求的本机OSX编辑器?如果没有,给定使用目标,哪个最接近?我是否还应该考虑其他解决方案(例如,在Markdown中创作并稍后使用pandoc进行转换,或者使用基于Web的协作式LaTeX编辑器进行转换)?

FOSS解决方案很棒,但我主要是在寻找实用的解决方案。当然,便宜是更好的选择,但是我也愿意为解决方案支付一些现金,该解决方案可以更好地完成工作和/或减少敌人的数量!

#1 楼

我个人建议:


对实际文件使用(downdoc扩展)markdown和pandoc产生最终输出-这将毫无问题地处理UTF-8,并为您提供多种输出格式。标记支持的pandoc扩展

文档元数据(标题,作者,日期);
表;
定义列表; 删除线;
增强的有序列表(起始编号和编号样式很重要);
运行示例列表;
带语法高亮的定界代码块;
智能引号,破折号和省略号; HTML块中的
markdown;内嵌LaTeX。


Markdown编辑器很多,其中一些带有预览功能,许多免费的,或者,当然,个人可以使用自己喜欢的纯文本编辑器,只要它输出纯UTF- 8个文件。
使用mercurial而不是git-我通常认为它更易于使用。
使用pre / commit / cancel按钮进行预提交渲染和查看应该相对容易实现。
同上-推送前。
您甚至可以考虑将推送后的钩子或jenkins服务器以当前状态将所有章节构建到您所有团队都可以查看的位置。

以下是要考虑的要点:


以上均为FOSS工具,因此成本最低。
Markdown是人类可读的-比LaTex /容易得多。
Markdown比许多其他格式对VCS更友好。

如果您不能从Word中除掉贡献者,另一种可能性是使用带有zipdoc扩展名的Mercurial。这将至少让您使用VCS Word文档。

评论


感谢您的见解。我肯定会认真看一下pandoc及其Markdown实现,因为这听起来很有希望。教Markdown比教LaTeX更不可能使我成为敌人!我想我会坚持使用Git,因为我已经可以呼吸Git,并且能够更好地支持它。虽然可以自动执行流程的前/后提交/推送挂钩。实际上,我有类似的想法。

–卡莱布
2014年11月6日下午6:41

#2 楼

您最后提到,您至少对基于Web的协作编辑的想法持开放态度,因此,如果您还没有签出它,我建议您使用writeLaTeX。

它提供了(我的品味)在未启用TeX(包括我在内)和真正的LaTeX功能之间达到了易用性的良好平衡。它可以用作基于浏览器的编辑器,并具有实时预览和相对基本的基于云的存储和协作功能;可以以相对较低的成本获得更高级的项目管理功能。

我对这个站点/服务的介绍是一篇Hacker News帖子,以其(新的)Rich Text模式链接到该writeLaTeX博客文章。