CTAN sync 202106040302

81 files changed, 2467 insertions, 466 deletions

diff --git a/macros/latex/contrib/bjfuthesis/README.md b/macros/latex/contrib/bjfuthesis/README.md
index 1be1a5d023..fa2538417a 100644
--- a/macros/latex/contrib/bjfuthesis/README.md
+++ b/macros/latex/contrib/bjfuthesis/README.md
@@ -1,7 +1,7 @@
 # 北京林业大学 (BJFU) 毕业论文模板 (LaTeX)
 Copyright (C) 2021 Liu Changxin
 
-Version 1.0.0 (2021-05-30)
+Version 1.0.1 (2021-06-03)
 
 ## Abstract
 The bjfuthesis class is a LaTeX document class intended for students in Beijing Forestry University (BJFU) to write their theses. It follows the thesis specification of Beijing Forestry University.
diff --git a/macros/latex/contrib/bjfuthesis/bjfuthesis.cls b/macros/latex/contrib/bjfuthesis/bjfuthesis.cls
index 5395edcc24..ed02764f98 100644
--- a/macros/latex/contrib/bjfuthesis/bjfuthesis.cls
+++ b/macros/latex/contrib/bjfuthesis/bjfuthesis.cls
@@ -41,6 +41,8 @@
 \setlength\footskip{10mm}
 \setlength\textwidth{155mm}
 \setlength\oddsidemargin{4.6mm}
+\setlength{\fboxsep}{0pt}
+\setlength{\fboxrule}{1pt}
 \setmainfont{Times New Roman}
 \setCJKmainfont[AutoFakeBold]{SimSun}
 \setCJKmonofont{SimSun}
diff --git a/macros/latex/contrib/bjfuthesis/example/contents/abstract.tex b/macros/latex/contrib/bjfuthesis/example/contents/abstract.tex
index 71627e7e3f..7e116d91e5 100644
--- a/macros/latex/contrib/bjfuthesis/example/contents/abstract.tex
+++ b/macros/latex/contrib/bjfuthesis/example/contents/abstract.tex
@@ -2,13 +2,13 @@
 \begin{abstract}
 	随着在线电影数量不断增加，用户选择电影的时间成本不断上升，准确的推荐算法成为了必然要求。为解决协同过滤推荐算法中的稀缺性问题与冷启动问题，研究人员用商品属性或社交网络等信息来辅助推荐算法。现有的将知识图谱作为辅助信息的推荐算法包括基于嵌入的方法和基于路径的方法，但这两种方法均存在一些缺陷，没有充分有效地利用知识图谱中的相关信息，推荐的准确度较低。
 	
-	本文设计并实现了基于“涟漪网络”知识图谱的推荐算法。“涟漪网络”算法的核心是利用现实生活中的雨滴产生的涟漪在水面上不断扩散的思路，来模拟用户偏好的扩散。对于每一个用户，涟漪网络将其过往偏好作为知识图谱中的一个种子集，然后沿知识图谱中的关系路径不断地拓展用户的偏好，进而发现基于等级划分的某个候选物品的潜在兴趣，其中多个“涟漪”重叠形成知识图谱中的用户偏好分布。该算法的实验结果和以往的CKE、DKN、PER等模型结果相比，表现出更优的性能。利用该算法，本文设计并实现了一个基于电影知识图谱的推荐系统，该系统包括管理员用户和普通用户，管理员能够新增、编辑和删除电影与用户，普通用户能够浏览、收藏与购买电影。该系统可以为用户提供一个高效的电影推荐功能，方便用户选择满足自己偏好的电影。
+	本文实现了基于“涟漪网络”知识图谱的推荐算法。“涟漪网络”算法的核心是利用现实生活中雨滴产生的涟漪在水面上不断扩散的思路，来模拟用户偏好的扩散。对于每一个用户，涟漪网络将其过往偏好作为知识图谱中的一个种子集，然后沿知识图谱中的关系路径不断地拓展用户偏好，进而发现该用户对某个候选物品以等级划分的潜在兴趣，其中多个“涟漪”重叠形成知识图谱中的用户偏好分布。该算法的实验结果和以往的CKE、DKN、PER等模型结果相比，表现出更优的性能。利用该算法，本文设计并实现了一个基于知识图谱的电影推荐系统，该系统包括管理员用户和普通用户，管理员能新增、编辑和删除电影与用户，普通用户能浏览、收藏与购买电影。该系统可以高效准确地为用户推荐电影，方便用户选择满足自己偏好的电影。
 \end{abstract}
 \keywordscn{知识图谱，推荐系统，涟漪网络，用户偏好，电影商店}
 \chapter*{Abstract}
 \begin{abstract}
 	As the number of online movies continues to increase and the time cost for users to choose movies continues to rise, accurate recommendation algorithms have become an inevitable requirement. In order to address the scarcity and cold start problem of collaborative filtering, researchers usually make use of side information, such as product attributes or social networks as side information to assist the recommendation. The existing recommendation algorithms that use knowledge graph as side information include embedding-based methods and path-based methods, but both methods have some shortcomings. They do not make full and effective use of the relevant information in the knowledge graph, and the accuracy of recommendation is relatively low.
 	
-	This paper designs and implements a recommendation algorithm based on Ripple Network. The core of the Ripple Network algorithm is to use the idea that the ripples produced by raindrops in real life continue to spread on the water surface to stimulate the spread of user preferences. For each user, Ripple Network uses its past preference as a seed set in the knowledge graph, and then continuously expands the user’s preferences along the relationship path in the knowledge graph, and then discovers his hierarchical potential interests concerning a certain candidate item. Multiple ``ripples" overlap to form the user preference distribution in the knowledge graph. Compared with previous model results of CKE, DKN, PER, etc., the experimental results of this algorithm show better performance. Using this algorithm, this paper designs and implements a recommendation system based on the movie knowledge graph. The system includes administrator users and general users. The administrator can add, edit and delete movies and users, and general users can browse, collect and purchase films. The system can provide users with an efficient movie recommendation function, which is convenient for users to choose movies that suit their preferences.
+	This paper implements a recommendation algorithm based on Ripple Network. The core of the Ripple Network algorithm is to use the idea that the ripples produced by raindrops in real life continue to spread on the water surface to stimulate the spread of user preferences. For each user, Ripple Network uses its past preference as a seed set in the knowledge graph, and then continuously expands the user’s preferences along the relationship path in the knowledge graph, and then discovers his hierarchical potential interests concerning a certain candidate item. Multiple ``ripples" overlap to form the user preference distribution in the knowledge graph. Compared with previous model results of CKE, DKN, PER, etc., the experimental results of this algorithm show better performance. Using this algorithm, this paper designs and implements a recommendation system based on the movie knowledge graph. The system includes administrator users and general users. The administrator can add, edit and delete movies and users, and general users can browse, collect and purchase films. The system can provide users with an efficient movie recommendation function, which is convenient for users to choose movies that suit their preferences.
 \end{abstract}
 \keywordsen{Knowledge graph, recommendation system, Ripple Network, user preferences, movie store}
diff --git a/macros/latex/contrib/bjfuthesis/example/contents/acknowledge.tex b/macros/latex/contrib/bjfuthesis/example/contents/acknowledge.tex
index bfccc876b4..73f28999e0 100644
--- a/macros/latex/contrib/bjfuthesis/example/contents/acknowledge.tex
+++ b/macros/latex/contrib/bjfuthesis/example/contents/acknowledge.tex
@@ -1,5 +1,5 @@
 \chapter{致谢}
-论文的撰写工作已经接近尾声，在本文的撰写过程中我要特别感谢李冬梅老师的莅临指导。在毕业论文完成期间，李冬梅老师多次对我的毕业论文提出意见与建议。同时，她多次询问论文的撰写进度，更是体现了她对学生无微不至的关怀。每每当我在论文编写中遇到艰深晦涩之处时，她都能不失时机而恰到好处地给予我最有用的提示与建议，使我的毕业论文得以顺利完成。
+论文的撰写工作已经接近尾声，在本文的撰写过程中我要特别感谢李冬梅老师的指导。在毕业论文完成期间，李冬梅老师多次对我的毕业论文提出意见与建议。同时，她多次询问论文的撰写进度，更是体现了她对学生无微不至的关怀。每每当我在论文编写中遇到艰深晦涩之处时，她都能不失时机而恰到好处地给予我最有用的提示与建议，使我的毕业论文得以顺利完成。
 
 其次，我要感谢我本科期间曾经为我上课的所有老师。比如，由我的概率论老师为我打下的数学基础才使我得以用最大后验概率估计法完成嵌入表示的学习算法，蓝海洋老师任教的网站设计课程是我完成电影推荐系统的基石。总之，我要感谢大学四年来所有老师孜孜不倦的谆谆教诲与夜以继日的无私奉献。
 
diff --git a/macros/latex/contrib/bjfuthesis/example/contents/mainbody.tex b/macros/latex/contrib/bjfuthesis/example/contents/mainbody.tex
index 055e7b1de6..2b8ff0cb50 100644
--- a/macros/latex/contrib/bjfuthesis/example/contents/mainbody.tex
+++ b/macros/latex/contrib/bjfuthesis/example/contents/mainbody.tex
@@ -1,53 +1,51 @@
 \chapter{绪论}
 \section{研究背景与意义}
-一直以来，电影推荐都是在线流媒体播放平台发展中的一个重要问题，做好电影推荐可以使用户能在海量电影中选择满足其偏好的电影，提高用户满意度，从而提高在线流媒体播放平台的流量转化率及购买率，提高在线流媒体播放平台的经济收益。近年来，随着电影行业及互联网行业的不断发展，在线电影数量不断增加，用户在海量电影中选择满足其偏好的电影的难度不断上升，性能优异的推荐算法成为了必然要求。自从在线流媒体播放平台出现以来，人们便开始尝试利用推荐算法来提高平台流量转化率，出现了诸如协同过滤的推荐算法\cite{su2009survey}。但这些算法未能解决数据稀缺性及冷启动问题，并不能为在线流媒体播放平台提供良好的推荐性能。为此，人们尝试将辅助信息融入推荐算法中以解决数据稀缺性及冷启动问题\cite{sun2017collaborative}，并提高推荐性能。
+一直以来，电影推荐都是在线流媒体播放平台发展中的一个重要问题，做好电影推荐可以使用户能在海量电影中选择满足其偏好的电影，提高用户满意度，从而提高在线流媒体播放平台的流量转化率及购买率，并最终提高在线流媒体播放平台的经济收益。近年来，随着电影行业及互联网行业的不断发展，在线电影数量不断增加，用户在海量电影中选择满足其偏好的电影的难度不断上升，性能优异的推荐算法成为了必然要求。自从在线流媒体播放平台出现以来，人们便开始尝试利用推荐算法来提高平台流量转化率，出现了诸如协同过滤的推荐算法\cite{su2009survey}。但这些算法未能解决数据稀缺性及冷启动问题，并不能为在线流媒体播放平台提供良好的推荐性能。为此，人们尝试将辅助信息融入推荐算法中以解决数据稀缺性及冷启动问题\cite{sun2017collaborative}，并提高推荐性能。
 
-知识图谱，一种结构化的语义知识库，被用于迅速提供对物理世界中的概念和相互关系的描述，为解决推荐问题提供了新的方法\cite{zou2020survey}，近年来受到国内外研究人员的广泛关注，成为了当前的研究热点。知识图谱通过对复杂的原始数据进行加工、处理及整合，转化成简单可靠、清晰明了的“实体，关系，实体”三元组，汇聚了大量的知识信息，从而能实现基于知识信息的响应和推理。
+知识图谱是一种结构化的语义知识库，被用于迅速提供对物理世界中的概念和相互关系的描述，为解决推荐问题提供了新的方法\cite{zou2020survey}，近年来受到国内外研究人员的广泛关注，成为了当前的研究热点。知识图谱通过对复杂的原始数据进行加工、处理及整合，转化成简单可靠、清晰明了的“实体，关系，实体”三元组，汇聚了大量的知识信息，从而能实现基于知识信息的响应和推理。
 
 知识图谱常被用于作为辅助信息添加至推荐算法中以提高推荐的准确性，这已是当前的研究焦点。
 
-近年来，随着在线流媒体播放平台的发展，电影推荐系统应运而生，它作为现代信息技术与传统电影产业相结合的产物，对流媒体播放平台的用户体验起着至关重要的作用，其可大幅度减少用户寻找满足其偏好电影的时间，并提高用户点击率与购买率，从而提高流媒体播放平台的经济收益。电影推荐系统能为用户推荐其感兴趣的电影，而减少对用户不感兴内容的显示，从而满足用户需求。但是，目前网络上绝大多数的电影推荐系统都使用传统的基于协同过滤的推荐算法，未能有效利用知识图谱等辅助信息，返回给用户的推荐结果中包含大量用户不感兴趣的电影，同时，却将一些本应推荐给用户的、用户感兴趣的电影丢弃了。造成这一问题的主要原因便是对于新加入的无用户评分的电影以及新注册的用户推荐算法缺少相关信息。
+近年来，随着在线流媒体播放平台的发展，电影推荐系统应运而生，它作为现代信息技术与传统电影产业相结合的产物，对流媒体播放平台的用户体验起着至关重要的作用，其可大幅度减少用户寻找满足其偏好电影的时间，并提高用户点击率与购买率，从而提高流媒体播放平台的经济收益。电影推荐系统能为用户推荐其感兴趣的电影，而减少对用户不感兴趣内容的显示，从而满足用户需求。但是，目前网络上绝大多数的电影推荐系统都使用传统的基于协同过滤的推荐算法，未能有效利用知识图谱等辅助信息，返回给用户的推荐结果中包含大量用户不感兴趣的电影，此外，还将一些本应推荐给用户的、用户感兴趣的电影丢弃了。造成这一问题的主要原因是推荐算法缺少有关新加入的无用户评分的电影以及新注册的用户的信息。
 
-对于海量的电影数据，为了实现准确地推荐给用户其感兴趣的电影，传统的基于协同过滤的推荐算法是远远满足了不用户需求的，特别是对新注册用户，推荐的准确度无法得到保证。所以，本文旨在以知识图谱作为辅助信息，构建一个合适的电影推荐系统，并利用知识图谱中包含的丰富的辅助信息，最终实现一个电影推荐系统，为用户提供有效的、准确的电影推荐，从而提高用户满意度，提高平台收益。
+对于海量的电影数据，为了实现准确地推荐给用户其感兴趣的电影，基于协同过滤的传统推荐算法是满足了不用户需求的，特别是对新注册用户，推荐的准确度无法得到保证。所以，本文旨在以知识图谱作为辅助信息，构建一个合适的电影推荐系统，并利用知识图谱中包含的丰富的辅助信息，最终实现一个电影推荐系统，为用户提供有效的、准确的电影推荐，从而提高用户满意度，提高平台收益。
 \section{国内外研究现状}
 \subsection{推荐系统研究现状}
-推荐系统由Jussi Karlgren于哥伦比亚大学在一份技术报告中作为“数字书架”被首次提及\cite{karlgren1990algebra}，而后自1994年起被在SICS的Jussi Karlgren\cite{karlgren1994newsgroup}、由Pattie Maes于MIT领导的研究团队、位于Bellcore的Will Hill以及同样位于MIT的Paul Resnick规模实现并在技术性报告及出版物中起作用，他们与GroupLens的工作被授予了2010年ACM软件系统奖。
+推荐系统由Jussi Karlgren于哥伦比亚大学在一份技术报告中以“数字书架”的名称被首次提及\cite{karlgren1990algebra}，而后自1994年起被在SICS的Jussi Karlgren\cite{karlgren1994newsgroup}、由Pattie Maes于MIT领导的研究团队、位于Bellcore的Will Hill以及同样位于MIT的Paul Resnick大规模实现并在技术性报告及出版物大量出现，以上人员与GroupLens的工作被授予了2010年ACM软件系统奖。
 
-自从在90年代中期首批有关协同过滤的论文出现后推荐系统便成为了重要的研究领域。在工业界与学术界在该世纪有众多建设新的推荐系统的工作。由于该领域包含众多的研究问题及其能帮助用户解决在过多信息中提供个性化推荐的实际应用，因此研究人员对该领域的兴趣依旧很高。
+自从在90年代中期首批有关协同过滤的论文出现后推荐系统便成为了重要的研究领域。工业界与学术界出现了众多有关建设新的推荐系统的工作。由于该领域包含众多的研究问题及其能帮助用户解决在过多信息中提供个性化推荐的实际应用，因此研究人员对该领域的兴趣依旧很高。
 
-当前，推荐列表在推荐系统将其产生的过程中的方式主要有两种：基于内容推荐与协同过滤\cite{jafarkarimi2012naive}。基于内容推荐的算法使用一些有关物品的离散特征来推荐出拥有相似性的物品。协同过滤方法根据用户的历史行为（诸如其评价过的、点击过的、购买过的商品等）并与其他用户的相似决策结合起来建立模形。这种算法可以被用于预测用户对物品的偏好程度。这两种方法常常被同时使用。
+当前，推荐列表在推荐系统将其产生的过程中的方式主要有两种：基于内容推荐与协同过滤推荐\cite{jafarkarimi2012naive}。基于内容推荐的算法使用一些有关物品的离散特征来推荐出拥有相似性的物品。协同过滤方法根据用户的历史行为（诸如其评价过的、点击过的、购买过的商品等）并与其他用户的相似决策结合来建立模形，这种算法可以被用于预测用户对物品的偏好程度。这两种方法常常被同时使用。
 
-此外，近来有越来越多的推荐算法被提出：多准则推荐系统。多准则推荐系统可以被定义为包含多标准偏好信息的推荐系统，而不是构建基于单一凭据的推荐系统。风险感知推荐系统，现存推荐系统的主要方法聚焦于基于上下文信息推荐最相关内容给用户，而没有将不相关内容打扰用户的推荐风险纳入考量。考虑推送推荐内容给用户而打扰用户的风险在某些情况下是需要考虑的，比如，在一个专业会议上、在凌晨或是在晚上。而此类推荐算法为该问题提供了解决方案。
+此外，近来有越来越多的推荐算法被提出：多准则推荐系统。多准则推荐系统可以被定义为包含多标准偏好信息的推荐系统，而不是构建基于单一凭据的推荐系统。风险感知推荐系统，现存推荐系统的主要方法聚焦于基于上下文信息推荐最相关内容给用户，而没有将不相关内容打扰用户的推荐风险考虑在内。考虑推送推荐内容给用户而造成打扰用户的风险在某些情况下是需要考虑的，比如，在一个工作会议上或是在凌晨或是在晚上。而此类推荐算法为该问题提供了解决方案。
 
-现实中，大量使用的往往是混合推荐系统。同时结合协同过滤、基于内容过滤以及其他方法的混合方法现在被大量使用。数种不同方法没有任何理由不能被结合起来。混合推荐可以在多种方式下被实现：将基于内容的和基于协同滤的预测被分开实现再将他们将合起来，亦或是将两种方法统一到同一模型中。
+现实中，大量使用的往往是混合推荐系统。其同时结合了协同过滤、基于内容过滤以及其他方法，这种混合式的推荐方法现在被大量使用。混合推荐可以在多种方式下被实现：将基于内容的和基于协同滤的预测模型被分开实现再将他们结合起来，亦或是将两种方法统一到同一模型中并一同实现。
 \subsection{知识图谱的研究现状}
-在知识表示与知识推理中，知识图谱是一个使用图结构的数据模型或拓扑结构的知识库来整合数据。知识图谱常被用来存储内连接的对实体的描述——对象、事件、情形或抽象概念，并包括自由形式的语义。
+在知识表示与知识推理中，知识图谱是一个使用图结构的数据模型或拓扑结构的知识库。知识图谱常被用来存储基于内连接的对实体的描述——对象、事件、情形或抽象概念，并包括自由形式的语义。
 
-该词汇早在1972年在一个有关构建模块化指令系统的课程中被提出。在80年代末，名叫知识图谱的项目主要聚焦于语义网络的设计。在2007年，DBpedia和Freebase作为基于图的有关常识的知识库被创立。DBpedia致立于从Wikipedia中抽取数据，而Freebase也包含一系列公开的数据集。它们两者都未将自己称为“知识图谱”但构建并描述了其相关概念。
+该词汇最早在1972年于一个有关构建模块化指令系统的课程中被提出。在80年代末，命名为知识图谱的项目主要聚焦于语义网络的设计。在2007年，DBpedia和Freebase作为基于图的常识性知识库被创立。DBpedia致力于从Wikipedia中抽取数据，而Freebase也包含一系列公开的数据集。它们两者都未将自己称为“知识图谱”，但实则构建并描述了有关知识图谱的相关概念。
 
-在2012年，谷歌正式提出了知识图谱的概念\cite{singhal2012introducing}，建立于DBpedia和Freebase以及其他数据源的基础之上。他们后来将包括CIA World Factbook, Wikidata和Wikipedia的网站的RDFa, Microdata, JSON-LD内容从它们的索引网站上抽取并纳入知识图谱。与知识图谱相关联的实体与关系类型使用来自scheme.org的术语被更广泛地被组织起来。
+在2012年，谷歌正式提出了知识图谱的概念\cite{singhal2012introducing}，并构建了基于DBpedia和Freebase以及其他数据源的谷歌知识图谱。他们后来将包括CIA World Factbook, Wikidata和Wikipedia的网站的RDFa, Microdata, JSON-LD内容从它们的索引网站上抽取并纳入知识图谱。与知识图谱相关联的实体与关系类型使用来自scheme.org的术语被更广泛地组织了起来。
 
-谷歌的知识图谱非常重要的一块是“自由库”，一个大型的协同工作知识库。“自由库”使用图结构作为其数据结构，可以将其视作一个有向图。谷歌知识图谱模型便是谷歌团队利用其在“自由库”之上的技术积累开发出来的\cite{漆桂林2017知识图谱研究进展}。
+谷歌知识图谱中非常重要的一项是“自由库”，它是一个大型的协同工作知识库。“自由库”使用图结构作为其数据结构，可以将其视作一个有向图。谷歌知识图谱模型便是谷歌团队利用其在“自由库”之上的技术积累开发出来的\cite{漆桂林2017知识图谱研究进展}。
 
-自此，数个大型跨国公司开始利用它们的知识图谱，很快知识图谱流行起来。
-
-在2019年，IEEE将其关于“大数据”和“数据挖掘与智能计算”的年度国际会议融入有关知识图谱的国际会议。
+自此，数个大型跨国公司开始利用它们的知识图谱，很快知识图谱流行起来，有免费的知识图谱，如DBpedia和NELL，以及商业性质的知识图谱，如谷歌知识图谱和Microsoft Satori。这些知识图谱被成功应用于问答系统、词向量嵌入与文字分类等。在2019年，IEEE将其关于“大数据”和“数据挖掘与智能计算”的年度国际会议融入有关知识图谱的国际会议。
 
 以上是知识图谱发展的主要进程。
 
-知识图谱一般表示为三元组的形式，即G=(h，r，t)，其中G为知识图谱，h和t是知识库中的实体集合，分别为三元组的头结点与尾节点\cite{徐增林2016知识图谱技术综述}。
+知识图谱一般表示为三元组的形式，即$G=(h,r,t)$，其中$G$为知识图谱，$h$和$t$是知识库中的实体集合，分别为三元组的头结点与尾节点\cite{徐增林2016知识图谱技术综述}。知识图谱也可以看作是一种结点对应实体、边对应关系的有向异构图。
 
-目前知识图谱的构建过程中主要使有定义层次学习的思想及事实学习的思想等方法。
+目前知识图谱的构建过程中主要使用了定义层次学习及事实学习。
 
 定义层次学习是通过使用机器学习等技术，从文字、图片等信息中提取知识表达中的定义，并确定其上下文信息。而知识图谱本质上是属于一种精炼的异构信息网络。利用定义层次学习可以在一定程度上完成对于知识图谱的构建。
 
-事实学习分为有监督的事实学习、半监督的事实学习以及无监督的事实学习。有监督的事实学习通过人为标注的语料信息输入以及深度学习方法来完成知识图谱的构建，而半监督的事实学习方法使用启发式地自动标注文本，但缺陷是训练数据集中可能含有大量的噪声数据。而无监督的学习方法主要使用基于深度学习模型的自然语言处理（NLP）的方法，无须人为干预，由训练模型自动完成信息抽取、信息整合的方法。随着深度学习算法的发展，目前基于无监督的学习方法的事实学习逐渐成为主流\cite{李涓子2017知识图谱研究综述}。
+事实学习分为有监督的事实学习、半监督的事实学习以及无监督的事实学习。有监督的事实学习通过人为标注的语料信息输入以及深度学习方法来完成知识图谱的构建，而半监督的事实学习方法使用启发式地自动标注文本，但缺陷是训练数据集中可能含有大量的噪声数据。而无监督的学习方法主要使用基于深度学习模型的自然语言处理（NLP）的方法，无须人为干预，由训练模型自动完成信息抽取、信息整合。随着深度学习算法的发展，目前基于无监督的事实学习逐渐成为主流\cite{李涓子2017知识图谱研究综述}。
 
-目前出现了诸多使用以上思想设计的知识图谱嵌入算法：基于翻译的TransE\cite{bordes2013translating}、TransH\cite{wang2014knowledge}、TransR\cite{lin2015learning}和基于语义分析的DistMult\cite{yang2014embedding}等。
+目前出现了诸多使用以上理论方法设计的知识图谱嵌入算法：基于翻译的TransE\cite{bordes2013translating}、TransH\cite{wang2014knowledge}、TransR\cite{lin2015learning}和基于语义分析的DistMult\cite{yang2014embedding}等。
 
 目前，知识图谱在业界的应用已经取得了巨大成功\cite{曹倩2015知识图谱的技术实现流程及相关应用}：
 
-（1）搜索引擎技术。如前所述，知识图谱最早便是由谷歌提出以改善其搜索引擎的。在将知识图谱应用于搜索引擎之后，搜索引擎能对一些常见的搜索内容基于其使用的知识图谱信息快速给出搜索结果。同时，对于一些名词性的搜索内容，搜索引擎能使用知识图谱以知识卡片的形式给出其相关信息。研究表明，在谷歌将知识图谱技术融入其搜索引擎之后，用户点击进入维基百科的次数明显减少，说明利用知识图谱技术的搜索引擎可以更好的直接给出用户需要的信息而不需要用户再访问其他网站。
+（1）搜索引擎技术。如前所述，知识图谱最早便是由谷歌提出以改善其搜索引擎的。在将知识图谱应用于搜索引擎之后，搜索引擎能对一些常见的搜索内容基于其使用的知识图谱信息快速给出搜索结果。同时，对于一些名词性的搜索内容，搜索引擎能使用知识图谱以知识卡片的形式给出其相关信息。研究表明，在谷歌将知识图谱技术融入其搜索引擎之后，用户点击进入维基百科的次数明显减少，说明利用知识图谱技术的搜索引擎可以更好的直接给出用户需要的信息而不需要用户再浏览其他网站。
 
 （2）智能问答。信息检索系统中非常常见的一种便是问答系统。问答系统在用户输入问题后能迅速给出用户需要的答案。而在将知识图谱技术应用于问答系统后，其回答的准确率有非常大的提升。目前苹果的智能助理Siri以及谷歌的智能助理谷歌助理（Google Assistant）都使用了知识图谱技术。
 
@@ -55,67 +53,59 @@
 \subsection{基于知识图谱的推荐系统研究现状}
 由于传统的推荐系统无法解决稀缺性问题和冷启动问题，因此研究人员企图将辅助信息加入到推荐算法中以改善推荐性能。而这类辅助信息有社交网络、用户/物品属性、图像与上下文等。
 
-在数种类型的辅助信息中，知识图谱通常包含有更丰富的信息与物品间的联结。一个知识图谱是一种结点关联实体、边关联关系的有向异构图。近来，研究者已提出数种学术性知识图谱，比如DBpedia和NELL，以及商业性质的知识图谱，比如谷歌知识图谱和Microsoft Satori。这些知识图谱成功应用于问答系统、词向量嵌入与文字分类等。
-
-而目前基于知识图谱构建推荐系统的方法主要有以下几类：
-
-（1）基于嵌入的方法。基于嵌入的方法通过知识图谱嵌入计算算法将知识图谱中的实体信息与关系信息映射为低维向量空间中的向量表示（嵌入信息）。而后推荐算法利用该嵌入表示来完成相应的计算，并给出推荐结果。目前基于知识图谱中嵌入表示信息的方法的推荐模型有CKE\cite{zhang2016collaborative}、DKN\cite{wang2018dkn}以及SHINE\cite{wang2018shine}等。CKE是微软在 KDD2016 年发表的，其模型结构在原有系统过滤得到 U, V 向量的基础上，将物品的嵌入与其他描述信息相结合，这些信息主要有:
-采用 TransR 算嵌入得到的知识图谱，图谱内每个实体嵌入表示被提取为物品的结构化向量信息。
-采用SDAE模型得到物品描述性文本的文本性嵌入表示。
-采用SCAE模型得到物品相关图像的视觉嵌入表示。DKN是之前同样由微软团队在 WWW2018 会议上发表的。它是一个主要针对新闻任务提出的框架，知识图谱用在对新闻标题作嵌入的层面。DKN 提出对新闻标题内每一个关键实体，在知识图谱内找到其实体嵌入和上下文嵌入。
-SHINE设计深度自编码器来嵌入语义网络，社交网络来进行推荐。其为用户-物品的交互使用自动编码器并刻画用户感兴趣的概率。
-
-（2）基于路径的方法。基于路径的方法将知识图谱视为异构信息网络，主要是通过知识图谱中的路径中的关系信息来辅助推荐算法来完成推荐相关的计算工作。目前基于知识图谱中路径信息的推荐模型有HIN\cite{zhao2017meta}、RKGE\cite{sun2018recurrent}等。HIN是2017年在KDD上提出的，与 PER\cite{yu2014personalized}类似，都将将知识图谱视为异构信息网络。其针对Yelp和Amazon数据集分别设计了元路径，并得到了L个评估函数。并在建模时使用FM模型，使用FM组损失函数进行梯度下降，并最终得到推荐结果。RKGE模型使用了基于循环神经网络的方法。在人为定义元路径并抽取出所有路径之后，对每种元路径都使用循环神经网络模型来抽取并推理其路径中所包含的信息。
-
-（3）混合式方法。基于嵌入的方法未能充分利用实体间的关系模式信息，而基于路径的方法仅考虑了实体间的语义连通信息，未能有效使用用户/物品本身的语义信息。因此，目前出现了混合式方法，即同时结合了基于嵌入的方法与基于路径的方法的优点。混合式方法是当前的研究热点与焦点，使用该方法的典型模型有AKUPM\cite{tang2019akupm}和RCoLM\cite{cao2019unifying}等。AKUPM是用于推荐的以注意力机制增强的推荐模型，RCoLM则是基于联合学习并以任务为导向的推荐算法。本文实现的电影推荐系统是基于论文“涟漪网络：在知识图谱上传递用户偏好的推荐模型\cite{wang2018ripplenet}”的，其中所使用的算法模量型是也隶属混合式方法。
+在数种类型的辅助信息中，知识图谱通常包含有更丰富的信息以及物品间的联系。图~\ref{fig:enhanced-recommendation}中说明了知识图谱提供丰富的信息与物品间的连接，有利于提高推荐结果的准确性、多样性和可解释性。知识图谱可以从以下三个方面提高推荐性能：
 \begin{figure}
 	\includegraphics[width=\textwidth]{enhanced-recommendation}
-	\bicaption{受知识图谱增强的电影推荐系统}{Knowledge graph enhanced movie recommendation system}\label{fig:enhanced-recommendation}
+	\bicaption{基于知识图谱的电影推荐系统}{Knowledge graph enhanced movie recommendation system}\label{fig:enhanced-recommendation}
 \end{figure}
 
-受到将知识图谱成功应用于多种类型任务的启发，研究人员企图将知识图谱作为辅助信息加入推荐算法中以改善推荐系统的性能。图~\ref{fig:enhanced-recommendation}中显示了知识图谱提供丰富的信息与物品间的连接，有利于提高推荐结果的准确性、多样性和可解释性。知识图谱可以从以下三个方面提高推荐性能：
+（1）知识图谱引入了实体语义相关性，这可以帮助找到实体间潜在的联系并提高推荐物品的准确性。
+
+（2）知识图谱由各种类型的关系构成，这对合理地扩展用户兴趣并增加推荐商品的多样性是有益的。
 
-（1）知识图谱引入了实体语义相关性，这可以帮助找到其潜在的联系并提高推荐物品的准确性。
+（3）知识图谱连接用户的历史记录及推荐的商品，因此提高了推荐系统的可解释性。
 
-（2）知识图谱由各种类型的关系构成，这对合理的扩展用户兴趣并增加推荐商品的多样性是有益的。
+将知识图谱作为辅助信息加入至推荐系统中是当前的热点问题，目前基于知识图谱构建推荐系统的方法主要有以下几类：
 
-（3）知识图谱连接用户的历史记录及推荐的商品，因此为推荐系统提高了可解释性。
+（1）基于嵌入的方法。基于嵌入的方法通过知识图谱嵌入计算算法将知识图谱中的实体信息与关系信息映射为低维向量空间中的向量表示（嵌入表示）。而后推荐算法利用该嵌入表示来完成相应的计算，并给出推荐结果。目前将知识图谱中嵌入表示信息作为辅助信息的推荐模型有CKE\cite{zhang2016collaborative}、DKN\cite{wang2018dkn}以及SHINE\cite{wang2018shine}等。CKE是微软在 KDD2016 年发表的，其模型结构在原有系统过滤得到$U$, $V$向量的基础上，将物品的嵌入与其他描述信息相结合，这些信息主要有:
+采用 TransR 算法嵌入得到的知识图谱，图谱内每个实体嵌入表示被提取为物品的结构化向量信息。
+采用SDAE模型得到物品描述性文本的文本嵌入表示。
+采用SCAE模型得到物品相关图像的视觉嵌入表示。DKN是之前同样由微软团队在WWW2018会议上发表的。它是一个主要针对新闻推荐任务提出的框架，知识图谱用于辅助计算新闻标题的嵌入表示。DKN提出对新闻标题内每一个关键实体，在知识图谱内找到其实体嵌入和上下文嵌入。
+SHINE设计深度自编码器来嵌入语义网络，社交网络并进行推荐。其为用户-物品的交互使用自动编码器并计算用户感兴趣的概率。此外，嵌入表示可以包含实体的独热编码\cite{koren2008factorization}、词汇集\cite{wang2018dkn}、上下文信息\cite{sun2017collaborative}或属性\cite{wang2018shine}，而选择哪一种嵌入向量的计算方式取决于其应用场合。
 
-将知识图谱作为辅助信息加入至推荐系统中是当前的热点问题。
+（2）基于路径的方法。基于路径的方法将知识图谱作为异构信息网络，主要是通过知识图谱中的路径关系信息来辅助推荐算法完成推荐相关的计算工作。目前基于知识图谱中路径信息的推荐模型有HIN\cite{zhao2017meta}、RKGE\cite{sun2018recurrent}等。HIN是2017年在KDD上提出的，与PER\cite{yu2014personalized}类似，都将知识图谱作为异构信息网络。它针对Yelp和Amazon数据集分别设计了元路径，并得到了L个评估函数。并在建模时使用FM模型，使用FM损失函数组进行梯度下降，并最终得到推荐结果。RKGE模型使用了基于循环神经网络的方法。在人为定义元路径并抽取出所有路径之后，对每种元路径都使用循环神经网络模型来抽取并推理其路径中所包含的信息。
+
+（3）混合式方法。基于嵌入的方法未能充分利用实体间的关系模式信息，而基于路径的方法仅考虑了实体间的语义连通信息，未能有效使用用户/物品本身的语义信息。因此，目前出现了混合式方法，即同时结合了基于嵌入的方法与基于路径的方法的优点。混合式方法是当前的研究热点与焦点，使用该方法的典型模型有AKUPM\cite{tang2019akupm}和RCoLM\cite{cao2019unifying}等。AKUPM是通过注意力机制增强的推荐模型，RCoLM则是基于联合学习并以任务为导向的推荐算法。本文实现的电影推荐系统基于文献\parencite{wang2018ripplenet}，其所使用的算法模型是也属于混合式方法。
 \section{本文的主要研究内容}
-本文在研究推荐算法、知识图谱和基于知识图谱的推荐算法的相关研究基础上，做了以下数个方面的研究：
+本文在推荐算法、知识图谱和基于知识图谱的推荐算法的相关研究基础上，做了以下三方面的研究：
 
-（1）设计并实现了基于知识图谱的电影推荐系统，使用“电影透镜1兆数据”作为数据集，此外还从IMDb及豆瓣爬取了相关电影数据作为研究对象。
+（1）对推荐系统所需的数据进行采集和处理，使用“MovieLens 1M Dataset”作为数据集，此外还从IMDb及豆瓣网爬取了相关电影数据并进行处理，作为本文的研究对象。
 
-（2）根据论文“涟漪网络：在知识图谱上传递用户偏好的推荐模型\cite{wang2018ripplenet}”实现了基于知识图谱的推荐算法——涟漪网络，该算法能根据用户的历史行为来为用户进行电影推荐。此外，将涟漪网络算法与其他基于知识网络的推荐算法（DKN\cite{wang2018dkn}、CKE\cite{zhang2016collaborative} 、PER\cite{yu2014personalized}、SHINE\cite{wang2018shine}、LibFM\cite{rendle2012factorization}和Wide\&Deep\cite{cheng2016wide}等）进行性能比较。
+（2）根据文献\parencite{wang2018ripplenet}提出的算法，实现了基于知识图谱的涟漪网络推荐算法，该算法能根据用户的历史行为为用户进行电影推荐。此外，将涟漪网络算法与其他基于知识图谱的推荐算法（DKN\cite{wang2018dkn}、CKE\cite{zhang2016collaborative} 、PER\cite{yu2014personalized}、SHINE\cite{wang2018shine}、LibFM\cite{rendle2012factorization}和Wide\&Deep\cite{cheng2016wide}等）进行了性能比较。
 
-（3）实现一个基于知识图谱的电影推荐系统，该系统能够根据用户的历史行为（评分、收藏等）来为用户进行电影推荐。该系统分为管理员、未登录用户、普通登录用户。管理员能增加、修改和删除电影和普通用户；未登录用户能根据影分类查看电影及查看电影详情；普通登录用户除能进行未登录用户的操作外，还能购买、收藏及评价电影。
+（3）实现了一个基于知识图谱的电影推荐系统，该系统能够根据用户的历史行为（评分、收藏等）来为用户进行电影推荐。该系统分为管理员、未登录用户、普通登录用户。管理员能增加、修改和删除电影和普通用户；未登录用户能根据电影分类查看电影列表以及查看电影详情；普通登录用户除了能进行未登录用户的所有操作外，还能购买、收藏及为电影评分。
 \section{论文结构}
 本论文一共分为五个章节。
 
-第一章是绪论。简明介绍知识图谱作为辅助信息在推荐算法中的重要作用以及推荐算法对在线流媒体播放平台的重要作用，介绍了推荐系统、知识图谱和基于知识图谱的推荐系统的发展和应用以及本文的主要工作及创新点。
+第1章是绪论。简明介绍知识图谱作为辅助信息在推荐算法中的作用以及推荐算法对在线流媒体播放平台的作用，同时介绍了推荐系统、知识图谱和基于知识图谱的推荐系统的发展和应用，并说明了本文的主要工作。
 
-第二章是相关理论和技术。介绍了目前知识图谱和推荐系统的研究现状，并对传统的推荐算法与加入辅助信息的推荐算法作了较为细致的分类与阐述。同时还介绍了本文实现的电影推荐系统的技术栈，比如数据库、前端架构、后端架构等。
+第2章是相关理论和技术。介绍了目前知识图谱和推荐系统的研究现状，并对传统的推荐算法与加入辅助信息的推荐算法作了较为细致的分类与阐述。同时还介绍了本文实现的电影推荐系统所使用的技术栈，诸如数据库、前端架构、后端架构等。
 
-第三章是涟漪网络。介绍了涟漪网络算法，以及计算相关实体嵌入的过程中使用的深度学习算法，并对该算法进行了讨论。最后，还对涟漪网络推荐算法的准确度进行了测试。
+第3章是涟漪网络。介绍了涟漪网络算法，以及计算相关实体嵌入的过程中使用的深度学习算法，并对以上算法进行了讨论。最后，还对涟漪网络推荐算法的准确度进行了测试。
 
-第四章是电影推荐系统。介绍了以涟漪网络算法为基础构建的电影推荐系统：介绍了系统架构、系统功能、电影推荐流程以及如何保证该系统的安全性。
+第4章是电影推荐系统。介绍了以涟漪网络算法为基础构建的电影推荐系统：介绍了系统架构、系统功能、电影推荐流程以及如何保证该系统的安全性。
 
-第五章是研究结论和展望。总结了涟漪网络算法的设计与实现、电影推荐系统的功能，并指出了其中可以改进的地方。
+第5章是研究结论和展望。总结了涟漪网络算法的设计与实现、电影推荐系统的功能，并指出了其中可以改进的地方。
 \chapter{相关理论和技术}
 \section{知识图谱}
 \subsection{知识图谱的概念及发展进程}
-知识图谱，是一种知识可视化或知识领域映射地图，是显示知识发展进程与结构关系的一系列三元组（实体，关系，实体），用可视化技术描述知识信息及其载体，挖掘、分析、建立、绘制和可视化知识以及它们之间的相互关系。
-
-知识图谱是谷歌于2012年提出的，目的是为了增强其搜索引擎。而后微软于2013年7月发布了其Microsoft Satori知识图谱。除传统搜索服务提供商之外，包括Apple，Facebook，IBM等互联网企业也在探索该领域。
-
-此外，业界也出现了社区构建的开源知识图谱，如DBpedia，NELL和Wikidata等。
+知识图谱，是一种知识可视化或知识领域映射地图，是显示知识发展进程与结构关系的一系列三元组（实体，关系，实体），用可视化技术描述知识信息及其载体，挖掘、分析、建立、绘制和可视化知识以及实体之间的相互关系。
 
-以Freebase、WordNet和GeneOntology等为例的知识图谱已成为支持人工智能相关应用的非常重要的资源。
+知识图谱是谷歌于2012年提出的，目的是为了增强其搜索引擎。而后微软于2013年7月发布了Microsoft Satori知识图谱。除传统搜索服务提供商之外，包括Apple，Facebook，IBM等互联网企业也在探索该领域。此外，业界也出现了社区构建的开源知识图谱，如DBpedia，NELL和Wikidata等。以Freebase、WordNet和GeneOntology等为例的知识图谱已成为支持人工智能相关应用的非常重要的资源。
 \subsection{知识图谱的构建方法}
-知识图谱是由多实体结点和不同关系边构成的多关系图，一个边是一个事实三元组（头结点，关系，尾结点）（记为（h, r, t））。而知识图谱的构建便是寻找这样的三元组。
+知识图谱是由多实体结点和不同关系边构成的多关系图，一个边是一个事实三元组（头结点，关系，尾结点），记为$(h,r,t)$。而知识图谱的构建便是寻找这样的三元组。
 
-在过去十年，在构建大型知识图谱方面已取得很大的成就，然而，还没有清晰的支持构建知识图谱的范式。主要有两个困难：（1）知识图谱是符号化的逻辑系统而知识图谱的应用常常是包含在连续空间的计算。（2）在一张图谱上进行知识聚合是困难的。
+在过去十年间，出现了诸多构建大型知识图谱的方法，然而，还没有清晰准确的构建知识图谱的范式。主要有两个困难：（1）知识图谱是符号化的逻辑系统而知识图谱的应用常常包含在连续空间中的计算；（2）在一张知识图谱上进行知识聚合是困难的。
 
 目前，知识图谱主要通过以下3个步骤来完成构建：
 
@@ -123,43 +113,41 @@ SHINE设计深度自编码器来嵌入语义网络，社交网络来进行推荐
 
 （2）知识融合。对新获得的知识进行整合，以完成消歧义。
 
-（3）知识加工。对融合后的新知识经过质量核查后将正确的部分加入至知识图谱中。
+（3）知识加工。经过质量核查后将融合后的新知识的正确的部分加入至知识图谱中。
 \subsection{知识图谱的应用}
-知识图谱以更接近人类认知的方式为互联网的信息表达提供了一种新的方式，而且提供了一种更益于组织与利用海量的方式。当前知识图谱主要用于搜索引擎(Bing，Google Search)、个人助理（Google Assistant）以及问答系统。
+知识图谱以更接近人类认知的方式为互联网的信息表达提供了一种新的方式，而且提供了一种更益于组织与利用海量数据的方式。当前知识图谱主要用于推荐系统、搜索引擎、个人助理以及问答系统。
 \section{推荐系统}
-推荐系统是根据用户可能给某物品评分或用户可能偏好的内容过滤系统的一个子集。
-
-推荐系统广泛使用于多个领域，通常有为视频或音乐服务生成推荐清单的表现形式。
+推荐系统是内容过滤系统的一个子集，被广泛使用于多个领域，它向用户推荐满足其偏好的物品，并通常具有为视频或音乐服务生成推荐清单的表现形式。
 \subsection{传统的推荐系统}
-传统的推荐系统主要分为基于内容的推荐系统、基于协同过滤的推荐系统和混合推荐系统\cite{黄立威2018基于深度学习的推荐系统研究综述}。（1）基于内容的推荐系统主要用于文本相关的项目，因为内容常常是使用关键字来描述的。该算法通过计算相关物品的离散特征，然后推荐具有与其类似特征的有关物品。（2）基于协同过滤的推荐系统主要通过将具有与目标用户相似特征的用户所交互过的物品推荐给目标用户。
+传统的推荐系统主要分为基于内容的推荐系统、基于协同过滤的推荐系统和混合推荐系统\cite{黄立威2018基于深度学习的推荐系统研究综述}。基于内容的推荐系统主要用于文本相关的项目，因为内容常常是使用关键字来描述的。该算法通过计算相关物品的离散特征，然后推荐具有与用户历史偏好物品类似特征的有关物品。基于协同过滤的推荐系统主要通过将具有与目标用户相似特征的用户所交互过的物品推荐给目标用户。
 
-基于内容推荐与通过协同过滤推荐的有关区别可以从比较两个流行音乐推荐系统的实现方式中得出：（1）潘多拉音乐使用一个基于内容推荐的推荐算法。它根据艺人或歌曲的属性来生成一个包含相似风格歌曲的电台，并且该电台的内容会根据收听用户的反馈进行调整。当用户对一首歌曲“不感兴趣”时该算法将弱化该歌曲的一些属性；而当用户喜欢一首歌曲时，将强化一些属性。并且该算法会根据该属性调整歌曲的顺序，若越过一个阀值时将某一歌曲从列表中删除。（2）“终级fm”使用一个协同过滤的推荐算法。它记录用户经常收听的乐队和歌手，然后与其它用户的有关行为进行比较，建立一个电台，并以此推荐歌曲。“终级fm”会给用户推荐其他具有相似特征用户的播放列表（并保证目标用户未收听过）。
+基于内容的推荐与基于协同过滤的推荐的有关区别可以通过比较两个流行音乐推荐系统的实现方式看出。（1）潘多拉音乐使用一个基于内容推荐的推荐算法。它根据艺人或歌曲的属性来生成一个包含相似风格歌曲的电台，并且该电台的内容会根据收听用户的反馈进行调整。当用户对一首歌曲“不感兴趣”时该算法将弱化该歌曲的一些属性；而当用户喜欢一首歌曲时，将强化一些属性。并且该算法会根据该属性调整歌曲的顺序，若属性的值越过一个阀值时推荐算法便将某一歌曲从列表中删除。（2）“终级fm”使用协同过滤的推荐算法。它记录用户经常收听的乐队和歌手，然后与其它用户的有关行为进行比较，建立一个电台，并以此推荐歌曲。“终级fm”会给用户推荐其他具有相似特征用户的播放列表（并保证目标用户未收听过）。
 
-而上述两种推荐算法都有其长处与短处。潘多拉音乐所使用的基于内容推荐的推荐算法是根据物品本身的性质来进行推荐的，因此不需要用户信息就可以有较好的准确度。但该算法严重以来物品本身的特性，因此局限性较大，推荐的内容都是与种子集相关的，推荐结果的多样性较低。而“终级fm”使用的协同过滤算法需要根据用户与物品的交互来生成推荐结果，因此需要大量的用户数据，存在数据稀缺性问题与冷启动问题。
+基于内容的推荐与基于协同过滤的推荐各有优缺点。潘多拉音乐所使用的基于内容推荐的推荐算法是根据物品本身的性质来进行推荐的，因此不需要用户信息就可以有较好的准确度。但该算法严重依赖物品本身的特性，因此局限性较大，推荐的内容都是与种子集相关的，推荐结果的多样性较低。而“终级fm”使用的协同过滤算法需要根据用户与物品的交互来生成推荐结果，因此需要大量的用户数据，存在数据稀缺性问题与冷启动问题。
 \subsection{基于知识图谱的推荐系统}
-基于内容推荐与协同过滤推荐两者均存在一些局限性，为了提高推荐的准确性与解决传统的推荐算法的数据稀缺性与冷启动问题，研究者将一些辅助信息加入至推荐算法中，通常这些辅助信息包括上下文信息、用户或物品的属性、图片和社交网络\cite{常亮2019知识图谱的推荐系统综述}\cite{王一鸣2018基于知识图谱的推荐技术研究及应用}。
+基于内容推荐与协同过滤推荐两者均存在一些局限性，为了提高推荐的准确性，解决传统推荐算法的数据稀缺性与冷启动问题，研究者将一些辅助信息加入至推荐算法中，通常这些辅助信息包括上下文信息、用户或物品的属性、图片和社交网络\cite{常亮2019知识图谱的推荐系统综述}\cite{王一鸣2018基于知识图谱的推荐技术研究及应用}。
 
-而随着知识图谱的发展，当前将知识图谱作为辅助信息加入推荐系统来提高推荐系统性能已经成为了一个热门的研究方向。将知识图谱作为辅助信息加入推荐算法可以产生两个优点：
+而随着知识图谱的发展，将知识图谱作为辅助信息来提高推荐系统的性能已经成为了热门的研究方向。将知识图谱作为辅助信息加入推荐算法的优点有：
 
 （1）提高推荐系统的准确性。知识图谱可以表示不同实体间的关系，可以将物品及其相关属性对应于知识图谱之中，从而推荐算法可以理解物品之间的关系。此外，用户与用户间的关系信息也可以映射至知识图谱之中，从而推荐算法可以更准确地分析物品与物品间的关系、用户与物品之间的关系。
     
-（2）提高推荐系统的可解释性。由于推荐结果依照知识图谱中的关系信息，因此可以由知识图谱中的关系路径得到推荐结果的原因。
+（2）提高推荐系统的可解释性。由于推荐结果依照知识图谱中的关系信息，因此可以由知识图谱中的关系路径得到推荐系统给出推荐结果的原因。
 
 目前主要的基于知识图谱的推荐算法有基于嵌入的方法、基于路径的方法以及混合式方法：
 
-（1）基于嵌入的方法。基于嵌入的方法使用知识图谱的信息来完善实体的嵌入表示。为了将知识图谱中的信息添加至推荐算法中来辅助推荐，需要使用知识图谱嵌入表示算法（Knowledge Graph Embedding, KGE）表计算实体嵌入（实体嵌入指由知识图谱中信息得到的在低维向量空间中的向量表示）。KGE算法有TransE\cite{bordes2013translating}、TransH\cite{wang2014knowledge}、TransR\cite{lin2015learning}和DistMult\cite{yang2014embedding}等。而推荐算法将通过计算得到的嵌入表示来计算物品-物品间、用户-用户间以及用户-物品间的关系，从而对用户进行物品推荐。
+（1）基于嵌入的方法。基于嵌入的方法使用知识图谱的信息来完善实体的嵌入表示。为了将知识图谱中的信息添加至推荐算法中来辅助推荐，需要使用知识图谱嵌入表示算法（Knowledge Graph Embedding, KGE）表计算实体嵌入（实体嵌入指由知识图谱中的信息得到的在低维向量空间中的向量表示）。KGE算法有TransE\cite{bordes2013translating}、TransH\cite{wang2014knowledge}、TransR\cite{lin2015learning}和DistMult\cite{yang2014embedding}等。而推荐算法利用该嵌入表示来进行相关计算，从而对用户进行物品推荐。
 
 （2）基于路径的方法\cite{lin2015modeling}\cite{guu2015traversing}\cite{toutanova2016compositional}。基于路径的方法将知识图谱视为异构信息网络。而推荐系统利用该异构信息网络寻找实体间的关系，从而完成推荐。
 
-（3）混合式方法。基于嵌入的方法未能充分利用实体间的关系模式信息，而基于路径的方法仅考虑了实体间的语义连通信息，未能有效使用用户/物品本身的语义信息。因此，目前出现了混合式方法，即同时结合了基于嵌入的方法与基于路径的方法的优点。混合式方法是当前的研究热点与焦点，使用该方法的典型模型有AKUPM\cite{tang2019akupm}和RCoLM\cite{cao2019unifying}等。本文基于的算法也隶属该类。
+（3）混合式方法。基于嵌入的方法未能充分利用实体间的关系模式信息，而基于路径的方法仅考虑了实体间的语义连通信息，未能有效利用用户/物品本身的语义信息。混合式方法结合了基于嵌入的方法与基于路径的方法的优点，该方法是当前的研究热点与焦点，使用该方法的典型模型有AKUPM\cite{tang2019akupm}和RCoLM\cite{cao2019unifying}等。本文实现的算法属于混合方法。
 \section{系统开发技术}
 \label{sec:tech-stack}
 \subsection{数据采集技术}
-电影推荐系统使用的数据来自“电影透镜1兆数据”\footnote{https://grouplens.org/datasets/movielens/1m/}数据集，此外还从IMDb\footnote{https://www.imdb.com/}及豆瓣\footnote{https://www.douban.com/}爬取了相关电影数据作为研究对象。
+电影推荐系统使用的数据来自“MovieLens 1M Dataset”\footnote{https://grouplens.org/datasets/movielens/1m/}数据集，此外还从IMDb\footnote{https://www.imdb.com/}及豆瓣网\footnote{https://www.douban.com/}爬取了相关电影数据并进行处理作为本文的研究对象。
 
 在数据采集的过程中，使用Scrapy框架进行了数据爬取，爬取的数据包括电影名称、电影封面、预告片图片、电景情节介绍、导演、演员以及剧作家。
 
-最终，一共爬取了3684部电影的数据。其中，从IMDb爬取了3494部电影数据，从豆瓣爬取了190条电影数据（由于豆瓣限制了每IP访问量故爬取的数据较少）。
+最终，总计爬取了3684部电影的数据。其中，从IMDb爬取了3494条电影数据，从豆瓣爬取了190条电影数据（由于豆瓣网限制了每IP访问量故爬取的数据较少）。
 \subsection{数据存储技术}
 本系统使用MongoDB与Neo4j存储数据。
 
@@ -175,30 +163,20 @@ Neo4j是一个具有高性能的图数据库，它将结构化的数据信息储
 
 在本系统中，知识图谱的有关信息被存储在Neo4j中，由于知识图谱本身图的特性，这充分利用了Neo4j作为图数据库的特点，可以提供良好的性能支持。
 \subsection{后端技术}
-本系统使用Flask框架作为网站后端框架。Flask是一个Python编写的轻量级微框架。它具有轻量、便捷、可扩展等特点。
-
-本系统选择Flask框架充分利用了其便捷、可扩展以及开发便捷的特点，与本系统要求相符。
-
-本系统使用表现层状态转换（REST）风格的应用程序接口（API）作为前后端的交互接口。
+本系统使用Flask框架作为网站后端框架。Flask是一个Python编写的轻量级微框架。它具有轻量、便捷、可扩展等特点。系统使用Flask框架充分利用了其便捷、可扩展以及开发便捷的特点，与本系统要求相符。
 
-表现层状态转换（Representational State Transfer，REST）是一种基于HTTP协议的软件交互体系结构样式，该协议是由Roy Thomas Fielding博士在2000年的博士论文中引用的\cite{fielding2000architectural}，目的是促进不同的软件/程序的开发。在网络上互相传输数据。表示层状态转换基于超文本传输​​协议（HTTP）的一组约束，该协议是一种旨在提供万维网服务的软件构造样式。符合或兼容此体系结构样式（简称为REST或RESTful）的网络服务允许客户端发出使用统一资源标识符访问和操作网络资源的请求，这些资源与一组预定义的操作一致。因此，表示层状态转换提供了Internet上计算机系统之间相互使用资源的互操作性。与其他类型的网络服务（例如SOAP服务）相比，它们使用自己定义的一组操作来访问网络资源。
+系统使用表现层状态转换（REST）风格的应用程序接口（API）作为前后端的交互接口。表现层状态转换（Representational State Transfer，REST）是一种基于HTTP协议的软件交互体系结构样式，该协议是由Roy Thomas Fielding博士在2000年的博士论文中引用的\cite{fielding2000architectural}，目的是促进不同的软件/程序的开发。在网络上互相传输数据。表示层状态转换基于超文本传输​​协议（HTTP）的一组约束，该协议是一种旨在提供万维网服务的软件构造样式。符合或兼容此体系结构样式（简称为REST或RESTful）的网络服务允许客户端发出使用统一资源标识符访问和操作网络资源的请求，这些资源与一组预定义的操作一致。因此，表示层状态转换提供了Internet上计算机系统之间相互使用资源的互操作性。与其他类型的网络服务（例如SOAP服务）相比，它们使用自己定义的一组操作来访问网络资源。
 
-得益于本系统使用了REST风格的API，本系统能更有效地使用缓存来提升响应速度，同时本系统前后端的相互间通讯的无状态性可以让不同的服务器的处理一连串请求中不同的请求，提高了本系统的可扩展性。与此同时，得益于REST风格语义化的接口，使前后端交互接口更清晰明了，使接口的使用者能更高效便捷地进行相关的开发工作。
+得益于本系统使用了REST风格的API，本系统能更有效地使用缓存来提升响应速度，同时前后端间的通讯的无状态性可以让不同的服务器处理一连串请求中不同的请求，提高了本系统的可扩展性。与此同时，得益于REST风格语义化的接口，使前后端交互接口更清晰明了，使接口的使用者能更高效便捷地进行相关的开发工作。
 \subsection{前端技术}
-本系统前端使用Angular框架。
+本系统前端使用Angular框架。Angular（通常指“Angular 2+”或“Angular v2及以上”）是一个基于TypeScript的开源网络应用框架，它的开发由Google的Angular团队领导同时也有个人及其他公司维护。Angular完全从相同团队开发的AngularJS重新编写而来。Angular常常作为MEAN技术栈的一部分。MEAN技术栈指MongoDB数据库、Express.js网络服务器框架、Angular/AngularJS以及Node.js服务器运行时。不同于MEAN技术栈，本系统将其中的“E”（指Express.js网络服务器框架）替换为了Flask网络服务器框架。
 
-Angular（通常指“Angular 2+”或“Angular v2及以上”）是一个基于TypeScript的开源网络应用框架，它的开发由Google的Angular团队领导同时也有个人及其他公司维护。Angular完全从相同团队开发的AngularJS重新编写而来。
-
-Angular常常作为MEAN技术栈的一部分。MEAN技术栈指MongoDB数据库、Express.js网络服务器框架、Angular/AngularJS以及Node.js服务器运行时。
-
-不同于MEAN技术栈，本系统将其中的“E”（指Express.js网络服务器框架）替换为了Flask网络服务器框架。
-
-通过使用Angular框架，本系统具有一个现代化、模块化的网页架构。同时借助于Angular Material Components官方组件库，本系统前端UI符合材料设计（Material Design）。
+通过使用Angular框架，本系统具有一个现代化、模块化、响应式的网页架构。同时借助于Angular Material Components官方组件库，本系统前端UI符合材料设计（Material Design）。
 \chapter{基于涟漪网络知识图谱的推荐算法}
 \label{ch:offline-recommendation}
 \section{涟漪网络}
 \subsection{架构}
-涟漪网络的总体架构如图~\ref{fig:ripplenet-framework}中所示，图上方的知识图谱中展示由用户交互产生的涟漪。涟漪网络以一个用户$u$和一个电影$v$作为输入，并输出用户$u$与电影$v$之间产生交互的概率。对输入用户$u$而言，其历史交互记录$V_u$是知识图谱中的种子集，而后沿着知识图谱中的关系边形成多个涟漪集$S_u^{k}\ (k=1, 2, \dots, H)$。一个涟漪集是距离种子集$V_u$ $k$跳的知识三元组。这些涟漪集用于与迭代地与电影$v$的嵌入（黄色的块）表示相计算以得到关于电影$v$的用户$u$的反应（绿色的块），最后结合得到用户的最终嵌入表示（灰色的块）。最终，将用户$u$与电影$v$的嵌入表示相结合以计算出预测概率$y_{uv}$。
+涟漪网络的总体架构如图~\ref{fig:ripplenet-framework}所示，图上方的知识图谱中展示了由用户交互产生的涟漪。涟漪网络以一个用户$u$和一个电影$v$作为输入，并输出用户$u$与电影$v$之间产生交互的概率。对输入用户$u$而言，其历史交互记录$V_u$是知识图谱中的种子集，而后沿着知识图谱中的关系边形成多个涟漪集$S_u^{k}\ (k=1, 2, \dots, H)$。第k个涟漪集是种子集$V_u$经过$k$跳得到的知识三元组。然后迭代地利用这些涟漪集与电影$v$的嵌入表示（黄色的块）计算出用户$u$对电影$v$的的响应（绿色的块），最后结合得到用户的最终嵌入表示（灰色的块）。最终，利用用户$u$与电影$v$的嵌入表示计算出用户$u$对电影$v$感兴趣的预测概率$y_{uv}$。
 \begin{figure}
 	\includegraphics[width=\textwidth]{ripplenet-framework}
 	\bicaption{涟漪网络的总体架构}{The overall framework of the Ripple Network}\label{fig:ripplenet-framework}
@@ -208,119 +186,139 @@ Angular常常作为MEAN技术栈的一部分。MEAN技术栈指MongoDB数据库�
 	\includegraphics[width=\textwidth]{illustration-of-ripple-sets}
 	\bicaption{电影知识图谱中由“阿甘正传”激发的涟漪集}{Sets of ripples of “Forest Gump” in Knowledge Graph of movies}\label{fig:illustration-of-ripple-sets}
 \end{figure}
-知识图谱常常含有丰富的事实信息与实体间的联系。比如，如图~\ref{fig:illustration-of-ripple-sets}（图中不同颜色的圆圈表示有不同跳的涟漪集。较浅的蓝色代表中间与周边实体的关联程度。）所示电影“阿甘正传”与“罗伯特·泽米吉斯”相连，它们之间的联系是“罗伯特·泽米吉斯”是电影“阿甘正传”的导演。而“回到未来”也与“罗伯特·泽米吉斯”相连。因此，如果一个用户与电影“阿甘正传”交互过，则他很有可能也对“回到未来”感兴趣。为了描述用户在知识图谱中分层次的可能偏好集，递归定义用户$u$的k跳相关实体如下：
+知识图谱常常含有丰富的事实信息与实体间的联系。比如，图~\ref{fig:illustration-of-ripple-sets}（图中不同颜色的圆圈表示不同跳数的涟漪集，越浅的蓝色代表种子集与该区域内实体的关联程度越低）中电影“阿甘正传”与“罗伯特·泽米吉斯”相连，它们之间的联系为“罗伯特·泽米吉斯”是电影“阿甘正传”的导演。而“回到未来”也与“罗伯特·泽米吉斯”相连。因此，如果一个用户与电影“阿甘正传”交互过，则他很有可能也对“回到未来”感兴趣。为了描述用户在知识图谱中分层次的潜在偏好集，递归定义用户$u$的$k$跳相关实体如下：
+
+\textbf{定义1（相关实体集） } 给定交互矩阵$\Upsilon$与知识图谱$G$，则用户$u$的$k$跳相关实体集的定义为式\eqref{relevant-entities}。
 
-\textbf{定义1（相关实体集） } 给定交互矩阵$\Upsilon$与知识图谱$G$，则用户$u$的$k$跳相关实体可以定义为
 \begin{equation}
 	E_u^k=\{t|(h, r, t)\in G \text{且} h\in E^{k-1}_u\}, k = 1, 2, \dots, H\label{relevant-entities}
 \end{equation}
-式\eqref{relevant-entities}中$E_u^0=V_u=\{v | y_{uv}=1\}$是用户的历史偏好集，可以看作用户$u$在知识图谱中的种子集。
 
-相关实体集可以看作用户的历史偏好集在知识图谱中的自然扩展。给定相关实体集的定义，以下定义用户$u$的$k$跳涟漪集：
+式\eqref{relevant-entities}中，$E_u^0=V_u=\{v | y_{uv}=1\}$是用户的历史偏好集，可以看作是用户$u$在知识图谱中的种子集。
+
+相关实体集可以看作是用户的历史偏好集在知识图谱中的自然扩展。给定相关实体集的定义，以下定义用户$u$的$k$跳涟漪集：
+
+\textbf{定义2（涟漪集）}用户$u$的$k$跳涟漪集可以看作是知识图谱中以$E^{k-1}_u$为起点的知识三元组，定义如式\eqref{ripple-set}所示。
 
-\textbf{定义2（涟漪集）}用户u的k跳涟漪集可以看作是知识图谱中以$E^{k-1}_u$为起点的知识三元组：
 \begin{equation}
 	S_u^k = \{(h, r, t)|(h, r, t)\in G \text{且} h\in E^{k-1}_u\}, k = 1, 2, \dots, H\label{ripple-set}
 \end{equation}
-“涟漪”这个词有两重意思：（1）对由多个雨点产生的真实涟漪的模拟，用户由其在实体中交互过的潜在兴趣集在知识图谱中由近及远地传递。这一过程如图~\ref{fig:illustration-of-ripple-sets}所示。（2）用户的潜在兴趣随着在知识图谱中会传递的跳数$k$的增大逐渐递减。图~\ref{fig:illustration-of-ripple-sets}中蓝色的变浅也显示了潜在兴趣递减的过程。
 
-一个顾虑是在跳数$k$增加的过程中涟漪集的大小可能太大。为了解决这个问题，注意到：
+“涟漪”这个词有两重意思：（1）对由多个雨点产生的真实涟漪的模拟，用户对电影的潜在兴趣集在知识图谱中由近及远地传递。这一过程如图~\ref{fig:illustration-of-ripple-sets}所示。（2）用户的潜在兴趣随着知识图谱中传递的跳数$k$的增大逐渐递减。图~\ref{fig:illustration-of-ripple-sets}中蓝色的变浅显示了潜在兴趣递减的过程。
+
+一个可能出现的问题是在跳数$k$增加的过程中涟漪集的大小可能过大。为了解决这个问题，注意到：
 
 (1)在真实使用的知识图谱中大量的实体是沉没实体，意思是它们只有传入链路而没有传出链路。
 
 (2)在电影推荐的具体情境下，关系可以限制在情境相关的分类中以减少涟漪集的数量并提高实体间的相关度。
 
-(3)最大跳数$H$通常在实际应用中不会太大，因为离用户历史列表较远的实体会带来更多的嗓音而不是较好的信号。
+(3)最大跳数$H$通常在实际应用中不会过大，因为离用户历史偏好集较远的实体会带来更多的错误推荐而不是更丰富的推荐结果。
 
-(4)在涟漪网络中，我们可以对一个固定大小的邻集而不是对完整的涟漪集采样从而更进一步地减小计算工作量。设计这样的采样器是一个未来的重要工作，尤其是非统一的采样器能更好地捕获用户的分等级的潜在兴趣。
+(4)在涟漪网络中，我们可以对一个固定大小的邻集而不是对完整的涟漪集采样从而更进一步地减小计算工作量。设计这样的采样器是一个重要的工作，尤其是非统一的采样器能更好地捕获用户的分等级的潜在兴趣。
 \subsection{偏好扩散}
 \label{sec:osum}
-在传统的协同过滤算法中是通过学习用户与物品的潜在联系来完成推荐过程，而在涟漪网络算法中，这一过程是通过偏好扩散完成的：对每一个用户，涟漪网络将它的过往兴趣视为一个知识图谱中的种子集，然后沿知识图谱中的路径重复地拓展用户的兴趣来发现它的按等级划分的关于一个候选物品的潜在的兴趣。我们使用真实的由雨滴产生的涟漪在水面上扩散来模拟偏好扩散，其中多个“涟漪”重叠形成一个知识图谱上的作为结果的用户偏好分布。
+传统的协同过滤算法是通过学习用户与物品间的潜在联系来完成推荐，而在涟漪网络算法中，这一过程是通过偏好扩散完成的：对每个用户，涟漪网络将他的过往兴趣视为知识图谱中的种子集，然后沿知识图谱中的路径不断地拓展用户的潜在兴趣集，进而得到按等级划分的关于候选物品的潜在兴趣集。我们利用现实生活中的由雨滴产生的涟漪在水面上扩散来模拟偏好扩散的过程，其中多个“涟漪”重叠形成基于知识图谱的用户偏好分布。
+
+如图~\ref{fig:ripplenet-framework}，每部电影都有一个嵌入表示$v$，$v\in \mathbb{R}^{d}$，其中$\mathbb{R}$是实数集，$d$是嵌入表示向量的维数。给定电影的嵌入表示$v$以及用户$1$跳涟漪集$S_u^{1}$，可以利用电影$v$、$S_u^{1}$中的三元组中头节点$head_i$以及该三元组中的关系$r_i$来计算出电影$v$和实体$head_i$之间的相关度，如式\eqref{eq:item-entity-relevance}所示。
 
-如图~\ref{fig:ripplenet-framework}，每一部电影都具有一个嵌入表示v，$v\in R^{d}$，其中$d$是嵌入表示向量的维数。嵌入表示可以包含实体的独热编码\cite{koren2008factorization}、词汇集\cite{wang2018dkn}、上下文信息\cite{sun2017collaborative}或属性\cite{wang2018shine}，而选择哪一种嵌入向量的计算方式取决于其应用场合。给定电影的嵌入表示v以及用户$1$跳涟漪集$S_u^{1}$，每一个$S_U^{1}$中的事实三元组（$h_i$，$r_i$，$t_i$）根据电影v以及三元组中的头节点$head_i$的比较和三元组中的关系$r_i$来确定电影$v$和实体$head_i$之间的相关度：
 \begin{equation}
 	p_i=softmax(v^TR_ih_i)=\frac{exp(v^TR_ih_i)}{\sum_{(h, r, t)\in S_u^1} exp(v^TRh)}\label{eq:item-entity-relevance}
 \end{equation}
-其中$R_i\in R^{d\times d}$与$h_i\in R^d$分别是关系$r_i$和头节点$h_i$的嵌入表示。相关度$p_i$可以认为是在向量空间$R_i$中的电影v与实体$h_i$之间的相似度。同时还将关系信息的嵌入表示矩阵在计算电影v与实体$h_i$之间的相似度时纳入考量，因为不同就电影-实体对之间的相似度在具有不同关系信息时可能有所不同。比如，“阿甘正传”与“回到未来”在导演方面有很高的相似度，但它们在考虑体裁信息或剧作家方面可能没有任何联系。
 
-在取得相似度信息之后，将$S_u^{1}$中三元组的尾节点根据计算得到的相似概率进行加权求和，得到向量$o^{1}_u$：
+式\eqref{eq:item-entity-relevance}中，$R_i\in \mathbb{R}^{d\times d}$与$h_i\in \mathbb{R}^d$分别是关系$r_i$和头节点$h_i$的嵌入表示。相关度$p_i$为向量空间$R_i$中的电影$v$与实体$h_i$之间的相似度。同时还考虑了关系信息的嵌入表示矩阵在计算电影$v$与实体$h_i$之间的相似度，因为不同电影-实体对之间的相似度在不同关系的场景下可能有所不同。比如，“阿甘正传”与“回到未来”在导演方面有很高的相似度，但它们在体裁或剧作家方面可能没有联系。
+
+在完成相似度计算之后，将$S_u^{1}$中三元组的尾节点根据计算得到的相似度进行加权求和，得到向量$o^{1}_u$，如式\eqref{eq:o1}所示。
+
 \begin{equation}
 	o^1_u=\sum_{(h_i,r_i,t_i)\in S_u^1}p_it_i\label{eq:o1}
 \end{equation}
-式~\eqref{eq:o1}中$t_i\in R^{d}$是事实三元组中的尾节点$t_i$。向量$o^{1}_u$可以视为用户偏好集$V_u$关于电影$v$的1次反应。与协同过滤算法类似的是，它根据用户交互过的物品来表示用户嵌入而不是使用单独的参数来表示用户并以此来缩减参数。通过式~\eqref{eq:item-entity-relevance}与式~\eqref{eq:o1}，用户的偏好从其交互过的电影（种子集）成功在知识图谱中进行了一次扩散，这称为涟漪网络中的偏好扩散。
 
-注意到可以将式~\eqref{eq:item-entity-relevance}中的$v$替换为$o_u^1$，我们可以重复偏好扩散的过程以得到用户的2次反应$o_u^2$。以此类推，最终我们可以将该用户偏好集扩散至$H$跳。我们可以得到用户的涟漪集$S_u^{i}, i=1,\dots,H$。从中我们可以得到用户的不同次反应$o^{1}_u, o^{2}_u, o^{H}_u$。用户$u$关于电影$v$的嵌入表示由结合所有次不同反应计算得到：
+式\eqref{eq:o1}中，$t_i\in \mathbb{R}^{d}$，$t_i$是事实三元组中的尾节点。向量$o^{1}_u$可以视为用户偏好集$V_u$关于电影$v$的$1$次响应。与协同过滤算法类似的是，它根据用户交互过的物品来表示用户嵌入而不是使用单独的参数来表示用户，从而减少了参数数量。通过式\eqref{eq:item-entity-relevance}与式\eqref{eq:o1}，用户的偏好从其交互过的电影（即种子集）成功在知识图谱中进行了一次扩散，这称为涟漪网络中的偏好扩散。
+
+可以将式\eqref{eq:item-entity-relevance}中的$v$替换为$o_u^1$，我们可以再次进行偏好扩散以得到用户的2次响应$o_u^2$。以此类推，最终我们可以将该用户的偏好集扩散至$H$跳，得到用户的涟漪集$S_u^{i}, i=1,\dots,H$。从中可以得到用户的多次响应$o^{1}_u, o^{2}_u, o^{H}_u$。用户$u$关于电影$v$的嵌入表示是通过结合所有的不同响应并计算得到的，如式\eqref{eq:osum}所示。
 \begin{equation}
 	u=o_u^1+o_u^2+\dots+o_u^H\label{eq:osum}
 \end{equation}
-尽管最后一跳的用户响应中理论上包含了所有之前跳的信息，但对$o^k_u$进行求和仍然是有必要的，因为最后一跳的用户响应可能在偏好传递的过程中稀释了，不能很好地表示用户嵌入。最终，用户嵌入与电影嵌入相结合以来输出预测的用户对电影感兴趣的概率：
+
+尽管最后一跳的用户响应中理论上包含了所有之前得到的信息，但是对$o^k_u$进行求和仍然是有必要的，因为之前得到的用户响应可能在偏好传递的过程中稀释了，因此仅使用最后一跳的响应不能很好地表示用户嵌入。最终，利用用户嵌入与电影嵌入，计算出用户对电影感兴趣的概率，如式\eqref{eq:predicted-possibility}所示。
 \begin{equation}
 	y_{uv}=\zeta(u^Tv)\label{eq:predicted-possibility}
 \end{equation}
+
 其中，$\zeta(x)=\frac{1}{1+exp(-x)}$是sigmoid函数。
 \section{学习算法}
-在涟漪网络算法中我们的目标是通过式~\eqref{eq:predicted-possibility}求出用户对电影感兴趣的概率。但是，为了将其计算出来我们需要先求出所有物品、用户以及关系的嵌入表示，如第\ref{sec:osum}节中所述，用户的嵌入表示可以通过其涟漪集来代替，以此消元。但物品及关系的嵌入表示却是需要求出来的。
+在涟漪网络算法中，我们的目标是通过式\eqref{eq:predicted-possibility}求出用户对电影感兴趣的概率。但是，为了将其计算出来我们需要先求出所有物品、用户以及关系的嵌入表示，如第\ref{sec:osum}节中所述，用户的嵌入表示可以通过其涟漪集来代替，以此消元。但物品及关系的嵌入表示却是需要求出来的。
 
-为了求出物品及关系的嵌入表示，我们使用最大后验概率估计的方法。
+为了求出物品及关系的嵌入表示，这里使用最大后验概率估计的方法。
 
-我们的目标是在已经得到知识图谱$G$以及用户与电影的交互矩阵$\Upsilon$的情况下最大化模型参数$\Gamma$：
+我们的目标是在已经得到知识图谱$G$以及用户与电影的交互矩阵$\Upsilon$的情况下最大化模型参数$\Gamma$，如式\eqref{eq:max}所示。
 \begin{equation}
-	max\ p(\Gamma |G,\Upsilon)
+	max\ p(\Gamma |G,\Upsilon)\label{eq:max}
 \end{equation}
-其中参数$\Gamma$包含了所有的嵌入，包含全部的实体、关系和电影。这我等价于最大化
+
+式\eqref{eq:max}中，参数$\Gamma$包含了全部的实体、关系和电影的嵌入表示。可以将式\eqref{eq:max}等价于最大化式\eqref{eq:equal-max}。
+
 \begin{equation}
 	p(\Gamma |G,\Upsilon)=\frac{p(\Gamma,G,\Upsilon)}{p(G,\Upsilon)}\varpropto p(\Gamma)\centerdot p(G|\Gamma)\centerdot p(\Upsilon|\Gamma,G)\label{eq:equal-max}
 \end{equation}
-根据贝叶斯公式，在式~\eqref{eq:equal-max}中，第一项$p(\Gamma)$测量模型参数的先验概率。我们将$p(\Gamma)$设为均值为0，方差为对角协方差矩阵的正态分布：
+
+根据贝叶斯公式，在式\eqref{eq:equal-max}中，第一项$p(\Gamma)$代表模型参数的先验概率。设$p(\Gamma)$为均值为0，方差为对角协方差矩阵的正态分布，如式\eqref{eq:normal-distribution}所示。
+
 \begin{equation}
-	p(\Gamma)=N(0,\lambda_1^{-1}I)
+	p(\Gamma)=N(0,\lambda_1^{-1}I)\label{eq:normal-distribution}
 \end{equation}
-式~\eqref{eq:equal-max}中的第二项是给定$\Gamma$的知识图谱的最大似然函数。最近，有研究者提出了许多种计算知识图谱嵌入的方法，包括基于距离的方法和基于语义匹配的方法。在本算法中，我们使用三路张量分解的方法来建立知识图谱嵌入的最大似然函数：
+
+式\eqref{eq:equal-max}中，$p(G|\Gamma)$是给定$\Gamma$的知识图谱的最大似然函数。最近，有研究者提出了多种计算知识图谱嵌入的方法，包括基于距离的方法和基于语义匹配的方法。在本算法中，使用三路张量分解的方法来建立知识图谱嵌入的最大似然函数，如式\eqref{eq:term2}。
+
 \begin{equation}
 	p(G|\Gamma)=\prod_{(h,r,t)\in E\times R\times E}p((h,r,t)|\Gamma)=\prod_{(h,r,t)\in E\times R\times E}N(I_{h,r,t}-h^TRt,\lambda_2^{-1})\label{eq:term2}
 \end{equation}
-其中若$I_{h,r,t}\in G$则标志$I_{h,r,t}$等于1否则为0。基于式~\eqref{eq:term2}中的定义，知识图谱嵌入中的实体对评分函数与偏好传递过程中的电影-实体对可以在相同的计算模型下被统一。式~\eqref{eq:equal-max}中的第三项是给定$\Gamma$与知识图谱的似然函数，可以看作伯努利分布的累乘：
+
+式\eqref{eq:term2}中，若$I_{h,r,t}\in G$则标志$I_{h,r,t}$等于1,否则为0。式\eqref{eq:equal-max}中的第三项是给定$\Gamma$与知识图谱的似然函数，可以看作伯努利分布的累乘，如式\eqref{eq:bernoulli}。
+
 \begin{equation}
-	p(\Upsilon|\Gamma,G)=\prod_{(u,v)\in \Upsilon}\zeta(u^Tv)^{y_{uv}}\centerdot (1-\zeta (u^Tv))^{1-y_{uv}}
+	p(\Upsilon|\Gamma,G)=\prod_{(u,v)\in \Upsilon}\zeta(u^Tv)^{y_{uv}}\centerdot (1-\zeta (u^Tv))^{1-y_{uv}}\label{eq:bernoulli}
 \end{equation}
-对式~\eqref{eq:equal-max}取负对数，我们有下面的损失函数：
+
+对式\eqref{eq:equal-max}取负对数，有如式\eqref{eq:term3}所示的损失函数：
 \begin{multline}
 	min\ L=-log(p(\Upsilon|\Gamma,G)\centerdot p(G|\Gamma)\centerdot p(\Gamma))\\
 =\sum_{(u,v)\in \Upsilon}-(y_{uv}log\ \zeta(u^Tv)+(1-y_{uv}log(1-\zeta(u^Tv))))\\
 +\frac{\lambda_2}{2}\sum_{r\in R}\|I_r-E^TRE\|_2^2+\frac{\lambda_1}{2}(\|V\|^2_2+\|E\|^2_2+\sum_{r\in R}\|R\|^2_2)\label{eq:term3}
 \end{multline}
-其中$V$和$E$是对所有电影与实体的嵌入表示。$I_r$是在知识图谱中的对关系$r$的标志向量$I$的分片。在式~\eqref{eq:term3}中第一项度量交互矩阵$\Upsilon$与由涟漪网络的估测值之间的交叉熵，第二项度量真实的知识图谱分片$I_r$以及人为构建的指示矩阵$E^{T}RE$之间的均方误差，最后一项是为防止过拟合加入的正则项。
 
-直接求解上式来得到参数$\Gamma$是不可能的，因此我们使用随机梯度下降算法递归地优化损失函数来求解模型参数。然后我们再计算关于参数$\Gamma$的损失函数的梯度并更根据采样得到的一小批数据反向传递以更新参数并最终得到参数$\Gamma$。
+式\eqref{eq:term3}中，$V$和$E$是所有电影与实体的嵌入表示，$I_r$是在知识图谱中对关系$r$的标志向量$I$的分向量。在式\eqref{eq:term3}中，第一项是交互矩阵$\Upsilon$与涟漪网络的估测值之间的交叉熵，第二项是真实的知识图谱分向量$I_r$以及人为构建的指示矩阵$E^{T}RE$之间的均方误差，最后一项是为防止过拟合加入的正则项。
+
+直接求解上式来得到参数$\Gamma$是不可能的，因此可以使用随机梯度下降算法递归地优化损失函数来求解模型参数，而后再计算参数$\Gamma$的损失函数的梯度，并根据采样得到的一小批数据反向传递，然后更新参数并最终得到参数$\Gamma$。
 \section{分析}
 \subsection{可解释性}
-可解释的推荐系统旨在阐释为什么用户会对一件物品感兴趣，这帮助提升用户对推荐结果的满意度以及对推荐系统的信任。对推荐结果的解释通常基于标签、语义分析等。因为涟漪网络探索用户基于知识图谱的兴趣，因此它提供了一种基于知识图谱中的关系路径来阐述推荐结果的全新方式。比如，在图~\ref{fig:illustration-of-ripple-sets}中，当用户对“幸福终点站”感兴趣，则该用户也可能对“荒岛余生”感兴趣。因为在知识图谱中，“汤姆·汉克斯”与“幸福终点站”相连，关系是演员，而“汤姆·汉克斯”与“荒岛余生”也相连，关系也是演员，也就是说“荒岛余生”与“幸福终点站”有相同的演员。这便解释了为什么当用户对“幸福终点站”感兴趣，则该用户也可能对“荒岛余生”感兴趣。而涟漪网络算法正是通过这种方式运作的。涟漪网络算法通过在知识图谱中寻找与用户交互过的电影（种子集）相连的物品，并不断扩散，最终推荐结果之所以拥有较高的准确性，正是因为如上所述的原因。
+可解释的推荐系统旨在阐释为什么用户会对一件物品感兴趣，这帮助提升用户对推荐结果的满意度以及对推荐系统的信任。对推荐结果的解释通常基于标签、语义分析等。因为涟漪网络探索用户基于知识图谱的兴趣，因此它提供了一种基于知识图谱中的关系路径来阐述推荐结果的全新方式。比如，在图~\ref{fig:illustration-of-ripple-sets}中，当用户对“幸福终点站”感兴趣，则该用户也可能对“荒岛余生”感兴趣。因为在知识图谱中，“汤姆·汉克斯”与“幸福终点站”相连，关系是演员，而“汤姆·汉克斯”与“荒岛余生”也相连，关系也是演员，换句话说，“荒岛余生”与“幸福终点站”有相同的演员。这便解释了用户对“幸福终点站”和“荒岛余生”同时感兴趣的原因。涟漪网络算法通过在知识图谱中寻找与用户交互过的电影（种子集）相连的物品，并不断扩散，最终确保推荐结果具有较高的准确性。
 \subsection{涟漪重叠}
-在涟漪网络中一个常见的现象是用户涟漪集中的电影可能非常多，而会在偏好传递的过程中不可避免地导致其真实的潜在偏好信息被稀释。然后，观察到用户点击记录中不同的电影常常高度重叠。换句话说，从种子集出发到达一部电影常常有不止一条路径。比如，在图~\ref{fig:illustration-of-ripple-sets}中，如果一个用户喜欢“阿甘正传”，则他也可能喜欢“荒岛余生”。在该知识图谱中，从“阿甘正传”到“荒岛余生”有两条路径：“阿甘正传-U.S.-荒岛余生”与“阿甘正传-汤姆·汉克斯-荒岛余生”，这正是涟漪重叠的表现。
+在涟漪网络中，一个可能的问题是涟漪集中的电影非常多，从而在偏好传递的过程中不可避免地导致用户的真实潜在偏好信息被稀释。然而，用户点击记录中不同的电影常常高度重叠（从种子集出发到达一部电影常常有不止一条路径），这在很大程度上避免了真实潜在偏好信息被稀释的问题。比如，在图~\ref{fig:illustration-of-ripple-sets}中，如果一个用户喜欢“阿甘正传”，则他也可能喜欢“荒岛余生”。在该知识图谱中，从“阿甘正传”到“荒岛余生”有两条路径：“阿甘正传-U.S.-荒岛余生”与“阿甘正传-汤姆·汉克斯-荒岛余生”，这正是涟漪重叠的表现。
 \section{测试}
 \subsection{数据集}
-该测试使用“电影透镜1兆数据”数据集。该数据集由电影信息、用户信息以及用户对电影的评分三部分组成。其中，含有电影数据3883条、用户数据6040条以及1000209条用户对电影的评分数据。因该数据集数据量适中，数据准确可靠，因此在推荐系统的性能测试中被广泛使用。
+本测试使用“MovieLens 1M Dataset”数据集。该数据集由电影信息、用户信息以及用户对电影的评分三部分组成。其中，含有电影数据3883条、用户数据6040条以及1000209条用户对电影的评分数据。因该数据集数据量适中，数据准确可靠，因此在推荐系统的性能测试中被广泛使用。
 
-对于知识图谱，该测试依据“电影透镜1兆数据”中的电影从Microsoft Satori中提取相关的知识图谱数据来构建知识图谱。
+本测试使用的知识图谱来自Microsoft Satori，是依据“MovieLens 1M Dataset”中的电影名称从Microsoft Satori中提取相关的节点的与关系数据得到的。
 \subsection{基线}
-在本测试中，将本算法的测试结果与以下算法的相比较：
+本测试中，会将本算法的测试结果与以下算法的相比较：
 
-DKN\cite{wang2018dkn}是之前同样由微软团队在 WWW2018 会议上发表的。它是一个主要针对新闻任务提出的框架，知识图谱用在对新闻标题作嵌入的层面。DKN 提出对新闻标题内每一个关键实体，在知识图谱内找到其实体嵌入和上下文嵌入。
+DKN\cite{wang2018dkn}是由微软团队在WWW2018会议上发表的。它是一个主要针对新闻任务提出的框架，知识图谱用于辅助计算新闻标题的嵌入表示。DKN提出对新闻标题内每一个关键实体，在知识图谱内找到其实体嵌入和上下文嵌入。
 
-CKE\cite{zhang2016collaborative} 是微软在 KDD2016 年发表的，其模型结构在原有系统过滤得到 U, V 向量的基础上，将物品的嵌入与其他描述信息相结合，这些信息主要有:
-采用 TransR 算嵌入得到的知识图谱，图谱内每个实体嵌入表示被提取为物品的结构化向量信息。
+CKE\cite{zhang2016collaborative}是微软在KDD2016年发表的，其模型结构在原有系统过滤得到 $U$,$V$向量的基础上，将物品的嵌入与其他描述信息相结合，这些信息主要有:
+采用TransR算法计算知识图谱嵌入表示，知识图谱内每个实体嵌入表示被提取为物品的结构化向量信息。
 采用SDAE模型得到物品描述性文本的文本性嵌入表示。
 采用SCAE模型得到物品相关图像的视觉嵌入表示。
 
-SHINE\cite{wang2018shine}设计深度自编码器来嵌入语义网络，社交网络来进行推荐。其为用户-物品的交互使用自动编码器并刻画用户感兴趣的概率。
+SHINE\cite{wang2018shine}设计深度自编码器并嵌入语义网络以及社交网络来进行推荐。其为用户-物品的交互使用自动编码器并刻画用户感兴趣的概率。
 
-PER\cite{yu2014personalized}将知识图谱作为辅助信息基于路径的方法中比较经典的算法，是对后续模型做的改进。其提出的元路径可以为推荐系统提供可靠的方向，但是需要事先熟悉领域内知识，进行人为路径设计。
+PER\cite{yu2014personalized}是以基于路径的方法来将知识图谱作为辅助信息中的比较经典的算法。其提出的元路径可以为推荐系统提供可靠的方向，但是需要使用者了解领域内知识，进行人为路径设计。
 
-LibFM\cite{rendle2012factorization}是一个广泛使用的基于功能的在CTR场景中的分解模型。
+LibFM\cite{rendle2012factorization}是一个广泛使用的在CTR场景中的分解推荐模型。
 
 Wide\&Deep\cite{cheng2016wide}是一个结合线性路径的推荐模型。类似于LibFM，我们将用户、物品及实体的嵌入表示作为其输入。
 \subsection{测试步骤}
-在涟漪网络中，设置跳数$H$=2。根据实验结果，较大的跳数几乎无法提高性能却会造成较大的计算负担。我们将数据划分为训练集、评估集与测试集，按照6:2:2的比较。实验进行5次，计算准确度与AUC然后取平均值。
+在涟漪网络中，设置跳数$H=2$。根据实验结果，较大的跳数几乎无法提高性能却会造成较大的计算开销。我们将数据划分为训练集、评估集与测试集，按照6:2:2的比例进行分配。实验进行5次，计算准确度以及AUC然后取平均值。
 \subsection{结果}
 测试结果如表~\ref{tab:acc-auc}中所示，总体上涟漪网络算法的性能最佳，其次是Wide\&Deep算法，说明他们可以充分利用知识图谱中的有效信息来辅助推荐算法。而表现最差的是PER算法，这可能是因为手工定义的元路径在电影推荐方面效果较差。
 \begin{table}
@@ -338,23 +336,21 @@ Wide\&Deep\cite{cheng2016wide}是一个结合线性路径的推荐模型。类�
 	  \bottomrule
 	\end{tabular}
 \end{table}
-\chapter{电影推荐系统}
+\chapter{基于知识图谱的电影推荐系统}
 \section{系统整体设计}
-如第\ref{sec:tech-stack}节中所述，本系统使用的数据来自“电影透镜1兆数据”、IMDb和豆瓣。其中IMDb和豆瓣的数据是使用爬虫处理的。最后再使用Python脚本对数据进行处理加工，并导入MongoDB和Neo4j。
+如第\ref{sec:tech-stack}节中所述，本系统使用的数据来自“MovieLens 1M Dataset”、IMDb和豆瓣网。其中IMDb和豆瓣网的数据是使用爬虫爬取得到的。最后再使用Python脚本对这些数据进行处理加工，并导入MongoDB数据库和Neo4j数据库。
 
-本系统使用MongoDB和Neo4j存储数据。其中，MongoDB作为非关系型的新兴NoSQL数据库，以灵活非结构化的方式存储普通用户数据、管理员数据、电影数据等，并提供高并发的性能支持与可分布式存储的扩展性。而在以高性能著称的图数据库Neo4j中，则存储用于推荐算法使用的电影知识图谱信息。
+本系统使用MongoDB和Neo4j存储数据。其中，MongoDB作为非关系型的新兴NoSQL数据库，以灵活的非结构化的方式存储普通用户数据、管理员数据、电影数据等，并提供高并发的性能支持与可分布式存储的扩展性。而在以高性能著称的图数据库Neo4j中，存储用于推荐算法使用的电影知识图谱。
 
-本系统后端使用由Python编写的Flask框架，Flask框架是轻量级的微框架，以高可扩展性著称，为本系统的后端网页应用服务器提供支持。
+本系统后端使用Python编写的Flask框架，Flask框架是轻量级的微框架，以高可扩展性著称，为本系统的后端网页应用服务器提供支持。在Flask中，基于REST风格构建API以供前端使用，REST风格的语义化API使后端API的构建与前端API的使用简单方便。
 
-在Flask中，基于REST风格构建API以供前端使用，REST风格的语义化API使后端API的构建与前端API的使用清晰明了。
-
-本系统前端使用Angular作为前端网页框架。Angular是基于TypeScript的网页框架，以模块化及可重用的组件设计著称。Angular为本系统提供了模块化的网页设计，使本系统前端逻辑清晰，易于维护。此外，本系统使用了Angular材料组件库（Angular Material Components），得益于此，本系统遵循材料设计（Material Design）语言，使视觉传达风格清晰明了，具有网格化的布局、响应式动化与过渡效过、光线与阴影等。
+本系统前端使用Angular作为前端网页框架。Angular是基于TypeScript的网页框架，以模块化及可重用的组件设计著称。Angular为本系统提供了模块化的网页设计，使本系统前端逻辑清晰，易于维护。此外，本系统使用了Angular材料组件库（Angular Material Components），得益于此，本系统遵循材料设计（Material Design）语言，使视觉传达风格简洁美观，具有响应式动化与过渡效过、光线与阴影等。
 \section{数据库设计}
-如前所述，本系统MongoDB用于存储普通用户数据、管理员数据、电影数据等，而Neo4j作为高性能的图数据，用于存储知识图谱。Neo4j的存储逻辑较简单，此处不作介绍。以下说明MongoDB中数据的存储方式。
+如前所述，本系统的MongoDB数据库用于存储普通用户数据、管理员数据、电影数据等，而Neo4j作为高性能的图数据库，用于存储知识图谱。以下逐一说明MongoDB数据库与Neo4j数据库的存储结构。
 
-不同于MySQL等关系型数据库，MongoDB作为非结构化存储的NoSQL数据库，没有表、列与行的概念，而只有集合与文档的概念，即在数据库中存储集合（一定程度上对应于关系型数据库的表），在表中存储文档（一定程度上对应于关系型数据库的行），而关系型数据库中的列则对应于MongoDB中文档的属性。
+不同于MySQL等关系型数据库，MongoDB数据库作为非结构化存储的NoSQL数据库，没有表、列与行的概念，而只有集合与文档的概念，即在数据库中存储集合（一定程度上对应于关系型数据库的表），在集合中存储文档（一定程度上对应于关系型数据库的行），而关系型数据库中的列则对应于MongoDB数据库中文档的属性。
 
-本系统在MongoDB中建立4个集合，分别用于用户、管理员、体裁与电影数据。因其中的数据为非结构化数据，因此无法用表格的形式给出，目前习惯上以JSON结构给出数据逻辑结构，故以下以JSON结构来表示存储结构：
+本系统在MongoDB数据库中建立4个集合，分别用于存储用户、管理员、体裁与电影数据。因其中的数据为非结构化数据，因此无法用表格的形式给出，目前习惯上以JSON形式给出数据的逻辑结构，以下以JSON形式来表示存储结构：
 
 以下为普通用户集合的数据结构，用户集合中的文档存储用户ID、哈希处理后的密码、其评价过的电影（包括电影ID、评分及时间）以及由推荐算法服务器写入的推荐列表、已购买电影及心愿单：
 \begin{verbatim}
@@ -375,7 +371,7 @@ Wide\&Deep\cite{cheng2016wide}是一个结合线性路径的推荐模型。类�
     }
 \end{verbatim}
 
-以下来管理员集合的数据结构，其存储结构较简单，管理员集合中的文档存储管理员ID、哈希处理后的密码：
+以下为管理员集合的数据结构，其存储结构较简单，管理员集合中的文档存储管理员ID、哈希处理后的密码：
 \begin{verbatim}
     {
         _id: String,
@@ -407,55 +403,75 @@ Wide\&Deep\cite{cheng2016wide}是一个结合线性路径的推荐模型。类�
         actors: Array([String, ...]),
     }
 \end{verbatim}
+
+Neo4j数据库用于存储推荐算法使用的知识图谱，其中的数据结构可表示为：
+\begin{verbatim}
+    node: actor | country | director | film | genre | language 
+        | person_or_entity_appearing_in_film | rating | star 
+        | writer
+    relationship: actor.film | director.film | film.country
+        film.director | film.genre | film.language | film.rating
+        film.star | film.writer | genre.film 
+        | person_or_entity_appearing_in_film.film | writer.film
+    edge = (node) - [relationship] -> (node)
+\end{verbatim}
 \section{系统功能说明}
 \begin{figure}
-	\includegraphics[width=\textwidth]{use-case}
+	\includegraphics{use-case}
 	\bicaption{系统功能用例图}{Use case diagram for the system }\label{fig:use-case}
 \end{figure}
 本系统用户角色分为未登录用户、普通用户与管理员用户，其用例说明如图~\ref{fig:use-case}。
+\subsection{系统导航}
+本系统使用浮动侧边栏作为导航方式，如图~\ref{fig:admin-navigation}。点击侧导航栏右下角的固定的按钮可以将浮动侧边栏设为固定，再次点击后将取消固定。
+\begin{figure}
+	\fbox{\includegraphics[width=.94\textwidth]{admin-navigation}}
+	\bicaption{系统侧导航栏（管理员）}{Side navigation panel of the system (for administrators)}\label{fig:admin-navigation}
+\end{figure}
+
 \subsection{未登录用户}
 未登录用户能进行以下操作：
 
-\noindent （1）接收随机的电影推荐。
+\noindent （1）接收随机的电影推荐
 
-未登录用户首页随机显示50部电影，如图~\ref{fig:anonymous-index}所示：
+未登录用户首页随机显示50部电影，如图~\ref{fig:anonymous-index}。
 \begin{figure}
-	\includegraphics[width=.96\textwidth]{anonymous-index}
+	\fbox{\includegraphics[width=.94\textwidth]{anonymous-index}}
 	\bicaption{未登录用户首页}{Index page for anonymous user }\label{fig:anonymous-index}
 \end{figure}
 
-\noindent （2）按分类查看电影。
+\noindent （2）按分类查看电影
 
-未登录用户可以根据电影的分类来查看电影，如图~\ref{fig:anonymous-category}所示：
+未登录用户可以根据电影的分类来查看电影，如图~\ref{fig:anonymous-category}。
 \begin{figure}
-	\includegraphics[width=.96\textwidth]{anonymous-category}
+	\fbox{\includegraphics[width=.94\textwidth]{anonymous-category}}
 	\bicaption{未登录用户分类页面}{Category page for anonymous user }\label{fig:anonymous-category}
 \end{figure}
 
-\noindent （3）查看电影详情。
+\noindent （3）查看电影详情
 
-未登录用户可以查看电影详情，如图~\ref{fig:anonymous-details}。而点击页面上的“添加至心愿单”和“购买”会跳转至登录界面。
+未登录用户可以查看电影详情，如图~\ref{fig:anonymous-details}。点击页面上的“添加至心愿单”和“购买”会跳转至登录界面。
 \begin{figure}
-	\includegraphics[height=.7\textheight]{anonymous-details}
+	\fbox{\includegraphics[height=.7\textheight]{anonymous-details}}
 	\bicaption{未登录用户电影详情页面}{Movie details page for anonymous user }\label{fig:anonymous-details}
 \end{figure}
+
 \noindent （4）搜索电影
 
-未登录用户可从应用栏右部的搜索框搜索电影，本系统支持模糊搜索。
+未登录用户可以在应用栏右部的搜索框搜索电影，如图~\ref{fig:anonymous-search}。本系统支持模糊搜索，与此同时，随着用户搜索内容的不断输入，系统会在搜索框下方显示候选的匹配词条，方便用户直接点击查看，此外，用户也能通过回车跳转至完整的搜索结果页面。
+\begin{figure}
+	\fbox{\includegraphics[width=.94\textwidth]{anonymous-search}}
+	\bicaption{未登录用户电影搜索界面（侧导航栏已固定）}{Movie search page for anonymous user (side navigation panel pinned)}\label{fig:anonymous-search}
+\end{figure}
 \subsection{注册与登录}
 \noindent（1）注册
 
-本系统对普通用户开放注册功能，如图~\ref{fig:sign-up}，并能提供用户名是否含不合法字符、是否与已注册用户名冲突、密码是否符合复杂度要求等的检测。
-\begin{figure}
-	\includegraphics[width=.96\textwidth]{sign-up}
-	\bicaption{注册页面}{Sign up page}\label{fig:sign-up}
-\end{figure}
+本系统对普通用户开放注册功能，并能提供用户名是否含不合法字符、是否与已注册用户名冲突、密码是否符合复杂度要求等的检测。
 
 \noindent （2）登录
 
-本系统提供登录功能，并能根据不同的登录错误类型作出不同的响应。
+本系统提供登录功能，并能根据不同的登录错误类型相应地作出响应。
 \subsection{普通用户}
-普通用户具备未登录用户的所有功能。此外，还具有以下功能：
+普通用户具备未登录用户的所有功能。此外，还具备以下功能：
 
 \noindent （1）添加心愿单
 
@@ -465,12 +481,12 @@ Wide\&Deep\cite{cheng2016wide}是一个结合线性路径的推荐模型。类�
 
 已登录用户能在电影详情页面购买电影。
 
-\noindent （3）评价
+\noindent （3）评分
 
-已登录用户能在电影详情页面评价电影。电影评价功能位于电影详情页面，对于未登录用户不显示用于评分的组件，对于已登录用户显示，如图~\ref{fig:general-details}所示。
+已登录用户能在电影详情页面给电影评分。电影评分功能位于电影详情页面，如图~\ref{fig:general-details}所示。
 
 \begin{figure}
-	\includegraphics[width=.96\textwidth]{general-details}
+	\fbox{\includegraphics[width=.94\textwidth]{general-details}}
 	\bicaption{电影评分页面}{Rating page for movies}\label{fig:general-details}
 \end{figure}
 
@@ -486,52 +502,60 @@ Wide\&Deep\cite{cheng2016wide}是一个结合线性路径的推荐模型。类�
 
 管理员能增加电影、删除电影与修改电影信息，如图~\ref{fig:admin-movie}所示。
 \begin{figure}
-	\includegraphics[width=.96\textwidth]{admin-movie}
-	\bicaption{管理电影页面}{Movie administration page }\label{fig:admin-movie}
+	\fbox{\includegraphics[width=.94\textwidth]{admin-movie}}
+	\bicaption{管理电影页面}{Movie administration page}\label{fig:admin-movie}
 \end{figure}
 
 \noindent （2）管理用户信息
 
 管理员能增加用户、删除用户与修改用户密码。
+
+\noindent （3）管理知识图谱
+
+管理员能增加、删除、修改以及查找知识图谱中的结点与关系，如图~\ref{fig:admin-knowledge-graph}所示。该界面中的结点及关系可以以动态的方式呈现，同时支持以填写选项的方式以及使用Cypher语句的方式来增加、删除、修改以及查找知识图谱中的结点与关系。当鼠标悬浮于某一节点或关系之上时，将显示有关这一节点或关系的有关信息。
+\begin{figure}
+	\fbox{\includegraphics[width=.94\textwidth]{admin-knowledge-graph}}
+	\bicaption{管理知识图谱页面}{Knowledge graph administration page}\label{fig:admin-knowledge-graph}
+\end{figure}
 \section{电影推荐流程}
 本系统的推荐流程分为离线推荐与实时推荐，如图~\ref{fig:recommendation-procedure}所示。
 
 \begin{figure}
-	\includegraphics[width=\textwidth]{recommendation-procedure}
-	\bicaption{系统电影推荐流程}{Movie recommendation procedure }\label{fig:recommendation-procedure}
+	\includegraphics{recommendation-procedure}
+	\bicaption{电影推荐流程}{Movie recommendation procedure }\label{fig:recommendation-procedure}
 \end{figure}
 
-其中，离线推荐使用第\ref{ch:offline-recommendation}章中所述的涟漪网络算法，而实时推荐作为补充，描述如下：
+其中，离线推荐使用第\ref{ch:offline-recommendation}章中所述的涟漪网络算法，而实时推荐机制作为补充，描述如下：
 
-（1）离线推荐服务器定期运行涟漪网络算法。离线推荐服务器从MongoDB服务器获取用户信息与电影评分、电影是否加入心愿单等数据以及从Neo4j服务器获取知识图谱数据信息。然后执行涟漪网络算法。最后离线推荐服务器将计算得到的各用户推荐列表存入MongoDB数据库中，等待用户访问时将该结果推荐给用户。
+（1）离线推荐服务器定期运行涟漪网络算法。离线推荐服务器从MongoDB数据库服务器获取用户信息与电影评分、电影是否加入心愿单等数据以及从Neo4j数据库服务器获取知识图谱数据信息。然后执行涟漪网络算法。最后离线推荐服务器将计算得到的各用户推荐列表存入MongoDB数据库中，等待用户访问时将该结果推荐给用户。
 
 （2）当用户访问时，网页后端服务器查询推荐列表中的电影数据是否达到阀值，如果推荐列表中的数量过少，则根据用户交互随机将同体裁电影加入推荐列表的末端作为补充并最终显示给用户。
 
 上述步骤中，（1）中的离线推荐准确度高，但算法运算时间长，无法做到即时响应用户请求。（2）中的实时推荐方法准确度低，但算法运算快，可以做到实时响应请求并即时发出响应。两者相互补充组成了本系统的电影推荐算法。
 \section{系统安全性}
-本系统对已登录普通用户与管理员在前后端交互过程中使用JSON网络令牌（JSON Web Token, JWT）实现授权与认证（Authorization and Authentication），以此保证了系统的安全性，本系统的总体安全性设计如图~\ref{fig:jwt}所示。
+本系统对已登录普通用户与管理员在前后端交互过程中使用JSON网络令牌（JSON Web Token, JWT）实现授权与认证（Authorization and Authentication），以此保证系统的安全性，本系统的总体安全性设计如图~\ref{fig:jwt}所示。
 
 \begin{figure}
-	\includegraphics[height=.6\textheight]{jwt}
+	\includegraphics{jwt}
 	\bicaption{系统总体安全性设计}{Overall security design for the system}\label{fig:jwt}
 \end{figure}
 
 在用户登录时，Flask后端网页服务器会生成一个长期JSON网络令牌和一个临时JSON网络令牌，令牌中存储有用户id以及过期时间，并且该令牌使用非对称加密算法加密，其中含有由Flask后端网页服务器颁发的签名信息，这确保了JSON网络令牌不会被伪造。
 
-前端网页服务器在接收到令牌后会将令牌存储在浏览器的localStorage中，并在每一个接下来的请求头中附上该令牌，而后端服务器只有在该令牌有效（指确实为后端网页服务器颁发且该另令牌尚未过期）的情况下才会继续执行有关请求。与此同时，若该请求是用户内容相关，则后端服务器还会检测令牌中的id是否与请求内容中的id相同。若不满足以上任意一项，则后端网页服务器返回未授权错误信息。
+前端网页服务器在接收到令牌后会将令牌存储在浏览器的localStorage中，并在每一个接下来的请求头中附上该令牌，而后端服务器只有在该令牌有效（指确实为后端网页服务器颁发且该另令牌尚未过期）的情况下才会继续执行有关请求。与此同时，若该请求是用户内容相关的，则后端服务器还会检测令牌中的id是否与请求中使用的id相同。若不满足以上任意一项，则后端网页服务器返回未授权错误。
 
 其中，若后端网页服务器发现令牌过期，则会将该信息发送给前端网页服务器，前端网页服务器将会将长期令牌发送给后端服务器以刷新（renew）临时令牌。
 
-此外，本系统还使用了哈希算法对密码进行哈希处理，数据库中的密码全部为哈希处理后的密码。同时，用户登录过程是后端网页服务器使用原密码与哈希处理后的密码进行比较，而没有开放哈希处理后的密码与哈希处理后的密码进行比较，这提高了本系统的安全性。这在同时使网站仅允许HTTPS（HTTPS-only）网络连接的情况下可以充分保证本系统的安全性。
+此外，本系统还使用了哈希算法对密码进行哈希处理，数据库中的密码全部为哈希处理后的密码。同时，用户登录过程是后端网页服务器使用原密码与哈希处理后的密码进行比较，而没有开放哈希处理后的密码与哈希处理后的密码进行比较的接口，这保障了本系统的安全性。这在同时令网站仅允许HTTPS（HTTPS-only）网络连接的情况下可以充分保证本系统的安全性。
 
-需要注意的是，虽然本系统在用户登录与注册时的密码在前端没有进行哈希处理，但是本系统在部署时使用HTTPS-only的连接，在这种情况下，所有的数据传输都处于加密状态，避免了中间人攻击的可能，因此明文传输密码而不使用哈希处理是安全的，在实际应用过程中可行。而本系统在后端对由前端网页服务器传入的明文密码的目的是避免数据库中存入明文的密码。如果数据库中存入明文的密码，则当数据库中用户密码泄露时攻击者可以轻易使用泄露的密码登录本系统。而如上所述，本系统后端只开放了接收明文密码的接口，即直接将数据库中哈希处理后的密码与用户请求中的明文密码进行对比，即使攻击者获取了用户哈希后的密码，要计算其对应的明文密码是困难的，甚至在明文密码足够复杂的情况下是不可能的。以上措施保证了本系统的安全性。
+需要指出的是，虽然本系统在用户登录与注册时密码在前端没有进行哈希处理，但是本系统在部署时使用HTTPS-only的连接，在这种情况下，所有的数据传输都处于加密状态，避免了中间人攻击的可能，因此明文传输密码而不使用哈希处理是安全的，在实际使用的过程中可行。而本系统的后端网页服务器对前端网页服务器传入的明文密码进行哈希处理的目的是避免数据库中存入明文的密码。如果数据库中存入明文的密码，则当数据库中用户密码泄露时攻击者可以轻易使用泄露的密码登录本系统。而如上所述，本系统后端只开放了接收明文密码的接口，即只将数据库中哈希处理后的密码与用户请求中的明文密码进行对比，即使攻击者获取了用户哈希后的密码，要计算其对应的明文密码也是困难的，甚至在明文密码足够复杂的情况下是不可能的。因此，以上措施保证了本系统的安全性。
 \chapter{研究结论和展望}
 \section{工作总结}
-随着互联网的发展，用户可选择的电影数量不断增加，为了使用户快速找到感兴趣的电影，各种推荐算法应运而生。这些算法存在推荐准确性较低、数据稀缺性以及冷启动问题。本文针对此现状，以电影推荐为研究对象，使用知识图谱作为辅助信息，利用涟漪网络算法实现了电影推荐系统。具体地说，主要的研究工作如下：
+随着互联网的发展，用户可选择的电影数量不断增加，为了让用户快速找到感兴趣的电影，各种推荐算法应运而生。这些算法存在推荐准确性较低、数据稀缺性以及冷启动问题。本文针对此现状，以电影推荐为研究对象，使用知识图谱作为辅助信息，利用涟漪网络算法实现了电影推荐系统。具体地说，主要的研究工作如下：
 
-（1）从IMDb和豆瓣上使用基于Scrapy框架的爬虫爬取了3684部电影数据。其中，从IMDb爬取了3494部电影数据，从豆瓣爬取了190条电影数据（由于豆瓣限制了每IP访问量故爬取的数据较少）。这些电影数据包括电影封面图片、电影情节介绍、电影预告片图片、电影演员列表、导演以及剧本作家等信息。
+（1）使用基于Scrapy框架的爬虫从IMDb和豆瓣网上爬取了3684条电影数据。其中，从IMDb爬取了3494条电影数据，从豆瓣网爬取了190条电影数据（由于豆瓣网限制了每IP访问量故爬取的数据较少）。这些电影数据包括电影封面图片、电影情节介绍、电影预告片图片、电影演员列表、导演以及剧本作家等信息。
 
-（2）根据论文“涟漪网络：在知识图谱上传递用户偏好的推荐模型\cite{wang2018ripplenet}”设计并实现了基于知识图谱的涟漪网络推荐算法，通过使用“电影透镜1兆数据”数据集以及从IMDb和豆瓣上爬取的电影数据，实现了基于用户心愿单和用户评分并以知识图谱为辅助信息的推荐算法。并对实现的推荐算法进行了试验，并计算了其AUC和准确度两个关键的性能指标。并对比了DKN\cite{wang2018dkn}、CKE\cite{zhang2016collaborative}、PER\cite{yu2014personalized}、SHINE\cite{wang2018shine}、LibFM\cite{rendle2012factorization}以及Wide\&Deep\cite{cheng2016wide}算法的准确度结果。并以此发现，涟漪网络算法的性能最优。
+（2）根据文献\parencite{wang2018ripplenet}实现了基于知识图谱的涟漪网络推荐算法，通过使用“MovieLens 1M Dataset”数据集以及从IMDb和豆瓣网上爬取的电影数据，实现了基于用户心愿单和用户评分并以知识图谱为辅助信息的推荐算法。并对实现的推荐算法进行了试验，计算了其AUC和准确度两个关键的性能指标，将该指标与DKN\cite{wang2018dkn}、CKE\cite{zhang2016collaborative}、PER\cite{yu2014personalized}、SHINE\cite{wang2018shine}、LibFM\cite{rendle2012factorization}以及Wide\&Deep\cite{cheng2016wide}算法的进行了对比。并以此发现，涟漪网络算法的性能最优。
 
 （3）基于涟漪网络算法实现了基于知识图谱的电影推荐系统。该系统为未登录用户提供按分类查看电影、查看电影详情的功能；为普通用户提供电影推荐、按分类查看电影、查看电影详情、电影评分、将电影加入心愿单以及购买电影功能；为管理员提供增加、删除、修改、查找电影及用户的功能。同时使用JSON网络令牌、HTTPS以及哈希化密码等手段保障系统的安全性。
 \section{工作展望}
diff --git a/macros/latex/contrib/bjfuthesis/example/figures/admin-knowledge-graph.png b/macros/latex/contrib/bjfuthesis/example/figures/admin-knowledge-graph.png
new file mode 100644
index 0000000000..9603818183
--- /dev/null
+++ b/macros/latex/contrib/bjfuthesis/example/figures/admin-knowledge-graph.png
diff --git a/macros/latex/contrib/bjfuthesis/example/figures/admin-movie.png b/macros/latex/contrib/bjfuthesis/example/figures/admin-movie.png
index 163ed11325..938bb9f6f1 100644
--- a/macros/latex/contrib/bjfuthesis/example/figures/admin-movie.png
+++ b/macros/latex/contrib/bjfuthesis/example/figures/admin-movie.png
diff --git a/macros/latex/contrib/bjfuthesis/example/figures/admin-navigation.png b/macros/latex/contrib/bjfuthesis/example/figures/admin-navigation.png
new file mode 100644
index 0000000000..2f03defee7
--- /dev/null
+++ b/macros/latex/contrib/bjfuthesis/example/figures/admin-navigation.png
diff --git a/macros/latex/contrib/bjfuthesis/example/figures/anonymous-category.png b/macros/latex/contrib/bjfuthesis/example/figures/anonymous-category.png
index 2e0e50c64e..0e7e85fb23 100644
--- a/macros/latex/contrib/bjfuthesis/example/figures/anonymous-category.png
+++ b/macros/latex/contrib/bjfuthesis/example/figures/anonymous-category.png
diff --git a/macros/latex/contrib/bjfuthesis/example/figures/anonymous-details.png b/macros/latex/contrib/bjfuthesis/example/figures/anonymous-details.png
index 571e9862dd..d493e7d33c 100644
--- a/macros/latex/contrib/bjfuthesis/example/figures/anonymous-details.png
+++ b/macros/latex/contrib/bjfuthesis/example/figures/anonymous-details.png
diff --git a/macros/latex/contrib/bjfuthesis/example/figures/anonymous-index.png b/macros/latex/contrib/bjfuthesis/example/figures/anonymous-index.png
index 6493ab444f..51128da916 100644
--- a/macros/latex/contrib/bjfuthesis/example/figures/anonymous-index.png
+++ b/macros/latex/contrib/bjfuthesis/example/figures/anonymous-index.png
diff --git a/macros/latex/contrib/bjfuthesis/example/figures/anonymous-search.png b/macros/latex/contrib/bjfuthesis/example/figures/anonymous-search.png
new file mode 100644
index 0000000000..003d373cc9
--- /dev/null
+++ b/macros/latex/contrib/bjfuthesis/example/figures/anonymous-search.png
diff --git a/macros/latex/contrib/bjfuthesis/example/figures/general-details.png b/macros/latex/contrib/bjfuthesis/example/figures/general-details.png
index d8d33408b5..e462e58ebb 100644
--- a/macros/latex/contrib/bjfuthesis/example/figures/general-details.png
+++ b/macros/latex/contrib/bjfuthesis/example/figures/general-details.png
diff --git a/macros/latex/contrib/bjfuthesis/example/figures/illustration-of-ripple-sets.png b/macros/latex/contrib/bjfuthesis/example/figures/illustration-of-ripple-sets.png
index 96e2920c7f..ffb64c807d 100644
--- a/macros/latex/contrib/bjfuthesis/example/figures/illustration-of-ripple-sets.png
+++ b/macros/latex/contrib/bjfuthesis/example/figures/illustration-of-ripple-sets.png
diff --git a/macros/latex/contrib/bjfuthesis/example/figures/jwt.pdf b/macros/latex/contrib/bjfuthesis/example/figures/jwt.pdf
index b6fe019966..ceb362d3c5 100644
--- a/macros/latex/contrib/bjfuthesis/example/figures/jwt.pdf
+++ b/macros/latex/contrib/bjfuthesis/example/figures/jwt.pdf
diff --git a/macros/latex/contrib/bjfuthesis/example/figures/recommendation-procedure.pdf b/macros/latex/contrib/bjfuthesis/example/figures/recommendation-procedure.pdf
index 049f4c623d..1df4d75019 100644
--- a/macros/latex/contrib/bjfuthesis/example/figures/recommendation-procedure.pdf
+++ b/macros/latex/contrib/bjfuthesis/example/figures/recommendation-procedure.pdf
diff --git a/macros/latex/contrib/bjfuthesis/example/figures/sign-up.png b/macros/latex/contrib/bjfuthesis/example/figures/sign-up.png
deleted file mode 100644
index 2c0f6ed59d..0000000000
--- a/macros/latex/contrib/bjfuthesis/example/figures/sign-up.png
+++ /dev/null
diff --git a/macros/latex/contrib/bjfuthesis/example/figures/use-case.pdf b/macros/latex/contrib/bjfuthesis/example/figures/use-case.pdf
index 751a799f6f..9be18e52cb 100644
--- a/macros/latex/contrib/bjfuthesis/example/figures/use-case.pdf
+++ b/macros/latex/contrib/bjfuthesis/example/figures/use-case.pdf
diff --git a/macros/latex/contrib/bjfuthesis/example/thesis.pdf b/macros/latex/contrib/bjfuthesis/example/thesis.pdf
index 24e4dacf68..af8b072dc1 100644
--- a/macros/latex/contrib/bjfuthesis/example/thesis.pdf
+++ b/macros/latex/contrib/bjfuthesis/example/thesis.pdf
diff --git a/macros/latex/contrib/derivative/README.md b/macros/latex/contrib/derivative/README.md
index 72d73433ed..9b8aec07fe 100644
--- a/macros/latex/contrib/derivative/README.md
+++ b/macros/latex/contrib/derivative/README.md
@@ -1,4 +1,4 @@
-## README for derivative package v1.01 dated 2021-05-28
+## README for derivative package v1.1 dated 2021-06-03
 
 The package provides a set of commands `\NewDerivative`, `\NewDifferential` etc. that can be used to define a derivative or a differential operator, respectively. The package have already defined several derivatives and differentials:
 
diff --git a/macros/latex/contrib/derivative/derivative.pdf b/macros/latex/contrib/derivative/derivative.pdf
index c18c477ca4..606ae17783 100644
--- a/macros/latex/contrib/derivative/derivative.pdf
+++ b/macros/latex/contrib/derivative/derivative.pdf
diff --git a/macros/latex/contrib/derivative/derivative.sty b/macros/latex/contrib/derivative/derivative.sty
index 13eac36065..a26080b431 100644
--- a/macros/latex/contrib/derivative/derivative.sty
+++ b/macros/latex/contrib/derivative/derivative.sty
@@ -15,11 +15,58 @@
 
 \NeedsTeXFormat{LaTeX2e}
 
-\RequirePackage{xparse}[2018/05/09]
-\ProvidesExplPackage{derivative}{2021/05/28}{1.01}{Nice and easy derivatives and differentials for LaTeX}
+\RequirePackage{expl3,xparse}[2018/05/09]
+\RequirePackage{l3keys2e}
+\ProvidesExplPackage{derivative}{2021/06/03}{1.1}{Nice and easy derivatives and differentials for LaTeX}
+
+\bool_new:N \l__deriv_pkg_italic_bool
+\bool_new:N \l__deriv_pkg_upright_bool
+
+\keys_define:nn { deriv/pkg }
+{
+	italic .choice:,
+	italic .default:n = { true },
+	italic / true .code:n = 
+		{
+			\bool_set_true:N  \l__deriv_pkg_italic_bool
+			\bool_set_false:N \l__deriv_pkg_upright_bool
+		},
+	italic / false .code:n =
+		{
+			\bool_set_false:N \l__deriv_pkg_italic_bool
+			\bool_set_true:N  \l__deriv_pkg_upright_bool
+		},
+	italic / unknown .code:n =
+		{ \msg_error:nnx { deriv } { boolean-values-only } \l_keys_key_str },
+
+	upright .choice:,
+	upright .default:n = { true },
+	upright / true .code:n = 
+		{
+			\bool_set_true:N  \l__deriv_pkg_upright_bool
+			\bool_set_false:N \l__deriv_pkg_italic_bool
+		},
+	upright / false .code:n =
+		{
+			\bool_set_false:N \l__deriv_pkg_upright_bool
+			\bool_set_true:N  \l__deriv_pkg_italic_bool
+		},
+	upright / unknown .code:n =
+		{ \msg_error:nnx { deriv } { boolean-values-only } \l_keys_key_str },
+	upright .initial:n = true,
+}
+
+\ProcessKeysPackageOptions{ deriv/pkg }
 
 %%%%%  Useful conditionals  %%%%%
 
+\prg_new_conditional:Npnn \__deriv_if_pkg:n #1 { p, TF }
+{
+	\@ifpackageloaded{unicode-math}
+	{ \prg_return_true:  }
+	{ \prg_return_false: }
+}
+
 \prg_new_conditional:Npnn \__deriv_if_novalue:n #1 { T , F , TF }
 {
 	\tl_if_novalue:nTF {#1}
@@ -86,7 +133,7 @@
 \seq_new:N \l__deriv_tmp_keys_seq
 \tl_new:N \l__deriv_tmp_keys_tl
 
-%%%%%  Variables: infinisimal  %%%%%
+%%%%%  Variables: differential  %%%%%
 
 \seq_new:N \l__deriv_i_var_seq
 \seq_new:N \l__deriv_i_orders_seq
@@ -213,6 +260,7 @@
 
 %%%%%%  Key-val for all  %%%%%%
 
+\prop_new:N \l__deriv_all_all_user_keys_prop
 \prop_const_from_keyval:Nn \c__deriv_all_pkg_keys_prop
 { scale-auto = leftright }
 
@@ -228,8 +276,7 @@
 	{
 		\cs_set_nopar:Npn \__deriv_auto_left:n  { \mleft  }
 		\cs_set_nopar:Npn \__deriv_auto_right:n { \mright }
-	},
-	scale-auto .default:n = { leftright }
+	}
 }
 
 %%%%%%  Key-val: derivatives  %%%%%%
@@ -275,8 +322,6 @@
 		fun  .bool_set:c = { l__deriv_dv_#1_misc_fun_bool },
 		frac .bool_set:c = { l__deriv_dv_#1_misc_frac_bool },
 		var  .clist_set:c = { l__deriv_dv_#1_misc_var_clist },
-		%fun  .default:n = {true},
-		%frac .default:n = {true},
 		var  .default:n = {all},
 		
 		order .clist_set:c = { l__deriv_dv_#1_misc_order_clist },
@@ -1271,7 +1316,7 @@
 		\deriv_dv_define:NVn \RenewDocumentCommand \l__deriv_cs_name_tl {#1}
 	}
 	{
-		\msg_error:nnxx { deriv } { command-already-defined }
+		\msg_error:nnxx { deriv } { command-not-defined }
 		{ \token_to_str:N #1               }
 		{ \token_to_str:N \RenewDerivative }
 	}
@@ -1415,40 +1460,56 @@
 
 \msg_new:nnnn { deriv } { command-not-defined }
 { Command~'#1'~not~yet~defined! }
-{ You~have~used~#2~with~a~derivative~that~was~never~defined. }
+{ You~have~used~#2~with~a~command~that~was~never~defined. }
+
+\msg_new:nnnn { deriv } { boolean-values-only }
+{ The~key~'#1'~accepts~boolean~values~only. }
+{ The~key~'#1'~only~accepts~the~values~'true'~and~'false'. }
+
+\msg_new:nnnn { deriv } { derivative-option-not-defined }
+{ Derivative option~'#1'~not~yet~defined! }
+{ You~have~used~#2~with~a~derivative~option~that~was~never~defined. }
+
+\msg_new:nnnn { deriv } { differential-option-not-defined }
+{ Differential option~'#1'~not~yet~defined! }
+{ You~have~used~#2~with~a~differential~option~that~was~never~defined. }
 
 %%%%%  Declaring derivatives  %%%%%
 
-\derivset{all}
-\bool_lazy_or:nnTF { \sys_if_engine_luatex_p: } { \sys_if_engine_xetex_p: }
+\@ifpackageloaded{mleftright}
+{ \derivset{all}[scale-auto = mleftmright] }
+{ \derivset{all}[scale-auto = leftright]   }
+
+\cs_new_protected:Npn \deriv_define_legacy_italic_cs:
 {
-	\DeclareDerivative{\odv}{\symup{d}}
-	\DeclareDerivative{\mdv}{\symup{D}}
-	\DeclareDerivative{\fdv}{\delta}
-	\DeclareDerivative{\adv}{\Delta}
-	\DeclareDerivative{\jdv}{\partial}[fun=true, var=1]
-	\DeclareDerivative{\pdv}{\partial}[style-var=multiple, sep-inf-ord=1, delims-eval=(), delims-eval-/=()]
-	
-	\DeclareDifferential{\odif}{\symup{d}}
-	\DeclareDifferential{\mdif}{\symup{D}}[style-notation=single, style-notation-*=mixed]
-	\DeclareDifferential{\fdif}{\delta}
-	\DeclareDifferential{\adif}{\Delta}
-	\DeclareDifferential{\pdif}{\partial}[style-notation=single, style-notation-*=mixed]
+	\DeclareDerivative{\odv}{\mathnormal{d}}
+	\DeclareDerivative{\mdv}{\mathnormal{D}}
+	\DeclareDifferential{\odif}{\mathnormal{d}}
+	\DeclareDifferential{\mdif}{\mathnormal{D}}[style-notation=single, style-notation-*=mixed]
 }
+
+\cs_new_protected:Npn \deriv_define_legacy_upright_cs:
 {
 	\DeclareDerivative{\odv}{\mathrm{d}}
 	\DeclareDerivative{\mdv}{\mathrm{D}}
-	\DeclareDerivative{\fdv}{\delta}
-	\DeclareDerivative{\adv}{\Delta}
-	\DeclareDerivative{\jdv}{\partial}[fun=true, var=1]
-	\DeclareDerivative{\pdv}{\partial}[style-var=multiple, sep-inf-ord=1, delims-eval=(), delims-eval-/=()]
-	
 	\DeclareDifferential{\odif}{\mathrm{d}}
 	\DeclareDifferential{\mdif}{\mathrm{D}}[style-notation=single, style-notation-*=mixed]
-	\DeclareDifferential{\fdif}{\delta}
-	\DeclareDifferential{\adif}{\Delta}
-	\DeclareDifferential{\pdif}{\partial}[style-notation=single, style-notation-*=mixed]
 }
 
+\__deriv_case:n
+{
+	{ \l__deriv_pkg_italic_bool  } { \deriv_define_legacy_italic_cs:  }
+	{ \l__deriv_pkg_upright_bool } { \deriv_define_legacy_upright_cs: }
+}
+
+\DeclareDerivative{\fdv}{\delta}
+\DeclareDerivative{\adv}{\Delta}
+\DeclareDerivative{\jdv}{\partial}[fun=true, var=1]
+\DeclareDerivative{\pdv}{\partial}[style-var=multiple, sep-inf-ord=1, delims-eval=(), delims-eval-/=()]
+
+\DeclareDifferential{\fdif}{\delta}
+\DeclareDifferential{\adif}{\Delta}
+\DeclareDifferential{\pdif}{\partial}[style-notation=single, style-notation-*=mixed]
+
 \endinput
 
diff --git a/macros/latex/contrib/derivative/derivative.tex b/macros/latex/contrib/derivative/derivative.tex
index 840b868396..d7c50df7b8 100644
--- a/macros/latex/contrib/derivative/derivative.tex
+++ b/macros/latex/contrib/derivative/derivative.tex
@@ -38,6 +38,7 @@ indent_length "2"
 \documentclass[final,british,10pt]{scrartcl}
 	\reversemarginpar
 \RequirePackage[british]{babel}
+\RequirePackage{fontspec}
 %\RequirePackage{polyglossia}
 %	\setmainlanguage[variant=british]{english}
 \RequirePackage[style=english,english=british]{csquotes}
@@ -50,6 +51,17 @@ indent_length "2"
 	\definecolor{RoyalBlue}{RGB}{0, 35, 102}
 	\definecolor{RoyalGreen}{RGB}{32, 77, 2}
 
+%	\definecolor{RoyalGray}{RGB}{75, 75, 75}
+%	\definecolor{RoyalDarkGray}{RGB}{225, 225, 225}
+%	\definecolor{RoyalLightGray}{RGB}{30, 30, 30}
+%	\definecolor{RoyalRed}{RGB}{255, 177, 151} % 207, 102, 121
+%	\definecolor{RoyalBlue}{RGB}{187, 134, 252} % 55, 185, 255
+%	\definecolor{RoyalGreen}{RGB}{3, 218, 198} % 52, 177, 20
+%	\definecolor{RoyalPageCoulor}{RGB}{18, 18, 18} % 30, 30, 30
+%	\definecolor{RoyalTextCoulor}{RGB}{225, 225, 225}
+%	\pagecolor{RoyalPageCoulor}
+%	\color{RoyalTextCoulor}
+
 \RequirePackage{amsmath, amsthm}
 	\allowdisplaybreaks
 	\theoremstyle{remark}
@@ -383,6 +395,7 @@ indent_length "2"
 {
 }
 
+
 \tl_new:N \l__mydoc_number_tl
 \tl_new:N \l_mydoc_index_item_tl
 \tl_new:N \l_mydoc_index_subitem_tl
@@ -1305,17 +1318,16 @@ indent_length "2"
 {  \mydoc_cs_to_str:N #1 }
 
 \ExplSyntaxOff
-\makeatother
 
 \Pakkenavn{derivative}
 \Titel{The \pakkenavn{} package}
 \Forfatter{Simon Jensen}
 \Email{sjelatex@gmail.com}
-\Dato{2021/05/28}
-\Version{1.01}
+\Dato{2021/06/03}
+\Version{1.1}
 
-\RequirePackage{derivative}[\dato]
-	\derivset{all}[scale-auto = mleftmright]
+\RequirePackage[upright]{derivative}[\dato]
+%	\derivset{all}[scale-auto = mleftmright]
 
 \hypersetup
 {
@@ -1349,8 +1361,7 @@ indent_length "2"
 \begin{document}
 	
 	\forside{%
-	The \mypackage{} package provides a set of commands which makes writing ordinary and partial derivatives of arbitrary order in a straight forward manner. Additionally, this package provides a set of commands to define variants of the aforementioned derivatives. A set of optional arguments along with lots of package options allow for easy and great flexibility over the derivative's format, such as where the function is positioned, point of evaluation, and switching between fraction styles. Moreover, the mixed order of the partial derivative and variants hereof is automatically computed. This package is written in the \pkg{expl3} language and requires therefore the \LaTeX3 package bundles \pkg{l3kernel} and \pkg{l3package}. Additionally, the \pkg{mleftright} package is optional and provides the improved automatically scaling \cs{mleft} and \cs{mright}.%
-	}
+	The \mypackage{} package provides a set of commands which makes writing ordinary and partial derivatives of arbitrary order in a straight forward manner. Additionally, this package provides a set of commands to define variants of the aforementioned derivatives. A set of optional arguments along with lots of package options allow for easy and great flexibility over the derivative's format, such as where the function is positioned, point of evaluation, and switching between fraction styles. Moreover, the mixed order of the partial derivative and variants hereof is automatically computed. This package is written in the \pkg{expl3} language and requires therefore the \LaTeX3 package bundles \pkg{l3kernel} and \pkg{l3package}. Additionally, the \pkg{mleftright} package is optional and provides the improved automatically scaling \cs{mleft} and \cs{mright}.}
 	
 	\clearpage
 	\tableofcontents
@@ -1372,7 +1383,7 @@ indent_length "2"
 		The partial derivative \macro{1} is defined with a set of mandatory and optional arguments that either typeset specific parts or changing the style of the derivative. In this package, the partial derivative is defined with an italic partial differential $\partial$ as
 		
 		\begin{definition}
-			\DeclareDerivative{\pdv}{\partial}[style-var=multiple, sep-inf-ord=1,%\marginnote{\pdftex, \xetex, \luatex}%
+			\DeclareDerivative{\pdv}{\partial}[style-var=multiple, sep-inf-ord=1,
 			delims-eval=(), delims-eval-/=()]
 		\end{definition}
 		
@@ -1453,15 +1464,14 @@ indent_length "2"
 	\subsection{Other derivatives}
 	This package offers five other derivatives: Ordinary derivative \macro{\odv}, material derivative \macro{\mdv}, functional derivative \macro{\fdv}, the average rate of change \macro{\adv} and the Jacobian \macro{\jdv}. A unique feature of this package, is that you can define your own derivatives as described in \cref{ssec:defvar_dv}.
 	
-	\begin{function}{\odv}
+	\begin{function}{\odv}[updated=v1.1]
 		\begin{syntax}
 			\sarg, \oarg{keyval list}, \marg{function}, \targ{/}, \marg{variables}, \earg{\_, point\tsb{1}, \^, point\tsb{2}}
 		\end{syntax}
-		In this package, the ordinary derivative is defined with an upright lowercase d as
-		
+		In this package, the ordinary derivative is defined with an upright lowercase d if the package option \keyval{upright}{true} is used else it will use an italic lowercase d
 		\begin{definition}
-			\DeclareDerivative{\odv}{\mathrm{d}}%\marginnote{\pdftex}%
-			\DeclareDerivative{\odv}{\symup{d}}%\marginnote{\xetex, \luatex}%
+			\DeclareDerivative{\odv}{\mathrm{d}}%\marginnote{\keyval{upright}{true}}%
+			\DeclareDerivative{\odv}{\mathnormal{d}}%\marginnote{\keyval{italic}{true}}%
 		\end{definition}
 		because it is used by many nowadays books
 		\begin{equation*}
@@ -1470,15 +1480,15 @@ indent_length "2"
 		However it can always be changed with the \key{style-inf} key. 
 	\end{function}
 	
-	\begin{function}{\mdv}
+	\begin{function}{\mdv}[updated=v1.1]
 		\begin{syntax}
 			\sarg, \oarg{keyval list}, \marg{function}, \targ{/}, \marg{variables}, \earg{\_, point\tsb{1}, \^, point\tsb{2}}
 		\end{syntax}
-		The material derivative is used in some branches of physics e.g. thermodynamic, fluid dynamic etc. It is only natural for a physics student as me to define such a variant, that used an upright uppercase D. In this package, the material derivative is defined as
+		The material derivative is used in some branches of physics e.g. thermodynamic, fluid dynamic etc. It comes with an upright uppercase D when the package option \keyval{upright}{true} else it will use an italic uppercase D. In this package, the material derivative is defined as
 		
 		\begin{definition}
-			\DeclareDerivative{\mdv}{\mathrm{D}}%\marginnote{\pdftex}%
-			\DeclareDerivative{\mdv}{\symup{D}}%\marginnote{\xetex, \luatex}%
+			\DeclareDerivative{\mdv}{\mathrm{D}}%\marginnote{\keyval{upright}{true}}%
+			\DeclareDerivative{\mdv}{\mathnormal{D}}%\marginnote{\keyval{italic}{true}}%
 		\end{definition}
 		
 		\noindent In physics, the material derivative is defined by
@@ -1494,7 +1504,7 @@ indent_length "2"
 		The functional derivative is used in the calculus of variation and uses a lowercase delta. With the package's default settings, it will use an italic delta. In this package, the functional derivative is defined as
 		
 		\begin{definition}
-			\DeclareDerivative{\fdv}{\delta}%\marginnote{\pdftex, \xetex, \luatex}%
+			\DeclareDerivative{\fdv}{\delta}
 		\end{definition}
 		
 		\noindent In physics, it is for example used in the Lagrange equation or in the derivation of the Hartree-Fock equation
@@ -1512,7 +1522,7 @@ indent_length "2"
 		The average rate of change is defined to use an upright uppercase delta with the packages default settings. In this package, the average rate of change is defined as
 		
 		\begin{definition}
-			\DeclareDerivative{\adv}{\Delta}%\marginnote{\pdftex, \xetex, \luatex}%
+			\DeclareDerivative{\adv}{\Delta}
 		\end{definition}
 		
 		\noindent The average rate of change is used to determine the slope of a straight line
@@ -1528,7 +1538,7 @@ indent_length "2"
 		The Jacobian is defined to use an italic partial differential with the package's default settings. Also a pair of parentheses is automatically inserted around the function and variable. In this package, the Jacobian is defined as
 		
 		\begin{definition}
-			\DeclareDerivative{\jdv}{\partial}[fun=true, var=1]%\marginnote{\pdftex, \xetex, \luatex}%
+			\DeclareDerivative{\jdv}{\partial}[fun=true, var=1]
 		\end{definition}
 		
 		\noindent which gives
@@ -1542,15 +1552,15 @@ indent_length "2"
 	\clearpage
 	\section{Differentials}
 	
-	\begin{function}*{\odif}[new = v1.0]
+	\begin{function}*{\odif}[new = v1.0, updated=v1.1]
 		\begin{syntax}
 			\sarg, \oarg{keyval list}, \marg{variables}
 		\end{syntax}
-		The differential \macro{1} using an lowercase d is defined with a set of mandatory and optional arguments that either typeset specific parts or changing the style of the differential. It is defined as
+		The differential \macro{1} is defined with a set of mandatory and optional arguments that either typeset specific parts or changing the style of the differential. It is defined with an upright lowercase d when \keyval{upright}{true} else it will be defined with an italic lowercase d
 		
 		\begin{definition}
-			\DeclareDifferential{\odif}{\mathrm{d}}%\marginnote{\pdftex}%
-			\DeclareDifferential{\odif}{\symup{d}}%\marginnote{\xetex, \luatex}%
+			\DeclareDifferential{\odif}{\mathrm{d}}%\marginnote{\keyval{upright}{true}}%
+			\DeclareDifferential{\odif}{\mathnormal{d}}%\marginnote{\keyval{italic}{true}}%
 		\end{definition}
 		
 		\begin{argument}*{1}
@@ -1597,7 +1607,7 @@ indent_length "2"
 		
 		\begin{definition}
 			\DeclareDifferential{\pdif}{\partial}[style-notation=single,
-			style-notation-*=mixed]%\marginnote{\pdftex, \xetex, \luatex}%
+			style-notation-*=mixed]
 		\end{definition}
 		
 		\noindent The non-star and star version gives
@@ -1608,17 +1618,17 @@ indent_length "2"
 		respectively.
 	\end{function}
 	
-	\begin{function}{\mdif}
+	\begin{function}{\mdif}[updated=v1.1]
 		\begin{syntax}
 			\sarg, \oarg{keyval list}, \marg{variables}
 		\end{syntax}
-		Another commonly used shorthand notation for various derivatives is the differential with a uppercase D. In this package it is defined with a upright D as
+		Another commonly used shorthand notation for various derivatives is the differential with an uppercase D. In this package it is defined with a upright D when \keyval{upright}{true} else it is defined with an italic uppercase D
 		
 		\begin{definition}
 			\DeclareDifferential{\mdif}{\mathrm{D}}[style-notation=single,
-			style-notation-*=mixed]%\marginnote{\pdftex}%
-			\DeclareDifferential{\mdif}{\symup{D}}[style-notation=single,
-			style-notation-*=mixed]%\marginnote{\xetex, \luatex}%
+			style-notation-*=mixed]%\marginnote{\keyval{upright}{true}}%
+			\DeclareDifferential{\mdif}{\mathnormal{D}}[style-notation=single,
+			style-notation-*=mixed%\marginnote{\keyval{italic}{true}}%
 		\end{definition}
 		
 		\noindent The non-star and star version gives
@@ -1636,7 +1646,7 @@ indent_length "2"
 		When working with functional derivatives another differential is frequently encountered. This differential uses a delta symbol and is defined as
 		
 		\begin{definition}
-			\DeclareDifferential{\fdif}{\delta}%\marginnote{\pdftex, \xetex, \luatex}%
+			\DeclareDifferential{\fdif}{\delta}
 		\end{definition}
 		
 		\noindent For example an expression like
@@ -1653,7 +1663,7 @@ indent_length "2"
 		To wrap it up, a differential for differences is defined as
 		
 		\begin{definition}
-			\DeclareDifferential{\adif}{\Delta}%\marginnote{\pdftex, \xetex, \luatex}%
+			\DeclareDifferential{\adif}{\Delta}
 		\end{definition}
 		
 		\noindent For example
@@ -1663,8 +1673,9 @@ indent_length "2"
 	\end{function}
 	
 	\clearpage
-	\section{Package options}
-	This package accepts its options using the well-known \emph{key=value} syntax. The keys are divided into categories, for which each key have its associated category as a prefix. %Each category and option is explained below. 
+	\section{Options}
+	
+	This package accepts its options using the well-known \emph{key=value} syntax. The keys are divided into categories, for which each key have its associated category as a prefix.
 	
 	\begin{function}{\derivset}[updated = v1.0]
 		\begin{syntax}
@@ -1673,11 +1684,11 @@ indent_length "2"
 		The \macro{1} is meant to set the default values for derivatives and differentials options in the preamble. It can be used in the document but this is what the new \oarg{keyval list} arguments are for in the derivative and differential commands.
 		
 		\begin{argument}{1}
-			A mandatory argument that determines which command the \emph{key=value} pairs is assigned to, where the allowed \meta{commands} are the derivatives and differentials defined by the package and you, see \cref{ssec:defvar_dv,ssec:defvar_inf} for more information. The special value \texttt{all} is also allowed, which gives access to the options that applies to \textit{all} derivatives and differentials.
+			A mandatory argument that determines which command the \emph{key=value} pairs are assigned to, where the allowed \meta{commands} are the derivatives and differentials defined by the package and you, see \cref{ssec:defvar_dv,ssec:defvar_inf} for more information. The special value \texttt{all} is also allowed, which gives access to the options that applies to \textit{all} derivatives and differentials.
 		\end{argument}
 		
 		\begin{argument}{2}
-			This optional argument accepts its input as a comma-separated list of \emph{key=value} pairs. Leaving out \arg{2} sets the options to the package's default settings for the chosen \arg{1}. E.g. \macro{\derivset}[\narg{\macro{\odv}}] sets the options for the ordinary derivative to the packages default settings. %This argument is subject to change, see \cref{consid:DerivsetOptional} for more information.
+			This optional argument accepts its input as a comma-separated list of \emph{key=value} pairs. Leaving out \arg{2} sets the options to the package's default settings for the chosen \arg{1}. E.g. \macro{\derivset}[\narg{\macro{\odv}}] sets the options for the ordinary derivative to the packages default settings.
 		\end{argument}
 	\end{function}
 	
@@ -1695,9 +1706,30 @@ indent_length "2"
 	\end{itemize}
 	
 	\begin{note}
-		A value with superscripted \texttt{U}, \texttt{P} and \texttt{R} refers to a unicode engine i.e. \luatex{} and \xetex, \pdftex{} and requires package, respectively. Additionally, some keys have two versions; with and without \texttt{-/} at the end. These keys are related to the slash argument. If \keyval{switch-/}{false} then the keys with and without \texttt{-/} are used when the slash argument is present and absent, respectively. Setting \keyval{switch-/}{true} then these keys are used in the opposite cases of the slash argument's presence.
+		A value with superscripted \texttt{R} means it requires a package. Additionally, some keys have two versions; with and without \texttt{-/} at the end. These keys are related to the slash argument. If \keyval{switch-/}{false} then the keys with and without \texttt{-/} are used when the slash argument is present and absent, respectively. Setting \keyval{switch-/}{true} then these keys are used in the opposite cases of the slash argument's presence.
 	\end{note}
 	
+	\subsection{Package options}
+	The package options can be used with
+	\begin{center}
+		\ttfamily\small
+		\cs{usepackage}\oarg{keyval list}\narg{derivative}
+	\end{center}
+	
+	\begin{option}*{italic}[new = v1.1]
+		\begin{values}[default = false]
+			true, false
+		\end{values}
+		Sets the font-style of the infinitesimals $d$ and $D$ used in \cs{odv}, \cs{mdv}, \cs{odif} and \cs{mdif} to italic using \cs{mathnormal}. The options \key{italic} and \key{upright} are mutually exclusive.
+	\end{option}
+	
+	\begin{option}{upright}[new = v1.1]
+		\begin{values}[default = true]
+			true, false
+		\end{values}
+		Sets the font-style of the infinitesimals $d$ and $D$ used in \cs{odv}, \cs{mdv}, \cs{odif} and \cs{mdif} to upright using \cs{mathrm}. The options \key{italic} and \key{upright} are mutually exclusive.
+	\end{option}
+	
 	\subsection{Derivative options} \label{ssec:options_dv}
 	The options in this subsection are available for derivatives defined by the package and you with the commands in \cref{ssec:defvar_dv}.
 	
@@ -1707,8 +1739,7 @@ indent_length "2"
 		\begin{values}[default = d]
 			\meta{math-font-style}\meta{infinitesimal}
 		\end{values}
-		Sets the derivative's infinitesimal including font style. This change was necessary to allow multiple font styles, e.g. \keyval{style-inf}{\cs{mathbf}\{\cs{mathrm}\{d\}\}}.
-		The default font style is \default. If an upright font is preferred then \cs{mathrm}\pdf{} and \cs{symup}\uni{} could be used, or if an italic font then \cs{mathnormal}\pdf{} and \cs{symit}\uni.
+		Sets the derivative's infinitesimal including font style. This change was necessary to allow multiple font styles, e.g. \keyval{style-inf}{\cs{mathbf}\narg{\cs{mathrm}\narg{d}}}. The default infinitesimal is a plain `\default` with no associated font style.
 	\end{option}
 	
 	\begin{option}{style-frac}
@@ -1725,6 +1756,8 @@ indent_length "2"
 		The derivative uses the fraction set by this key whenever \keyval{switch-/}{false} and the slash argument is present. The key's default value is a text-styled fraction \default\footref{foot:sfrac} i.e. on the form $\pdv[style-frac-/=\slashfrac, switch-/=false]{f}/{x,y}$.
 	\end{option}
 	
+	\clearpage
+	
 	\begin{option}{style-var}[new = v1.0]
 		\begin{values}[default = single]
 			single, multiple
@@ -1732,8 +1765,6 @@ indent_length "2"
 		This option determines how the derivative treats its variables and some features. The variable argument is treated as a single variable when \val{single} is used. Moreover the mixed order is set equal to the first order given in \keyval[cat=misc]{order}{\meta{order}} which by default is \val{1}. The variable argument is treated as a comma separated list of variables with \val{multiple} similarly to a partial derivative. Moreover the mixed order is automatically calculated from the list of orders given in \keyval[cat=misc]{order}{\meta{order}}.
 	\end{option}
 	
-	\clearpage
-	
 	\subsubsection*{Scaling}
 	
 	\begin{option}*{scale-eval}
@@ -1787,6 +1818,8 @@ indent_length "2"
 		This key sets the left and right delimiters used to indicate the point of evaluation. These delimiters are inserted whenever \keyval{switch-/}{false} and the slash argument is absent. The key's default left and right delimiters are a left and a right parenthesis, respectively.
 	\end{option}
 	
+	\clearpage
+	
 	\begin{option}{delims-eval-/}
 		\begin{values}[default = .~\cs{rvert}]
 			\meta{left delimiter}\meta{right delimiter}
@@ -1801,8 +1834,6 @@ indent_length "2"
 		This key sets the left and right delimiters used around the function and these are inserted whenever \keyval[cat=misc]{fun}{true} is used. The key's default left and right delimiters are a left and a right parenthesis, respectively.
 	\end{option}
 	
-	\clearpage
-	
 	\begin{option}{delims-var}
 		\begin{values}[default = (~)]
 			\meta{left delimiter}\meta{right delimiter}
@@ -1848,6 +1879,8 @@ indent_length "2"
 	\end{equation*}
 	where the Jacobian have been used as an example.
 	
+	\clearpage
+	
 	\begin{option}{sep-inf-ord}
 		\begin{values}[default = 0]
 			\meta{cs-number}, \marg{mspace}, \marg{delimiter}
@@ -1862,8 +1895,6 @@ indent_length "2"
 		This key sets the math space that is inserted between the infinitesimal and the function when the mixed order \emph{is equal} to \num{1}. The space is only inserted when a non-blank function is printed \emph{in the numerator}. The key's default value is \default{} \texttt{mu}.
 	\end{option}
 	
-	\clearpage
-	
 	\begin{option}{sep-ord-fun}
 		\begin{values}[default = 0]
 			\meta{cs-number}, \marg{mspace}, \marg{delimiter}
@@ -1896,14 +1927,14 @@ indent_length "2"
 		\begin{values}[default = \cs{mathop}\{\}\cs{!}]
 			\meta{cs-number}, \marg{mspace}, \marg{delimiter}
 		\end{values}
-		They key sets the math space that is inserted between a variable and the following infinitesimal. The space is only inserted when the variable's order \emph{is equal} to \num{1}. It is only inserted when more than one non-blank variables are given. The key's default value is \default{}.
+		They key sets the math space that is inserted between a variable and the following infinitesimal. The space is only inserted when the variable's order \emph{is equal} to \num{1}. It is only inserted when more than one non-blank variables are given. The key's default value is \val{\default}.
 	\end{option}
 	
 	\begin{option}{sep-ord-inf}
 		\begin{values}[default = \cs{mathop}\{\}\cs{!}]
 			\meta{cs-number}, \marg{mspace}, \marg{delimiter}
 		\end{values}
-		They key sets the math space that is inserted between a variable and the following infinitesimal. The space is only inserted when the variable's order \emph{is different} from \num{1}. It is only inserted when more than one non-blank variables are given. The key's default value is \default{}.
+		They key sets the math space that is inserted between a variable and the following infinitesimal. The space is only inserted when the variable's order \emph{is different} from \num{1}. It is only inserted when more than one non-blank variables are given. The key's default value is \val{\default}.
 	\end{option}
 	
 	\begin{option}{sep-var-var}[new = v1.0]
@@ -1913,6 +1944,8 @@ indent_length "2"
 		They key sets the math space that is inserted between two variables. The space is only inserted when the \keyval{style-var}{single} is used. and when more than one non-blank variables are given. The key's default value is a comma.
 	\end{option}
 	
+	\clearpage
+	
 	\begin{option}{sep-eval-sb}
 		\begin{values}[default = 0]
 			\meta{cs-number}, \marg{mspace}, \marg{delimiter}
@@ -1927,8 +1960,6 @@ indent_length "2"
 		This key sets the math space that is inserted in the evaluation superscript left to the point of evaluation. The space is only inserted when a non-blank superscript is given. The key's default value is \default{} \texttt{mu}.
 	\end{option}
 	
-	\clearpage
-	
 	\subsubsection*{Switches}
 	
 	\begin{option}*{switch-*}
@@ -2023,8 +2054,6 @@ indent_length "2"
 		The sorting algorithm \val{symbol} sorts the terms by their symbolic length in a descending manner. If the value \val{true} is used, then the terms will sorted in an ascending manner instead. See \cref{ssec:sort-reverse} for more information.
 	\end{option}
 	
-	\clearpage
-	
 	\subsubsection*{Miscellaneous}
 	
 	\begin{option}*{fun}[cat=misc, new = v1.0]
@@ -2068,8 +2097,6 @@ indent_length "2"
 		Without setting the option to a value is equivalent to setting it to \val{all} as seen above.
 	\end{option}
 	
-	\clearpage
-	
 	\begin{option}{order, ord}[cat=misc, new = v1.0]
 		\begin{values}[default = 1]
 			\marg{cs-orders}
@@ -2096,7 +2123,7 @@ indent_length "2"
 		\begin{values}[default = d]
 			\meta{math-font-style}\meta{infinitesimal}
 		\end{values}
-		Sets the differential's infinitesimal including font style. This change was necessary to allow multiple font styles, e.g. \keyval{style-inf}{\cs{mathbf}\{\cs{mathrm}\{d\}\}}. The default font style is \default*. If an upright font is preferred then \cs{mathrm}\pdf{} and \cs{symup}\uni{} could be used, or if an italic font is preferred then \cs{mathnormal}\pdf{} and \cs{symit}\uni.
+		Sets the differential's infinitesimal including font style. This change was necessary to allow multiple font styles, e.g. \keyval{style-inf}{\cs{mathbf}\narg{\cs{mathrm}\narg{d}}}. The default infinitesimal is a plain `\default` with no associated font style.
 	\end{option}
 	
 	\begin{option}{style-notation}
@@ -2181,6 +2208,8 @@ indent_length "2"
 		This key sets the math space that is inserted in the infinitesimal's power left to the order. It is only inserted when the mixed order is different from \num{1}. The key's default value is \default{} \texttt{mu}.
 	\end{option}
 	
+	\clearpage
+	
 	\begin{option}{sep-inf-var}
 		\begin{values}[default = 0]
 			\meta{cs-number}, \marg{mspace}, \marg{delimiter}
@@ -2195,8 +2224,6 @@ indent_length "2"
 		This key sets the math space that is inserted between the infinitesimal's power and the following variable. The space is only inserted when the order \emph{is different} from \num{1} and a non-blank variable is given. The key's default value is \default{} \texttt{mu}.
 	\end{option}
 	
-	\clearpage
-	
 	\begin{option}{sep-var-inf}
 		\begin{values}[default = \cs{mathop}\{\}\cs{!}]
 			\meta{cs-number}, \marg{mspace}, \marg{delimiter}
@@ -2267,11 +2294,11 @@ indent_length "2"
 	\subsection{All derivatives and differentials} \label{ssec:both_options}
 	The options in this subsection are applied to all derivatives and differential because some options should be consisting regardless of the derivative and differential. The options are accessed using \macro{\derivset}[\narg{all},\oarg{key=value}].
 	
-	\begin{option}{scale-auto}
-		\begin{values}[default = leftright]
+	\begin{option}{scale-auto}[updated = v1.1]
+		\begin{values}[default = {leftright, mleftmright\req}]
 			leftright, mleftmright\req
 		\end{values}
-		This package uses \cs{left} and \cs{right} to automatically scale delimiters. The value \val{mleftmright} requires the \pkg{mleftright} package, which makes this package use \cs{mleft} and \cs{mright} instead.
+		Sets the dynamic scaling methods of delimiters. The value \val{leftright} sets the method to use \cs{left} and \cs{right}. The value \val{mleftmright} requires the \pkg{mleftright} package and sets the method to use \cs{mleft} and \cs{mright} instead. The default value is \val{leftright} unless \pkg{mleftright} have been loaded then it is \val{mleftmright}.
 	\end{option}
 	
 	
@@ -2574,7 +2601,7 @@ indent_length "2"
 		\end{change}
 		\smallskip
 		\begin{change}[version = 0.98, date = 2020-07-20, beta = true]
-			\item Fixed a bug concerning the subscript argument due to recent changes to the \pkg{xparse} package dated 2020-05-14 (the fix works with earlier versions of xparse as well).
+			\item Fixed a bug concerning the subscript argument due to recent changes to the \pkg{xparse} package dated 2020-05-14 (the fix works with earlier versions of \pkg{xparse} as well).
 		\end{change}
 		\begin{change}[version = 1.0, date = 2021-05-25, beta = false]
 			\item Added new options for derivatives
@@ -2587,11 +2614,11 @@ indent_length "2"
 			\item Changed \cs{derivset} to define default options
 			\item Merged the codes for ordinary and partial derivatives
 			\item Removed the mixed order argument
-			\item Removed the options `misc-add-delims` and `misc-remove-delims`
+			\item Removed the options \key[index=false]{misc-add-delims} and \key[index=false]{misc-remove-delims}
 			\item Replaced the commands in section 5 with new ones. Old ones no longer works.
 			\item Code clean-up and optimization
 			\item Fixed code errors
-			\item Fixed Documentation errors
+			\item Fixed documentation errors
 			\item Enhanced support for preventing options effecting nested derivatives/differentials
 		\end{change}
 		\begin{change}[version = 1.01, date = 2021-05-28, beta = false]
@@ -2599,6 +2626,12 @@ indent_length "2"
 			\item Fixed code errors due to changes introduced in version 1.0 to the option \key[index=false]{style-inf}
 			\item Fixed documentation errors
 		\end{change}
+		\begin{change}[version = 1.1, date = 2021-06-03, beta = false]
+			\item Added package options to be used in \cs{usepackage}\oarg{options}\narg{derivative}
+			\item No longer secretly depends on \pkg{unicode-math} when using \xetex{} or \luatex
+			\item The package no longer uses \cs{symup} which have been replaced with \cs{mathrm} for simplicity
+			\item If \pkg{mleftright} is loaded then the default value of \key[index=false]{scale-auto} is \val{mleftmright}
+		\end{change}
 	\end{changelog}
 	
 \end{document}
\ No newline at end of file
diff --git a/macros/latex/contrib/easybook/easybook.dtx b/macros/latex/contrib/easybook/easybook.dtx
index c89a99181f..7d5517c918 100644
--- a/macros/latex/contrib/easybook/easybook.dtx
+++ b/macros/latex/contrib/easybook/easybook.dtx
@@ -23,12 +23,12 @@
 %
 % \changes{v1.20}{2021/01/09}{修改和完善用户文档。}
 % \changes{v1.20}{2021/01/09}{模板更改为使用 CC-BY 许可协议。}
-% \changes{v1.25q}{2021/05/03}{取消附带的示例文件，可查看历史版本及其它来源的使用样例。}
-% \changes{v1.25q}{2021/06/02}{将模块的代码独立出来为 \pkg{easybase} 宏包，适用于 \CTeX 文档类。}
+% \changes{v1.25r}{2021/05/03}{取消附带的示例文件，可查看历史版本及其它来源的使用样例。}
+% \changes{v1.25r}{2021/06/02}{将模块的代码独立出来为 \pkg{easybase} 宏包，适用于 \CTeX 文档类。}
 %
 % \title{\sffamily easybook 文档类手册}
 % \author{瞿毅}
-% \date{2021/06/02\hskip\ccwd\relax v1.25q\thanks{\url{https://gitee.com/texl3/easybook}}}
+% \date{2021/06/03\hskip\ccwd\relax v1.25r\thanks{\url{https://gitee.com/texl3/easybook}}}
 %
 % \maketitle
 % \begin{abstract}
@@ -134,7 +134,7 @@
 % \end{syntax}
 % 传递给 \cls{ctexbook} 设置字体，最好不要使用原有的 \opt{fontset} 选项，默认情况下使用自定义字体而不开启这个选项，可根据安装的字体及电脑系统选取。\opt{noto} 与 \opt{none} 选项的相关描述见小节 \ref{subsec:font settings}，\opt{overleaf} 是一个各系统通用选项，会检测系统环境选取对应字体。
 % \changes{v1.21}{2021/01/12}{默认字体与 \CTeX 一致，不再是自定义字体。}
-% \changes{v1.25q}{2021/05/04}{修复使用 \pkg{xeCJK} 与 \pkg{fontspec} 宏包的字体设置命令在 \hologo{LuaLaTeX} 下失效的问题。}
+% \changes{v1.25r}{2021/05/04}{修复使用 \pkg{xeCJK} 与 \pkg{fontspec} 宏包的字体设置命令在 \hologo{LuaLaTeX} 下失效的问题。}
 % \end{function}
 %
 % \begin{function}[rEXP,added = 2021-01-05,updated = 2021-01-13]{paper}
@@ -176,15 +176,15 @@
 % \end{function}
 %
 % \subsubsection{目录命令}
-% \begin{function}[added = 2021-02-20,updated = 2021-06-02]{\tableofcontents,\listoffigures,\listoftables,\listoflistings}
+% \begin{function}[added = 2021-02-20,updated = 2021-06-03]{\tableofcontents,\listoffigures,\listoftables,\listoflstlistings}
 % \begin{syntax}
 %   \tn{tableofcontents+}\oarg{键值列表}\parg{附加代码}
 %   \tn{listoffigures*+}\oarg{键值列表}
 %   \tn{listoftables*+}\oarg{键值列表}
-%   \tn{listoflistings*+}\oarg{键值列表}
+%   \tn{listoflstlistings*+}\oarg{键值列表}
 % \end{syntax}
-% \tn{listoffigures} 命令输出图片目录，\tn{listoftables} 输出表格目录，\tn{listoflistings} 输出代码目录。带有星号的目录命令不将标题添加进主文档目录，带有+号的目录命令可以使当前标题编号。\tn{tableofcontents+} 与其它命令不同是用于输出双语目录，需要与双语目录标题命令 \tn{bichapter} 等或设置图片、表格和代码等英文目录的标题配合使用，附加代码是中文与英文目录之间的代码，可以插入文本和换页命令等。目录的键值列表选项如下
-% \changes{v1.25q}{2021/05/05}{命令 \tn{tableofcontents} 可以输出双语目录。}
+% \tn{listoffigures} 命令输出图片目录，\tn{listoftables} 输出表格目录，\tn{listoflstlistings} 输出代码目录。带有星号的目录命令不将标题添加进主文档目录，带有+号的目录命令可以使当前标题编号。\tn{tableofcontents+} 与其它命令不同是用于输出双语目录，需要与双语目录标题命令 \tn{bichapter} 等或设置图片、表格和代码等英文目录的标题配合使用，附加代码是中文与英文目录之间的代码，可以插入文本和换页命令等。目录的键值列表选项如下
+% \changes{v1.25r}{2021/05/05}{命令 \tn{tableofcontents} 可以输出双语目录。}
 % \end{function}
 %
 % \begin{function}{multoc,columns,title,format,aftertitle,pagestyle,book,article}
@@ -201,7 +201,7 @@
 % 在书籍模式且 \opt{book} 选项开启或者文章模式的情况下，\opt{format} 用于设置目录标题的格式，\opt{aftertitle} 选项的代码将被插入到目录标题内容之后，\opt{pagestyle} 是目录标题所在页的页面格式，除此之外还支持 \opt{ctexset/chapter} 或 \opt{ctexset/section} 所有的章节标题样式选项。\opt{book} 选项使目录标题按照 chapter 级别输出，\opt{article} 选项使目录标题按照 section 级别输出，默认为 chapter 级别。
 % \changes{v1.23}{2021/03/15}{为几个目录增加键值列表的选项，可设置标题输出级别以及是否加入主目录。}
 % \changes{v1.24}{2021/04/04}{目录命令的可选参数增加标题键值。}
-% \changes{v1.25q}{2021/06/02}{目录可设置多栏，并在 article 模式仍然生效。}
+% \changes{v1.25r}{2021/06/02}{目录可设置多栏，并在 article 模式仍然生效。}
 % \end{function}
 %
 % \subsubsection{标题命令}
@@ -217,7 +217,7 @@
 % 双语目录的标题命令目前设置了常用的三个级别，它们将中文标题正常输出，并使中英文标题加入双语目录，这个功能是为国内一些大学的学位论文模板的要求设计，在一般情况和英文模式下不需要使用。
 %
 % 它们的星号变体命令使文中标题不编号，但是仍然加入双语目录，若英文标题参数空置那么仅加入中文目录而不加入英文目录，这一特点与 \tn{chapter*} 等命令的行为不太一样，在一些情况下会用到。可选参数是目录中的中文标题，默认与中文标题一致，正文标题过长时可用它设置在目录中显示的标题。双语目录的格式是一致的，共享使用 \tn{tocset} 的设置，英文目录的章级别标题名及编号的修改方式如下
-% \changes{v1.25q}{2021/05/05}{增加与双语目录配合的标题命令。}
+% \changes{v1.25r}{2021/05/05}{增加与双语目录配合的标题命令。}
 % \end{function}
 %
 % \begin{function}{biname,binmuber}
@@ -317,7 +317,7 @@
 % \changes{v1.10}{2021/01/08}{修复了 \opt{linktopage} 选项关闭时目录中标题编号无超链接的问题。}
 % \changes{v1.23}{2021/03/19}{修复在 \pkg{ctex} v2.5.6 更新后 \cls{easybook} 与 \pkg{hyperref} 冲突问题。}
 % \changes{v1.24}{2021/04/05}{增加 \pkg{hyperref} 超链接选项完整的支持。}
-% \changes{v1.25q}{2021/05/06}{模块名 \opt{link} 改为 \opt{refset}，\opt{link} 作为兼容性保留。}
+% \changes{v1.25r}{2021/05/06}{模块名 \opt{link} 改为 \opt{refset}，\opt{link} 作为兼容性保留。}
 % \end{function}
 %
 % \begin{optdesc}
@@ -374,7 +374,7 @@
 % \ding{229} 以上选项路径为 \opt{subfont/...}
 % \changes{v1.10}{2021/01/08}{加入自定义非正文字体选项。}
 % \changes{v1.23}{2021/02/08}{修复使用 \tn{zihao} 命令设置字体失效的问题。}
-% \changes{v1.25q}{2021/05/31}{其它字体模块名由 \opt{elsefont} 改为 \opt{subfont}，并增加数学字体的选项 \opt{subfont/math}。}
+% \changes{v1.25r}{2021/05/31}{其它字体模块名由 \opt{elsefont} 改为 \opt{subfont}，并增加数学字体的选项 \opt{subfont/math}。}
 % \end{function}
 %
 % \begin{optdesc}
@@ -399,7 +399,7 @@
 % \changes{v1.21}{2021/01/11}{增加 \opt{bibset} 选项，可以使用 \hologo{BibTeX} 或 \hologo{biber} 编译参考文献。}
 % \changes{v1.23}{2021/02/23}{使用 \opt{bibset} 选项时可设置标注风格。}
 % \changes{v1.24}{2021/04/09}{可以不载入参考文献包手动配置参考文献格式。}
-% \changes{v1.25q}{2021/05/12}{取消 \opt{bib-loadpkg} 选项，由是否设置参考文献数据库来决定载入宏包。}
+% \changes{v1.25r}{2021/05/12}{取消 \opt{bib-loadpkg} 选项，由是否设置参考文献数据库来决定载入宏包。}
 % \end{function}
 %
 % \begin{optdesc}
@@ -605,7 +605,7 @@
 % 上面几个选项用于设置脚注格式，\opt{fnparskip} 和 \opt{fnparindent} 选项仅在 \opt{fnhang = true} 时有效。\opt{fnhang} 用于将脚注设置为悬挂缩进的格式，\opt{fnmark-pos} 选项设置脚注编号的位置，正常文本或是上标形式。\opt{fnmark-num} 选项设置脚注编号的格式，默认为原生样式 \opt{plain}，还可以改为 \opt{pifont} 的各个版本，从左往右依次为普通版、阴文衬线版、阳文无衬线版和阴文无衬线版，缺点是它们的编号仅包括1-10。
 %
 % \opt{fnmark-form} 是脚注标记的格式，在此设置字体命令会覆盖 \opt{subfont/footnote} 的设置，最后一个格式命令可以带有一个参数，这个参数接受脚注编号，一般配合 \opt{fnmark-num = plain} 使用。\opt{afterfnmark} 是脚注标记后的代码，一般用于设置标记与文本间的距离。
-% \changes{v1.25q}{2021/05/12}{增加脚注样式设置选项。}
+% \changes{v1.25r}{2021/05/12}{增加脚注样式设置选项。}
 % \end{function}
 %
 % \subsection{目录样式}
@@ -624,7 +624,7 @@
 % \opt{format} 是目录中标题的格式，可以设置字体和加入垂直间距等，垂直间距最好使用无间距重合的 \tn{addvspace} 命令，带有加号的 \opt{format+} 选项用于在已有的格式命令后附加内容。\opt{indent} 是目录中标题在页面左侧的缩进距离，应该有长度单位。\opt{rule} 选项中一般应当使用 \tn{tocrule} 命令，将会在接下来介绍。\opt{numsep} 是有编号的标题在目录中编号与标题的间距。
 % \changes{v1.21}{2021/01/13}{增加配置目录样式的选项。}
 % \changes{v1.24}{2021/04/20}{增加目录中编号与标题的间距选项 \opt{numsep}。}
-% \changes{v1.25q}{2021/05/14}{可以分别设置图片、表格和代码目录的格式。}
+% \changes{v1.25r}{2021/05/14}{可以分别设置图片、表格和代码目录的格式。}
 % \end{function}
 %
 % \begin{function}[added = 2021-01-13,updated = 2021-04-20]{\tocrule,\EbNumberLine}
@@ -709,7 +709,7 @@
 %   \tn{end}\marg{环境名}
 % \end{syntax}
 % \pkg{tabularray} 是一个较新的宏包，不仅提供了 \pkg{tabularx}、\pkg{multirow}、和 \pkg{booktabs} 宏包的功能，并且不依赖其它宏包与它们同时使用不会产生冲突，还实现了用简便的键值列表方式设置表格样式。目前除了表头斜线以及跨页功能存在不足，其它方面已满足对表格绝大多数格式的需求，具体用法可见宏包的说明文档。
-% \changes{v1.25q}{2021/05/17}{使用功能更便捷齐全的 \pkg{tabularray} 宏包设置表格样式。}
+% \changes{v1.25r}{2021/05/17}{使用功能更便捷齐全的 \pkg{tabularray} 宏包设置表格样式。}
 % \end{function}
 %
 % \subsection{列表}
@@ -873,7 +873,7 @@
 %   \tn{qtyrange}\oarg{键值列表}\marg{数字1}\marg{数字2}\marg{单位}
 % \end{syntax}
 % \pkg{siunitx} 宏包的 \tn{num} 命令可以输出以科学计数法表示的数值，单位格式化命令 \tn{unit} 包含文字项目（例如字母或数字）时，使用 . 和 \~{} 放置在单元乘积中间，并使用 \_ 和 \^{} 正确放置指定的下标和上标。格式化方法可在数学和文本模式下使用。而 \tn{qty} 命令可用来输出带有单位的量，\tn{qtyrange} 可以输出带有范围和单位的量。
-% \changes{v1.25q}{2021/05/18}{\pkg{siunitx} 宏包 v3.0.0 更新后用法改变，修改相关配置选项。}
+% \changes{v1.25r}{2021/05/18}{\pkg{siunitx} 宏包 v3.0.0 更新后用法改变，修改相关配置选项。}
 % \end{function}
 %
 % \begin{ctexexam}
@@ -1011,7 +1011,7 @@
 %<*class>
 \NeedsTeXFormat{LaTeX2e}[2020/10/01]
 \RequirePackage{l3keys2e}
-\ProvidesExplClass{easybook}{2021/06/02}{1.25q}{beta}
+\ProvidesExplClass{easybook}{2021/06/03}{1.25r}{beta}
 
 \bool_set_false:N \l__eb_compile_draft_bool
 \bool_set_false:N \l__eb_title_newline_bool
@@ -1255,7 +1255,7 @@
 %<*package>
 \NeedsTeXFormat{LaTeX2e}[2020/10/01]
 \RequirePackage{etoolbox}
-\ProvidesExplPackage{easybase}{2021/06/02}{1.25q}{beta}
+\ProvidesExplPackage{easybase}{2021/06/03}{1.25r}{beta}
 
 \cs_generate_variant:Nn \eb_ctex_define:nn { nx }
 \cs_generate_variant:Nn \int_to_arabic:n { v }
@@ -1359,7 +1359,7 @@
 \ctex_define:n
   {
     link .meta:nn                 = { ctex/link } {#1},
-    lstlistlistingname .tl_set:N  = \lstlistlistingname,
+    lstlistlistingname .tl_set:N  = \listlstlistingname,
     lstlistingname .tl_set:N      = \lstlistingname
   }
 \eb_ctex_define:nn { style }
@@ -1441,7 +1441,7 @@
   {
     vmargin         = 2.54cm,
     hmargin         = 3.17cm,
-    columnsep       = \ccwd,
+    columnsep       = 2\ccwd,
     headheight      = 2.04cm,
     headsep         = 0.5cm,
     footskip        = 0.79cm,
@@ -2119,69 +2119,60 @@
       { \bisection*{#1}{\l__eb_bib_bitoc_title} }
     \eb@nonumber@markdouble{#1}
   }
-\cs_new_protected:Npn \eb_multoc_pre_bool:
+\cs_new_protected:Npn \eb_toc_multicol_bool:n #1
   {
-    \bool_if:NT \l__eb_multoc_bool
-      { \begin{multicols}{\int_use:N \l__eb_toc_columns_int} }
-  }
-\cs_new_protected:Npn \eb_multoc_post_bool:
-  { \bool_if:NT \l__eb_multoc_bool { \end{multicols} } }
-\RenewDocumentCommand{\tableofcontents}{t+oD(){}}
-  {
-    \group_begin:
-    \tl_set_eq:NN \eb@toc@title \contentsname
-    \tl_set:Nn \eb@bitoc@title { Contents }
-    \IfValueT{#2}{\keys_set:nn { eb/listoc } {#2}}
-    \eb_title_mark_notoc:n { \eb@toc@title }
-    \eb_multoc_pre_bool:
-    \vspace*{\dim_use:N \l__eb_toc_offset_dim}
-    \@starttoc{toc}#3
-    \IfBooleanT{#1}
+    \bool_if:NTF \l__eb_multoc_bool
       {
-        \eb_title_mark_notoc:n { \eb@bitoc@title }
-        \vspace*{\dim_use:N \l__eb_toc_offset_dim}
-        \@starttoc{tec}
+        \begin{multicols}{\int_use:N \l__eb_toc_columns_int}
+          \@starttoc{#1}
+        \end{multicols}
       }
-    \eb_multoc_post_bool:
-    \group_end:
+      { \@starttoc{#1} }
   }
-\RenewDocumentCommand{\listoffigures}{st+o}
+\cs_new_protected:Npn \eb_toc_list_parse:nnnnn #1#2#3#4#5
   {
     \group_begin:
-    \tl_set_eq:NN \eb@toc@title \listfigurename
+    \exp_args:NNc
+    \tl_set_eq:NN \eb@toc@title { list#4name }
     \IfValueT{#3}{\keys_set:nn { eb/listoc } {#3}}
     \eb_title_number_intoc_bool:nn {#2} {#1}
-    \eb_multoc_pre_bool:
-    \dim_add:NV \l__eb_toc_offset_dim \l__eb_toc_figure_offset_dim
+    \exp_args:NNc \dim_add:NV
+    \l__eb_toc_offset_dim { l__eb_toc_#4_offset_dim }
     \vspace*{\dim_use:N \l__eb_toc_offset_dim}
-    \@starttoc{lof}
-    \eb_multoc_post_bool:
+    \eb_toc_multicol_bool:n {#5}
     \group_end:
   }
-\RenewDocumentCommand{\listoftables}{st+o}
+\clist_map_inline:nn
   {
-    \group_begin:
-    \tl_set_eq:NN \eb@toc@title \listtablename
-    \IfValueT{#3}{\keys_set:nn { eb/listoc } {#3}}
-    \eb_title_number_intoc_bool:nn {#2} {#1}
-    \eb_multoc_pre_bool:
-    \dim_add:NV \l__eb_toc_offset_dim \l__eb_toc_table_offset_dim
-    \vspace*{\dim_use:N \l__eb_toc_offset_dim}
-    \@starttoc{lot}
-    \eb_multoc_post_bool:
-    \group_end:
+    { figure,lof },
+    { table,lot },
+    { lstlisting,lol }
   }
-\NewDocumentCommand{\listoflistings}{st+o}
+  {
+    \exp_args:Nc \DeclareDocumentCommand
+      { listof\clist_item:nn {#1} { 1 }s }{st+o}
+      {
+        \eb_toc_list_parse:nnnnn {##1} {##2} {##3}
+          { \clist_item:nn {#1} { 1 } }
+          { \clist_item:nn {#1} { 2 } }
+      }
+  }
+\cs_set_eq:NN \listoflistings \listoflstlistings
+\RenewDocumentCommand{\tableofcontents}{t+oD(){}}
   {
     \group_begin:
-    \tl_set_eq:NN \eb@toc@title \lstlistlistingname
-    \IfValueT{#3}{\keys_set:nn { eb/listoc } {#3}}
-    \eb_title_number_intoc_bool:nn {#2} {#1}
-    \eb_multoc_pre_bool:
-    \dim_add:NV \l__eb_toc_offset_dim \l__eb_toc_lstlisting_offset_dim
+    \tl_set_eq:NN \eb@toc@title \contentsname
+    \tl_set:Nn \eb@bitoc@title { Contents }
+    \IfValueT{#2}{\keys_set:nn { eb/listoc } {#2}}
+    \eb_title_mark_notoc:n { \eb@toc@title }
     \vspace*{\dim_use:N \l__eb_toc_offset_dim}
-    \@starttoc{lol}
-    \eb_multoc_post_bool:
+    \eb_toc_multicol_bool:n { toc }#3
+    \IfBooleanT{#1}
+      {
+        \eb_title_mark_notoc:n { \eb@bitoc@title }
+        \vspace*{\dim_use:N \l__eb_toc_offset_dim}
+        \eb_toc_multicol_bool:n { tec }
+      }
     \group_end:
   }
 
@@ -2421,6 +2412,7 @@
 \skip_set:Nn \textfloatsep { 16pt plus 2pt minus 4pt }
 \skip_set:Nn \dbltextfloatsep { 16pt plus 2pt minus 4pt }
 \skip_set:Nn \@fpsep { 8pt plus 2.0fil }
+\skip_set:Nn \multicolsep { 10pt plus 4pt minus 3pt }
 \setcounter{topnumber}{4}
 \setcounter{bottomnumber}{4}
 \setcounter{totalnumber}{8}
@@ -2763,7 +2755,7 @@
       {
         standard~jigsaw,
         nobeforeafter,tcbox~raise~base,
-        top = 1.25qt,bottom = 1.25qt,left = 1.25qt,right = 1.25qt,
+        top = 1.25rt,bottom = 1.25rt,left = 1.25rt,right = 1.25rt,
         boxrule = 0.75pt,arc = 1pt,
         colback = #1,opacityback = 0.12,colframe = #1,#3
       }{#2}
@@ -2823,6 +2815,8 @@
     \tl_if_empty:NF \l__eb_bib_citestyle_tl
       { \exp_args:NV \setcitestyle \l__eb_bib_citestyle_tl }
     \skip_zero:N \bibsep
+    \AtEndEnvironment{thebibliography}
+      {\bool_if:NT \l__eb_multoc_bool { \end{multicols} }}
     \NewDocumentCommand{\printbibliography}{st+o}
       {
         \group_begin:
@@ -2831,10 +2825,10 @@
         \tl_set:Nn \bibsection
           {
             \eb_title_number_intoc_bool:nn {##2} {##1}
-            \eb_multoc_pre_bool:
+            \bool_if:NT \l__eb_multoc_bool
+              { \begin{multicols}{\int_use:N \l__eb_toc_columns_int} }
           }
         \exp_args:NV \bibliography \l__eb_bib_datafile_tl
-        \eb_multoc_post_bool:
         \group_end:
       }
   }
@@ -2952,12 +2946,12 @@
   { \definecolorset{HTML}{ctex@}{}{frame,#1;emph,#1;verb,#1} }
 \cs_new:Npn \eb_linkcolor_set:n #1
   {
-    linkcolor/\clist_item:nn {#1} {1} .code:n =
+    linkcolor/\clist_item:nn {#1} { 1 } .code:n =
       {
         \eb_define_linkcolor:nnn
-          { \clist_item:nn {#1} {2} }
-          { \clist_item:nn {#1} {3} }
-          { \clist_item:nn {#1} {4} }
+          { \clist_item:nn {#1} { 2 } }
+          { \clist_item:nn {#1} { 3 } }
+          { \clist_item:nn {#1} { 4 } }
         \eb_put_hyperref:n
           {
             linkcolor = ctex@link,linkbordercolor = ctex@link,
@@ -2971,9 +2965,9 @@
     color/\clist_item:nn {#1} {1} .code:n =
       {
         \eb_define_themecolor:nnn
-          { \clist_item:nn {#1} {2} }
-          { \clist_item:nn {#1} {3} }
-          { \clist_item:nn {#1} {4} }
+          { \clist_item:nn {#1} { 2 } }
+          { \clist_item:nn {#1} { 3 } }
+          { \clist_item:nn {#1} { 4 } }
       },
   }
 
diff --git a/macros/latex/contrib/easybook/easybook.pdf b/macros/latex/contrib/easybook/easybook.pdf
index 7d7ea10892..f6612969e9 100644
--- a/macros/latex/contrib/easybook/easybook.pdf
+++ b/macros/latex/contrib/easybook/easybook.pdf
diff --git a/macros/latex/contrib/ocgx2/ChangeLog b/macros/latex/contrib/ocgx2/ChangeLog
index bbf9411f31..244ce66c95 100644
--- a/macros/latex/contrib/ocgx2/ChangeLog
+++ b/macros/latex/contrib/ocgx2/ChangeLog
@@ -1,3 +1,12 @@
+2021-06-03
+	* v0.51: ocgx2.sty
+	* v0.19: ocgbase.sty
+	* fix: pdfmanagement-testphase; ocgcolorlinks
+
+2021-01-25
+	* v0.50: ocgx2.sty
+	* v0.18: ocgbase.sty
+
 2020-06-11
 	* v0.49: ocgx2.sty
 	* fix: `ocgcolorlinks': fixing misplaced page content resulting from
diff --git a/macros/latex/contrib/ocgx2/ocgbase.sty b/macros/latex/contrib/ocgx2/ocgbase.sty
index 7c97c37ab0..6e514c2236 100644
--- a/macros/latex/contrib/ocgx2/ocgbase.sty
+++ b/macros/latex/contrib/ocgx2/ocgbase.sty
@@ -1,3 +1,11 @@
+%%%%%%%%%%%%%%%%%%%%%% pdfmanagement-testphase %%%%%%%%%%%%%%%%%%%
+\newif\if@ocgbase@testphase
+\ExplSyntaxOn
+\bool_if:nT {
+  \bool_lazy_and_p:nn {\cs_if_exist_p:N \pdfmanagement_if_active_p:} { \pdfmanagement_if_active_p: }
+}{\@ocgbase@testphasetrue}
+\ExplSyntaxOff
+\if@ocgbase@testphase\else
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %
 % ocgbase.sty
@@ -94,8 +102,8 @@
 
 \RequirePackage{l3keys2e}
 
-\def\g@ocgbase@date@tl{2021/01/25}
-\def\g@ocgbase@version@tl{0.18}
+\def\g@ocgbase@date@tl{2021/06/03}
+\def\g@ocgbase@version@tl{0.19}
 
 \ProvidesExplPackage{ocgbase}{\g@ocgbase@date@tl}{\g@ocgbase@version@tl}
 {support package for ocgx2.sty}
@@ -364,3 +372,378 @@
 \cs_gset_eq:NN\ocgbase@oc@emc\ocgbase_oc_emc:
 \cs_gset_eq:NN\ocgbase@open@stack@pop\ocgbase_open_stack_pop:N
 \cs_gset_eq:NN\ocgbase@open@stack@push\ocgbase_open_stack_push:n
+\endinput
+\fi
+%%%%%%%%%%%%%%%%%%%%%% /pdfmanagement-testphase %%%%%%%%%%%%%%%%%%%
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+% ocgbase.sty
+%
+% low-level macros for OCG creation, marking optional content and
+% for managment of global (document-wide) OCG related lists;
+%
+% (automatic) OCG configuration in the PDF catalog
+%
+% Copyright 2015--\today, Alexander Grahn
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+% Support package for ocgx2.sty, media9.sty, animate.sty
+%
+% Supported workflows:
+%
+%   pdflatex, lualatex
+%   latex-->dvips-->ps2pdf or Distiller
+%   latex-->dvipdfmx
+%   xelatex
+%
+%   for `dvipdfmx', set it as document class option
+%
+%
+% Commands defined:
+%
+%   \ocgbase_new_ocg:nnn
+%   \ocgbase@new@ocg (LaTeX2e version)
+%     #1: name (as shown in the Layers Tab of the Reader GUI)
+%     #2: usage dict (may be empty), see PDF reference:
+%         http://wwwimages.adobe.com/content/dam/Adobe/en/devnet/pdf/pdfs/
+%                pdf_reference_1-7.pdf#G9.3858276
+%     #3: initial visibility (1|0|true|false|on|off|visible|invisible)
+%
+%   \ocgbase_last_ocg:
+%   \ocgbase@last@ocg (LaTeX2e version)
+%     inserts ID of PDF object created during most recent call of
+%     \ocgbase_new_ocg:nnn
+%
+%   --------
+%
+%   \ocgbase_tree_node_begin:n
+%   \ocgbase_tree_node_end:
+%   \ocgbase@tree@node@begin (LaTeX2e versions)
+%   \ocgbase@tree@node@end
+%     #1: OCG PDF object
+%     macro pair (begin and end) for inserting OCG object and its children
+%     into Order hierarchy (shown as tree structure in the viewers `Layers' tab
+%
+%   --------
+%
+%   \ocgbase_add_to_off_list:n
+%   \ocgbase@add@to@off@list (LaTeX2e version)
+%     #1: PDF object ID of OCG
+%     macro for setting initial visibility to `off'
+%
+%   --------
+%
+%   \ocgbase_del_from_off_list:n
+%   \ocgbase@del@from@off@list (LaTeX2e version)
+%     #1: PDF object ID of OCG
+%     macro for setting initial visibility to `on'
+%
+%   --------
+%
+%   \ocgbase_add_ocg_to_radiobtn_grp:nn
+%   \ocgbase@add@ocg@to@radiobtn@grp
+%     add OCG #2 (obj ref) to radio button group `#1' (string),
+%
+%   --------
+%
+%   \ocgbase_oc_bdc:n
+%   \ocgbase@oc@bdc
+%     #1: OCG obj ref
+%     mark begin of optional content belonging to OCG #1 in the current
+%     content stream
+%
+%   \ocgbase_oc_emc:
+%   \ocgbase@oc@emc
+%     mark end of optional content in the current content stream
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License.
+%
+% The latest version of this license is in
+%   http://mirrors.ctan.org/macros/latex/base/lppl.txt
+%
+% This work has the LPPL maintenance status `maintained'.
+%
+% The Current Maintainer of this work is A. Grahn.
+
+\RequirePackage{l3keys2e}
+
+\def\g@ocgbase@date@tl{2021/06/03}
+\def\g@ocgbase@version@tl{0.19}
+
+\ProvidesExplPackage{ocgbase}{\g@ocgbase@date@tl}{\g@ocgbase@version@tl}
+{support package for ocgx2.sty}
+
+%package options
+
+%unknown package option error message
+\msg_set:nnnn{ocgbase}{unknown~package~option}{Unknown~package~option~`#1'.}{
+  Package option~'#1'~is~unknown;\\
+  perhaps~it~is~spelled~incorrectly.
+}
+
+\keys_define:nn{ocgbase}{
+  xetex .code:n = {}, %dummy
+
+  dvipdfmx .choice:,
+  dvipdfmx / true .code:n = {\PassOptionsToPackage{dvipdfmx}{pdfbase}},
+  dvipdfmx / false .code:n = {},
+  dvipdfmx .default:n = {true},
+
+  unknown .code:n = {
+    \msg_error:nnx{ocgbase}{unknown~package~option}{\l_keys_key_tl}
+  }
+}
+\ProcessKeysOptions{ocgbase}
+
+\RequirePackage{pdfbase}
+
+\msg_set:nnnn{ocgbase}{support~outdated}{
+  Support~package~`#1'~too~old.
+}{
+  Get~an~up~to~date~version~of~`#1'.\\
+  Aborting.
+}
+\@ifpackagelater{pdfbase}{2017/09/29}{}{
+  \msg_error:nnn{ocgbase}{support~outdated}{pdfbase.sty}
+  \tex_endinput:D
+}
+
+\tl_new:N\g_ocgbase_ocgs_tl %takes ocg object refs
+\seq_new:N\g_ocgbase_offocgs_seq
+
+\AddToHook{shipout/lastpage}{
+  \tl_if_empty:NF\g_ocgbase_ocgs_tl{
+    %global OCG array
+    \pbs_pdfobj:nnn{}{array}{\g_ocgbase_ocgs_tl}
+    \tl_set:Nx\l_ocgbase_ocgarray_tl{\pbs_pdflastobj:}
+    \tl_new:N\l_ocgbase_offocgentry_tl
+    %global OFF list
+    \seq_if_empty:NF\g_ocgbase_offocgs_seq{
+      \pbs_pdfobj:nnn{}{array}{\seq_use:Nn\g_ocgbase_offocgs_seq{~}}
+      \tl_set:Nx\l_ocgbase_offocgentry_tl{/OFF~\pbs_pdflastobj:}
+    }
+    %global Order list
+    \tl_new:N\l_ocgbase_ocgorderentry_tl
+    \tl_new:N\l_ocgbase_ocgorder_tl
+    \tl_if_exist:cT{g_ocgbase_nd_0_chld_tl}{
+      \ocgbase_build_order:Nn\l_ocgbase_ocgorder_tl{
+        \tl_use:c{g_ocgbase_nd_0_chld_tl}
+      }
+    }
+    \tl_if_empty:NF\l_ocgbase_ocgorder_tl{
+      \pbs_pdfobj:nnn{}{array}{\l_ocgbase_ocgorder_tl}
+      \tl_set:Nx\l_ocgbase_ocgorderentry_tl{/Order~\pbs_pdflastobj:}
+    }
+    %generate RBGroups entry (radio button groups)
+    \tl_new:N\l_ocgbase_rbtn_groups_tl
+    \seq_map_inline:Nn\g_ocgbase_rbtn_groups_seq{
+      \int_compare:nT{\seq_count:c{g_ocgbase_rbtn_group_#1_seq}>\c_one_int}{
+        \tl_put_right:Nx\l_ocgbase_rbtn_groups_tl{
+          ~[\seq_use:cn{g_ocgbase_rbtn_group_#1_seq}{~}]
+        }
+      }
+    }
+    \tl_new:N\l_ocgbase_rbgroupsentry_tl
+    \tl_if_empty:NF\l_ocgbase_rbtn_groups_tl{
+      \pbs_pdfobj:nnn{}{array}{\l_ocgbase_rbtn_groups_tl}
+      \tl_set:Nx\l_ocgbase_rbgroupsentry_tl{/RBGroups~\pbs_pdflastobj:}
+    }
+    \pdfmanagement_add:nnx{Catalog/OCProperties}{OCGs}{\g_ocgbase_ocgs_tl}
+    \pdfmanagement_add:nnx{Catalog/OCProperties}{D}{<<
+          /AS~[
+            <</Event/View  /Category[/View]  /OCGs~\l_ocgbase_ocgarray_tl>>
+            <</Event/Print /Category[/Print] /OCGs~\l_ocgbase_ocgarray_tl>>
+            <</Event/Export/Category[/Export]/OCGs~\l_ocgbase_ocgarray_tl>>
+          ]
+          /BaseState/ON~\l_ocgbase_offocgentry_tl
+          \l_ocgbase_ocgorderentry_tl
+          \l_ocgbase_rbgroupsentry_tl
+          /ListMode/VisiblePages
+        >>
+    }
+  }
+}
+
+%macro for inserting new OCG object
+\cs_generate_variant:Nn\pdf_object_new:nn{xn}
+\cs_generate_variant:Nn\pdf_object_write:nn{xx}
+\int_new:N\g_ocgbase_int
+\cs_new_protected_nopar:Nn\ocgbase_new_ocg:nnn{
+  \pdf_object_new:xn{g_object_\int_use:N\g_ocgbase_int _pdf}{dict}
+  \pdf_object_write:xx{g_object_\int_use:N\g_ocgbase_int _pdf}{
+    /Type/OCG/Name~(#1)~\str_if_eq:eeF{#2}{}{/Usage<<#2>>}
+  }
+  \tl_gput_right:Nx\g_ocgbase_ocgs_tl{~\pdf_object_ref_last:}
+  \bool_if:nT{
+    \str_if_eq_p:ee{#3}{0} ||
+    \str_if_eq_p:ee{#3}{off} ||
+    \str_if_eq_p:ee{#3}{false} ||
+    \str_if_eq_p:ee{#3}{invisible}
+  }{
+    \ocgbase_add_to_off_list:n{\pdf_object_ref_last:}
+  }
+  \tl_gset:Nx\g_ocgbase_last_ocg_tl{\pdf_object_ref_last:}
+  \tl_gset:cx{g_pbs_objname_\pdf_object_ref_last: _tl}{
+    g_object_\int_use:N\g_ocgbase_int _pdf
+  } 
+  \int_gincr:N\g_ocgbase_int
+}
+
+\cs_new_nopar:Nn\ocgbase_last_ocg:{\g_ocgbase_last_ocg_tl}
+
+\int_new:N\g_ocgbase_nd_int    %node id
+\seq_new:N\g_ocgbase_tree_nd_stack_seq    %stack with open ocg node id
+\seq_new:N\g_ocgbase_tree_ocg_stack_seq    %stack with open ocg obj number
+\seq_gpush:Nn\g_ocgbase_tree_nd_stack_seq{0}    %push root node
+\seq_gpush:Nn\g_ocgbase_tree_ocg_stack_seq{null}    %push root node
+
+%macro for starting OCG object (and nested children) insertion into Order
+%hierarchy (shown as tree structure in the viewers `Layers' tab
+\cs_new_protected:Nn\ocgbase_tree_node_begin:n{ % #1: OCG obj
+  %get the parent node from stack
+  \seq_get:NN\g_ocgbase_tree_nd_stack_seq\l__ocgbase_prnt_tl
+  \tl_if_exist:cTF{g_ocgbase_nd_\l__ocgbase_prnt_tl _chld_tl}{
+    %parent has >=1 children (i. e. my older siblings), traverse them
+    \tl_set:Nv\l__ocgbase_prev_sbl_tl{g_ocgbase_nd_\l__ocgbase_prnt_tl _chld_tl}
+    \tl_set:Nx\l__ocgbase_cur_ocg_tl{#1}
+    \ocgbase_traverse_siblings:NN\l__ocgbase_prev_sbl_tl\l__ocgbase_cur_ocg_tl
+    \str_if_empty:NTF\l__ocgbase_cur_ocg_tl{
+      %I am the first child of my parent to refer to OCG #1
+      \int_gincr:N\g_ocgbase_nd_int
+      \tl_set:Nx\l__ocgbase_cur_nd_tl{\int_use:N\g_ocgbase_nd_int}
+      %set myself as my next-older sibling's `next sibling'
+      \tl_gset:cV{
+        g_ocgbase_nd_\l__ocgbase_prev_sbl_tl _sbl_tl}\l__ocgbase_cur_nd_tl
+    }{
+      %there is already a sibling referring to OCG #1; no new node needs be
+      %created
+      \tl_set:NV\l__ocgbase_cur_nd_tl\l__ocgbase_prev_sbl_tl
+    }
+  }{
+    %I am the very first child of my parent
+    \int_gincr:N\g_ocgbase_nd_int
+    \tl_set:Nx\l__ocgbase_cur_nd_tl{\int_use:N\g_ocgbase_nd_int}
+    %set myself as my parent's first child
+    \tl_gset:cV{g_ocgbase_nd_\l__ocgbase_prnt_tl _chld_tl}\l__ocgbase_cur_nd_tl
+  }
+  %set the OCG I am referring to
+  \tl_gset:cx{g_ocgbase_nd_\l__ocgbase_cur_nd_tl _ocg_tl}{#1}
+  %push current node and its associated OCG obj on the stacks
+  \seq_gpush:NV\g_ocgbase_tree_nd_stack_seq\l__ocgbase_cur_nd_tl
+  \seq_gpush:Nx\g_ocgbase_tree_ocg_stack_seq{#1}
+}
+
+%macro that ends insertion of OCG and sub-OCGs into Order tree
+\cs_new_protected:Nn\ocgbase_tree_node_end:{
+  \seq_get:NN\g_ocgbase_tree_nd_stack_seq\l_tempa_tl
+  \seq_get:NN\g_ocgbase_tree_ocg_stack_seq\l_tempb_tl
+  \str_if_eq:eeT{
+    \cs_if_exist_use:c{g_ocgbase_nd_\l_tempa_tl _ocg_tl}
+  }{
+    \l_tempb_tl
+  }{
+    \seq_gpop:NN\g_ocgbase_tree_nd_stack_seq\g_trash_tl
+    \seq_gpop:NN\g_ocgbase_tree_ocg_stack_seq\g_trash_tl
+  }
+}
+
+% helper macro (recursive); traverses siblings to find either
+% the node which refers to the same OCG (arg #2 remains un-modified), or
+% the last sibling inserted (arg #2 is cleared);
+% the node id of the sibling found is returned in arg #1
+\cs_new:Nn\ocgbase_traverse_siblings:NN{
+  % #1: current node (in/out),  #2: OCG obj (in/out)
+  \str_if_eq:eeF{#2}{\tl_use:c{g_ocgbase_nd_#1_ocg_tl}}{
+    \tl_if_exist:cTF{g_ocgbase_nd_#1_sbl_tl}{
+      \tl_set:Nv#1{g_ocgbase_nd_#1_sbl_tl}
+      \ocgbase_traverse_siblings:NN#1#2
+    }{
+      \tl_clear:N#2
+    }
+  }
+}
+
+\cs_new:Nn\ocgbase_build_order:Nn{
+  % (recursive macro)
+  % #1: tl var to which the OCG order is written (output)
+  % #2: starting node id (input; usually `1')
+  \tl_set:Nx\l__ocgbase_cur_nd_tl{#2}
+  % first, append the OCG obj the current node is referring to
+  \tl_put_right:Nx#1{~\tl_use:c{g_ocgbase_nd_\l__ocgbase_cur_nd_tl _ocg_tl}}
+  % second, traverse the tree starting with the first child node
+  \tl_if_exist:cT{g_ocgbase_nd_\l__ocgbase_cur_nd_tl _chld_tl}{
+    \seq_gpush:NV\g_ocgbase_tree_nd_stack_seq\l__ocgbase_cur_nd_tl
+    \tl_put_right:Nn#1{~[}
+    \ocgbase_build_order:Nn#1{
+      \tl_use:c{g_ocgbase_nd_\l__ocgbase_cur_nd_tl _chld_tl}}
+    \tl_put_right:Nn#1{~]}
+    \seq_gpop:NN\g_ocgbase_tree_nd_stack_seq\l__ocgbase_cur_nd_tl
+  }
+  % third, traverse the tree starting with the next sibling node
+  \tl_if_exist:cT{g_ocgbase_nd_\l__ocgbase_cur_nd_tl _sbl_tl}{
+    \ocgbase_build_order:Nn#1{
+      \tl_use:c{g_ocgbase_nd_\l__ocgbase_cur_nd_tl _sbl_tl}}
+  }
+}
+
+%macro for appending an OCG object to the global `OFF' list
+%(initial non-visibility)
+\cs_new_protected_nopar:Nn\ocgbase_add_to_off_list:n{
+  \seq_if_in:NxF\g_ocgbase_offocgs_seq{#1}{
+    \seq_gput_right:Nx\g_ocgbase_offocgs_seq{#1}
+  }
+}
+
+%macro for removing an OCG object from global `OFF' list
+%(initial non-visibility)
+\cs_new_protected_nopar:Nn\ocgbase_del_from_off_list:n{
+  \seq_if_in:NxT\g_ocgbase_offocgs_seq{#1}{
+    \ocgbase_seq_gremove_all:Nx\g_ocgbase_offocgs_seq{#1}
+  }
+}
+\cs_set_eq:NN\ocgbase_seq_gremove_all:Nn\seq_gremove_all:Nn
+\cs_generate_variant:Nn\ocgbase_seq_gremove_all:Nn{Nx}
+
+\seq_new:N\g_ocgbase_rbtn_groups_seq
+\cs_new_protected_nopar:Nn\ocgbase_add_ocg_to_radiobtn_grp:nn{
+  % #1: rbtn group name,
+  % #2: OCG obj ref
+  \seq_if_exist:cF{g_ocgbase_rbtn_group_#1_seq}{
+    \seq_new:c{g_ocgbase_rbtn_group_#1_seq}
+    \seq_gput_right:Nx\g_ocgbase_rbtn_groups_seq{#1}
+  }
+  \seq_if_in:cxF{g_ocgbase_rbtn_group_#1_seq}{#2}{
+    \seq_gput_right:cx{g_ocgbase_rbtn_group_#1_seq}{#2}
+  }
+}
+
+% OC-marked content
+\cs_new_protected_nopar:Nn\ocgbase_oc_bdc:n{\pbs_pdfbdc:nn{OC}{#1}}
+\cs_new_protected_nopar:Nn\ocgbase_oc_emc:{\pbs_pdfemc:}
+
+%stack of PDF obj references of currently open OCGs
+\seq_new:N\g_ocgbase_open_stack_seq
+%push OCG to stack
+\cs_new_protected_nopar:Nn\ocgbase_open_stack_push:n{
+  \seq_gpush:Nx\g_ocgbase_open_stack_seq{#1}}
+%pop OCG from stack into tl
+\cs_new_protected_nopar:Nn\ocgbase_open_stack_pop:N{
+    \seq_gpop:NN\g_ocgbase_open_stack_seq#1}
+
+%l2e versions
+\cs_gset_eq:NN\ocgbase@new@ocg\ocgbase_new_ocg:nnn
+\cs_gset_eq:NN\ocgbase@last@ocg\ocgbase_last_ocg:
+\cs_gset_eq:NN\ocgbase@tree@node@begin\ocgbase_tree_node_begin:n
+\cs_gset_eq:NN\ocgbase@tree@node@end\ocgbase_tree_node_end:
+\cs_gset_eq:NN\ocgbase@add@to@off@list\ocgbase_add_to_off_list:n
+\cs_gset_eq:NN\ocgbase@del@from@off@list\ocgbase_del_from_off_list:n
+\cs_gset_eq:NN\ocgbase@add@ocg@to@radiobtn@grp\ocgbase_add_ocg_to_radiobtn_grp:nn
+\cs_gset_eq:NN\ocgbase@oc@bdc\ocgbase_oc_bdc:n
+\cs_gset_eq:NN\ocgbase@oc@emc\ocgbase_oc_emc:
+\cs_gset_eq:NN\ocgbase@open@stack@pop\ocgbase_open_stack_pop:N
+\cs_gset_eq:NN\ocgbase@open@stack@push\ocgbase_open_stack_push:n
diff --git a/macros/latex/contrib/ocgx2/ocgx2.sty b/macros/latex/contrib/ocgx2/ocgx2.sty
index 470057f619..f2375cfbf9 100644
--- a/macros/latex/contrib/ocgx2/ocgx2.sty
+++ b/macros/latex/contrib/ocgx2/ocgx2.sty
@@ -1,3 +1,11 @@
+%%%%%%%%%%%%%%%%%%%%%% pdfmanagement-testphase %%%%%%%%%%%%%%%%%%%
+\newif\if@ocgxii@testphase
+\ExplSyntaxOn
+\bool_if:nT {
+  \bool_lazy_and_p:nn {\cs_if_exist_p:N \pdfmanagement_if_active_p:} { \pdfmanagement_if_active_p: }
+}{\@ocgxii@testphasetrue}
+\ExplSyntaxOff
+\if@ocgxii@testphase\else
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %
 % ocgx2.sty
@@ -39,8 +47,8 @@
 
 \RequirePackage{l3keys2e}
 
-\def\g@ocgxii@date@tl{2021/01/25}
-\def\g@ocgxii@version@tl{0.50}
+\def\g@ocgxii@date@tl{2021/06/03}
+\def\g@ocgxii@version@tl{0.51}
 
 \ProvidesExplPackage{ocgx2}{\g@ocgxii@date@tl}{\g@ocgxii@version@tl}
 {ports `ocgx' functionality to dvips+ps2pdf, xelatex and dvipdfmx}
@@ -1254,20 +1262,18 @@
         /Export<</ExportState/OFF>>
       }{on}
       \tl_gset:cx{ocgxii_ocg_OCView}{\ocgbase_last_ocg:}
-      \ocgbase_add_ocg_to_radiobtn_grp:nn{OCPrintViewGrp}{\ocgbase_last_ocg:}
       %in case somebody wants to reopen with \begin{ocg}...
       \tl_gset:cx{ocgxii_ocg_OCView.opts}{
-        showingui=never,printocg=never,exportocg=never,
-        radiobtngrp=OCPrintViewGrp}
+        showingui=never,printocg=never,exportocg=never
+      }
       \ocgbase_new_ocg:nnn{OCPrint}{
         /Print<</PrintState/ON>>
         /Export<</ExportState/ON>>
       }{off}
       \tl_gset:cx{ocgxii_ocg_OCPrint}{\ocgbase_last_ocg:}
-      \ocgbase_add_ocg_to_radiobtn_grp:nn{OCPrintViewGrp}{\ocgbase_last_ocg:}
       \tl_gset:cx{ocgxii_ocg_OCPrint.opts}{
-        showingui=never,printocg=always,exportocg=always,
-        radiobtngrp=OCPrintViewGrp}
+        showingui=never,printocg=always,exportocg=always
+      }
       \ocgxii_enable_ocglinks:
       \iow_now:Nx\@mainaux{
         \token_to_str:N\ocgxii@newkey{ocgx2.ocg.OCView}{
@@ -1493,3 +1499,1490 @@
     }
   }
 }
+\endinput
+\fi
+%%%%%%%%%%%%%%%%%%%%%% /pdfmanagement-testphase %%%%%%%%%%%%%%%%%%%
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+% ocgx2.sty
+%
+% Copyright 2015--\today, Alexander Grahn
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%
+% The intent of this package is to be a drop-in replacement for the already
+% existing CTAN package `ocgx' by Paul Gaborit, and also for `ocg-p' and `ocg'.
+%
+% It re-implements the functionality of the ocg, ocgx and ocg-p packages
+% and adds support for all known engines and backends including
+% latex+dvips+ps2pdf, xelatex, latex+dvipdfmx, lualatex.
+%
+% With ocgx2, PDF layers may extend across page breaks.
+%
+% ocgx2 implements OCMDs (optional content membership dictionaries)
+%
+% Adds some minor improvements, such as package options, remembering option.
+% settings of reopened ocgs, correct behaviour of ocg switching links that were
+% themselves placed on layers, compatibility with the animate and media9
+% packages.
+%
+% Re-implements hyperref's `ocgcolorlinks' option to produce coloured links
+% that may wrap around line breaks and page breaks.
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License.
+%
+% The latest version of this license is in
+%   http://mirrors.ctan.org/macros/latex/base/lppl.txt
+%
+% This work has the LPPL maintenance status `maintained'.
+%
+% The Current Maintainer of this work is A. Grahn.
+
+\RequirePackage{l3keys2e}
+
+\def\g@ocgxii@date@tl{2021/06/03}
+\def\g@ocgxii@version@tl{0.51}
+
+\ProvidesExplPackage{ocgx2}{\g@ocgxii@date@tl}{\g@ocgxii@version@tl}
+{ports `ocgx' functionality to dvips+ps2pdf, xelatex and dvipdfmx}
+
+%creating global definitions
+\cs_new_protected:Npn\ocgxii@newkey#1#2{\tl_gset:cx{#1}{#2}}
+\cs_new_protected:Npn\ocgxii@newkeynoexp#1#2{\tl_gset:cn{#1}{#2}}
+
+\AtBeginDocument{
+  \iow_now:Nx\@mainaux{
+    \token_to_str:N\providecommand\token_to_str:N\ocgxii@newkey[2]{}
+  }
+  \iow_now:Nx\@mainaux{
+    \token_to_str:N\providecommand\token_to_str:N\ocgxii@newkeynoexp[2]{}
+  }
+  \iow_now:Nx\@mainaux{
+    \token_to_str:N\providecommand\token_to_str:N\ocgxii@ocg@stack@on@page[2]{}
+  }
+  \iow_now:Nx\@mainaux{
+    \token_to_str:N\providecommand
+      \token_to_str:N\ocgxii@lnkcol@stack@on@page[2]{}
+  }
+}
+
+\msg_set:nnn{ocgx2}{generic~msg}{#1\\#2}
+
+\msg_set:nnn{ocgx2}{missing~package}{
+  Package~`#1'~must~be~loaded~before~ocgx2.\\\\
+  Put\\\\
+  \space\space\string\usepackage#2{#1}\\
+  \space\space\string\usepackage[ocgcolorlinks]{ocgx2}\\\\
+  to~the~preamble~of~your~document.
+}
+
+\msg_set:nnn{ocgx2}{beamer~and~ocgcolorlinks}{
+  Option~`ocgcolorlinks'~cannot~be~used~with~class~Beamer.\\\\
+  Using~`colorlinks'~instead.
+}
+
+%package opts
+%unknown package option error message
+\msg_set:nnnn{ocgx2}{unknown~package~option}{Unknown~package~option~`#1'.}{
+  Package option~'#1'~is~unknown;\\
+  perhaps~it~is~spelled~incorrectly.
+}
+
+\bool_new:N\g_ocgxii_dvipdfmx_bool
+\bool_new:N\l_ocgxii_tikz_bool
+\bool_new:N\l_ocgxii_ocgcolorlinks_bool
+\bool_new:N\g_ocgxii_showingui_bool
+\bool_new:N\l_ocgxii_showingui_bool
+
+\keys_define:nn{ocgx2}{
+  xetex .code:n = {}, %dummy
+
+  dvipdfmx .code:n = {
+    \PassOptionsToPackage{dvipdfmx}{ocgbase}
+    \PassOptionsToPackage{dvipdfmx}{pdfbase}
+    \bool_gset_true:N\g_ocgxii_dvipdfmx_bool
+  },
+
+  viewocg .choice:,
+  viewocg / always .code:n={
+    \tl_gset:Nn\g_ocgxii_view_tl{/View<</ViewState/ON>>}},
+  viewocg / never .code:n={
+    \tl_gset:Nn\g_ocgxii_view_tl{/View<</ViewState/OFF>>}},
+  viewocg / ifvisible .code:n={\tl_gclear_new:N\g_ocgxii_view_tl},
+  viewocg .default:n={ifvisible},
+
+  printocg .choice:,
+  printocg / always .code:n={
+    \tl_gset:Nn\g_ocgxii_print_tl{/Print<</PrintState/ON>>}},
+  printocg / never .code:n={
+    \tl_gset:Nn\g_ocgxii_print_tl{/Print<</PrintState/OFF>>}},
+  printocg / ifvisible .code:n={\tl_gclear_new:N\g_ocgxii_print_tl},
+  printocg .default:n={ifvisible},
+
+  exportocg .choice:,
+  exportocg / always .code:n={
+    \tl_gset:Nn\g_ocgxii_export_tl{/Export<</ExportState/ON>>}},
+  exportocg / never .code:n={
+    \tl_gset:Nn\g_ocgxii_export_tl{/Export<</ExportState/OFF>>}},
+  exportocg / ifvisible .code:n={\tl_gclear_new:N\g_ocgxii_export_tl},
+  exportocg .default:n={ifvisible},
+
+  showingui .choices:nn = {true,false,always,never,iffirstuse}{
+    \bool_if:nTF{
+      \str_if_eq_p:ee{#1}{false} ||
+      \str_if_eq_p:ee{#1}{never}
+    }{
+      \bool_gset_false:N\g_ocgxii_showingui_bool
+    }{
+      \bool_gset_true:N\g_ocgxii_showingui_bool
+    }
+  },
+  showingui .default:n={true},
+
+  listintoolbar .meta:n = {showingui=#1},
+  listintoolbar .default:n={true},
+
+  tikz .bool_set:N = \l_ocgxii_tikz_bool,
+  tikz .default:n = true,
+
+  ocgcolorlinks .bool_set:N = \l_ocgxii_ocgcolorlinks_bool,
+  ocgcolorlinks .default:n = true,
+
+  unknown .code:n = {
+    \msg_error:nnx{ocgx2}{unknown~package~option}{\l_keys_key_tl}
+  }
+}
+
+%package options preset
+\keys_set:nn{ocgx2}{viewocg,printocg,exportocg,showingui,tikz=false}
+
+%process package options
+\ProcessKeysOptions{ocgx2}
+\sys_if_engine_xetex:T{\bool_gset_true:N\g_ocgxii_dvipdfmx_bool}
+
+\RequirePackage{ocgbase} %also loads pdfbase.sty
+
+%re-implement ocg-p's `ocg' environment
+\DeclareDocumentEnvironment{ocg}{O{}mmm}{
+  \ocgxii_begin_ocg:nnnn{#1}{#2}{#3}{#4}
+}{
+  \ocgxii_end_ocg:
+}
+
+\cs_new_protected_nopar:Nn\ocgxii_begin_ocg:nnnn{
+  \group_begin:
+    \ocgxii_reset_cmd_opts:  % ... to the user-set package options
+    \tl_set:Nx\l_ocgxii_argiv_tl{\tl_trim_spaces:n{#4}}
+    \tl_if_exist:cTF{ocgxii_ocg_#3}{ %re-open existing layer
+      \tl_set:Nx\l_tempa_tl{\tl_use:c{ocgxii_ocg_#3.opts},#1}
+      \tl_gset:cx{ocgxii_ocg_#3.opts}{\l_tempa_tl} %new options appended
+      \keys_set:nV{ocgx2/ocgenv}\l_tempa_tl
+      \bool_if:nTF{ %initial visibility
+        \str_if_eq_p:ee{\l_ocgxii_argiv_tl}{1} ||
+        \str_if_eq_p:ee{\l_ocgxii_argiv_tl}{on} ||
+        \str_if_eq_p:ee{\l_ocgxii_argiv_tl}{true}
+      }{
+        \ocgbase_del_from_off_list:n{\tl_use:c{ocgxii_ocg_#3}}
+      }{
+        \ocgbase_add_to_off_list:n{\tl_use:c{ocgxii_ocg_#3}}
+      }
+    }{
+      \tl_set:Nx\l_tempa_tl{#1}
+      \tl_gset:cx{ocgxii_ocg_#3.opts}{\l_tempa_tl}
+      \keys_set:nV{ocgx2/ocgenv}\l_tempa_tl
+      \ocgbase_new_ocg:nnn{#2}{
+        \l_ocgxii_view_tl\l_ocgxii_print_tl\l_ocgxii_export_tl
+      }{\l_ocgxii_argiv_tl}
+      \tl_gset:cx{ocgxii_ocg_#3}{\ocgbase_last_ocg:}
+      \tl_gset:cx{ocgx2.ocg.\ocgbase_last_ocg:}{\ocgbase_last_ocg:}
+      \tl_gset:cx{ocgx2.ocg.#3}{\ocgbase_last_ocg:}
+      \iow_now:Nx\@mainaux{
+        \token_to_str:N\ocgxii@newkey{ocgx2.ocg.#3}{\ocgbase_last_ocg:}
+      }
+    }
+    \bool_if:nT{
+      !\cs_if_exist:cTF{ocgx2.ocg.#3}{
+        \str_if_eq_p:ee{\tl_use:c{ocgx2.ocg.#3}}{\tl_use:c{ocgxii_ocg_#3}}
+      }{
+        \c_false_bool
+      }
+    }{
+      \tl_if_exist:NF\g_ocgxii_rerunwarned_tl{
+        \tl_new:N\g_ocgxii_rerunwarned_tl
+        \AtEndDocument{\msg_warning:nn{ocgx2}{rerun}}
+      }
+    }
+    \seq_map_inline:Nn\l_ocgxii_rbgrps_seq{% process list of radio btn groups
+      \ocgbase_add_ocg_to_radiobtn_grp:nn{##1}{\tl_use:c{ocgxii_ocg_#3}}
+    }
+    \ocgbase_open_stack_push:n{\tl_use:c{ocgxii_ocg_#3}}
+    \ocgxii_make_oc_entry:
+    \ocgxii_stack_shipout:NN\ocgxii@ocg@stack@on@page\g_ocgbase_open_stack_seq
+    % insert OCG into Order tree
+    \bool_if:NT\l_ocgxii_showingui_bool{
+      \ocgbase_tree_node_begin:n{\tl_use:c{ocgxii_ocg_#3}}
+    }
+  \group_end:
+  \ocgbase_oc_bdc:n{\tl_use:c{ocgxii_ocg_#3}}
+  \ignorespaces
+}
+
+\cs_new_protected_nopar:Nn\ocgxii_end_ocg:{
+  \unskip
+  \ocgbase_oc_emc:
+  \ocgbase_tree_node_end:
+  \ocgbase_open_stack_pop:N\l_trash_tl
+  \ocgxii_make_oc_entry:
+  \ocgxii_stack_shipout:NN\ocgxii@ocg@stack@on@page\g_ocgbase_open_stack_seq
+}
+
+% OCMD implementation
+\DeclareDocumentEnvironment{ocmd}{O{}m}{
+  \ocgxii_begin_ocmd:on{#1}{#2}
+  \ignorespaces
+}{
+  \unskip
+  \ocgxii_end_ocmd:
+}
+
+\cs_new_protected_nopar:Nn\ocgxii_begin_ocmd:nn{ % #1: id,
+  \bool_if:nTF{                                  % #2: visib. expr. or policy
+    \tl_if_blank:oTF{#1}{
+      \c_false_bool
+    }{
+      \tl_if_exist_p:c{ocgxii_ocmd_#1}
+    }
+  }{
+    % re-open existing ocmd
+    \tl_set_eq:Nc\l_ocgxii_cur_ocmd_tl{ocgxii_ocmd_#1}
+  }{
+    % new ocmd
+    \group_begin:
+      \ocgxii_ocmd_read_visbility:nN{#2}\l_ocgxii_ocmd_visibility_tl
+      \pdf_object_new:xn{g_object_\int_use:N\g_ocgbase_int _pdf}{dict}
+      \pdf_object_write:xx{g_object_\int_use:N\g_ocgbase_int _pdf}{
+        /Type/OCMD\l_ocgxii_ocmd_visibility_tl
+      }
+      \tl_gset:cx{g_pbs_objname_\pdf_object_ref_last: _tl}{
+        g_object_\int_use:N\g_ocgbase_int _pdf
+      }
+      \int_gincr:N\g_ocgbase_int
+      %if only visb. policy is given, generate equivalent visib. expression,
+      %needed for stack of open layers and \ocgxii_make_oc_entry: command
+      \ocgxii_ocmd_make_equiv_ve:nN{#2}\l_ocgxii_ocmd_equiv_ve_tl
+      \tl_gset:co{ocgx2.ocmd.\pdf_object_ref_last:}{\l_ocgxii_ocmd_equiv_ve_tl}
+    \group_end:
+    \tl_set:Nx\l_ocgxii_cur_ocmd_tl{\pdf_object_ref_last:}
+    \tl_if_blank:oF{#1}{
+      \tl_gset:cx{ocgxii_ocmd_#1}{\pdf_object_ref_last:}
+      \iow_now:Nn\@mainaux{\ocgxii@newkeynoexp{ocgx2.ocmd.#1}{#2}}
+    }
+  }
+  \ocgbase_open_stack_push:n{\l_ocgxii_cur_ocmd_tl}
+  \ocgxii_make_oc_entry:
+  \ocgxii_stack_shipout:NN\ocgxii@ocg@stack@on@page\g_ocgbase_open_stack_seq
+  \ocgbase_oc_bdc:n{\l_ocgxii_cur_ocmd_tl}
+}
+\cs_generate_variant:Nn\ocgxii_begin_ocmd:nn{on}
+\cs_new_protected_nopar:Nn\ocgxii_end_ocmd:{
+  \ocgbase_oc_emc:
+  \ocgbase_open_stack_pop:N\l_trash_tl
+  \ocgxii_make_oc_entry: %update
+  \ocgxii_stack_shipout:NN\ocgxii@ocg@stack@on@page\g_ocgbase_open_stack_seq
+}
+
+%visibility expressions
+\cs_new_protected_nopar:Nn\ocgxii_ocmd_read_visbility:nN{
+  \int_zero:N\l_ocgxii_ve_cnt_int
+  \int_zero:N\l_ocgxii_vp_cnt_int
+  \tl_clear_new:N#2
+  \clist_map_inline:nn{#1}{\ocgxii_omcd_parse_argument:nN{##1}#2}
+}
+\cs_new_protected_nopar:Nn\ocgxii_omcd_parse_argument:nN{
+  \cs_set_eq:NN\AllOn \ocgxii_vp_check:n
+  \cs_set_eq:NN\AnyOn \ocgxii_vp_check:n
+  \cs_set_eq:NN\AnyOff\ocgxii_vp_check:n
+  \cs_set_eq:NN\AllOff\ocgxii_vp_check:n
+  \cs_set_eq:NN\Not\ocgxii_ve_check:n
+  \cs_set_eq:NN\And\ocgxii_ve_check:n
+  \cs_set_eq:NN\Or \ocgxii_ve_check:n
+  \tl_if_exist:cTF{ocgx2.ocg.#1}{
+    \msg_error:nnxx{ocgx2}{generic~msg}{
+      OCG~ids~cannot~be~directly~used~in~the~visibility~argument~of~an~
+      `ocmd'~environment.
+    }{\g_ocgxii_help_msg_tl}
+  }{
+    \tl_if_exist:cTF{ocgx2.ocmd.#1}{
+      \msg_error:nnxx{ocgx2}{generic~msg}{
+        OCMD~ids~cannot~be~directly~used~in~the~visibility~argument~of~an~
+        `ocmd'~environment.
+      }{\g_ocgxii_help_msg_tl}
+    }{
+      \tl_if_exist:cTF{ocgxii_#1}{
+        \str_case_e:nn{\tl_use:c{ocgxii_#1}}{
+          {VisExpr}{
+            \int_incr:N\l_ocgxii_ve_cnt_int
+            \int_compare:nNnTF{\l_ocgxii_ve_cnt_int}>{1}{
+              \msg_error:nnnn{ocgx2}{generic~msg}{
+                More~than~one~visibility~expression~passed~to~the~`ocmd'~
+                environment.
+              }{
+                At~most~one~visibility~expression~is~allowed.~A~visibility~
+                expression~is~a~boolean~expression~built~by~nesting~any~number~of~
+                \And{...},~\Or{...},~\Not{...}~commands.
+              }
+            }{
+              \tl_put_right:Nx#2{/VE~}
+              \ocgxii_ocmd_expression_parser:nN{#1}#2
+            }
+          }
+          {VisPol}{
+            \int_incr:N\l_ocgxii_vp_cnt_int
+            \int_compare:nNnTF{\l_ocgxii_vp_cnt_int}>{1}{
+              \msg_error:nnnn{ocgx2}{generic~msg}{
+                More~than~one~visibility~policy~passed~to~the~`ocmd'~environment.
+              }{
+                At~most~one~visibility~policy~out~of~\AllOn{...},~\AnyOn{...},~
+                \AnyOff{...},~\AllOff{...}~is~allowed.~Any~number~of~OCG~IDs,~
+                separated~by~commas,~may~be~passed~as~arguments~to~these~
+                commands,~but~commands~may~not~be~nested.~For~complex~visibilty~
+                relations,~consider~using~a~visibility~expression.
+              }
+            }{
+              \ocgxii_ocmd_expression_parser:nN{#1}#2
+            }
+          }
+        }
+      }{
+        \msg_error:nnxx{ocgx2}{generic~msg}{
+          The~visibility~argument~of~the~`ocmd'~environment~cannot~be~parsed.
+        }{\g_ocgxii_help_msg_tl}
+      }
+    }
+  }
+}
+\cs_generate_variant:Nn\ocgxii_omcd_parse_argument:nN{xN}
+\cs_generate_variant:Nn\ocgxii_omcd_parse_argument:nN{oN}
+\cs_new_protected_nopar:Nn\ocgxii_ocmd_expression_parser:nN{
+  \cs_set_eq:NN\AllOn \ocgxii_vp_check:n
+  \cs_set_eq:NN\AnyOn \ocgxii_vp_check:n
+  \cs_set_eq:NN\AnyOff\ocgxii_vp_check:n
+  \cs_set_eq:NN\AllOff\ocgxii_vp_check:n
+  \cs_set_eq:NN\Not\ocgxii_ve_check:n
+  \cs_set_eq:NN\And\ocgxii_ve_check:n
+  \cs_set_eq:NN\Or \ocgxii_ve_check:n
+  \tl_if_exist:cTF{ocgx2.ocg.#1}{% ocg reference
+    \tl_put_right:Nx#2{~\tl_use:c{ocgx2.ocg.#1}}
+  }{
+    \tl_if_exist:cTF{ocgx2.ocmd.#1}{% ocmd reference
+      \ocgxii_ocmd_expression_parser:vN{ocgx2.ocmd.#1}#2
+    }{
+      \tl_if_exist:cTF{ocgxii_#1}{% visib. bool expression or policy directive
+        \bool_if:nTF{
+          \str_if_eq_p:ee{\tl_use:c{ocgxii_#1}}{VisExpr} &&
+          \bool_if_p:N\l_ocgxii_vp_open_bool ||
+          \str_if_eq_p:ee{\tl_use:c{ocgxii_#1}}{VisPol} &&
+          \bool_if_p:N\l_ocgxii_ve_open_bool
+        }{
+          \msg_error:nnxx{ocgx2}{generic~msg}{
+            Visibility~policy~and~expression~commands~cannot~be~mixed.
+          }{\g_ocgxii_help_msg_tl}
+        }{
+          \bool_if:nT{
+            \str_if_eq_p:ee{\tl_use:c{ocgxii_#1}}{VisPol} &&
+            \bool_if_p:N\l_ocgxii_vp_open_bool
+          }{
+            \msg_error:nnxx{ocgx2}{generic~msg}{
+              Visibility~policy~commands~cannot~be~nested.~For~more~complex~
+              visibilty~relations,~consider~using~a~visibility~expression.
+            }{\g_ocgxii_help_msg_tl}
+          }
+        }
+        \cs_set_eq:NN\AllOn \ocgxii_vp_allon:nN
+        \cs_set_eq:NN\AnyOn \ocgxii_vp_anyon:nN
+        \cs_set_eq:NN\AnyOff\ocgxii_vp_anyoff:nN
+        \cs_set_eq:NN\AllOff\ocgxii_vp_alloff:nN
+        \cs_set_eq:NN\Not\ocgxii_ve_not:nN
+        \cs_set_eq:NN\And\ocgxii_ve_and:nN
+        \cs_set_eq:NN\Or \ocgxii_ve_or:nN
+        #1#2
+      }{
+        \msg_warning:nnx{ocgx2}{undefined~OCG}{#1}
+        \tl_if_exist:NF\g_ocgxii_refundefwarned_tl{
+          \tl_new:N\g_ocgxii_refundefwarned_tl
+          \AtEndDocument{\msg_warning:nn{ocgx2}{undefined~OCGs}}
+        }
+      }
+    }
+  }
+}
+\cs_generate_variant:Nn\ocgxii_ocmd_expression_parser:nN{vN}
+% visib. policy directives
+\cs_new_protected_nopar:Nn\ocgxii_vp_allon:nN{
+  \bool_set_true:N\l_ocgxii_vp_open_bool
+  \tl_put_right:Nx#2{/P/AllOn/OCGs~\g_ocgxii_left_bracket_tl}
+  \clist_map_inline:nn{#1}{\ocgxii_ocmd_expression_parser:nN{##1}#2}
+  \tl_put_right:Nx#2{\g_ocgxii_right_bracket_tl}
+  \bool_set_false:N\l_ocgxii_vp_open_bool
+}
+\cs_new_protected_nopar:Nn\ocgxii_vp_anyon:nN{
+  \bool_set_true:N\l_ocgxii_vp_open_bool
+  \tl_gput_right:Nx#2{/P/AnyOn/OCGs~\g_ocgxii_left_bracket_tl}
+  \clist_map_inline:nn{#1}{\ocgxii_ocmd_expression_parser:nN{##1}#2}
+  \tl_gput_right:Nx#2{\g_ocgxii_right_bracket_tl}
+  \bool_set_false:N\l_ocgxii_vp_open_bool
+}
+\cs_new_protected_nopar:Nn\ocgxii_vp_anyoff:nN{
+  \bool_set_true:N\l_ocgxii_vp_open_bool
+  \tl_gput_right:Nx#2{/P/AnyOff/OCGs~\g_ocgxii_left_bracket_tl}
+  \clist_map_inline:nn{#1}{\ocgxii_ocmd_expression_parser:nN{##1}#2}
+  \tl_gput_right:Nx#2{\g_ocgxii_right_bracket_tl}
+  \bool_set_false:N\l_ocgxii_vp_open_bool
+}
+\cs_new_protected_nopar:Nn\ocgxii_vp_alloff:nN{
+  \bool_set_true:N\l_ocgxii_vp_open_bool
+  \tl_gput_right:Nx#2{/P/AllOff/OCGs~\g_ocgxii_left_bracket_tl}
+  \clist_map_inline:nn{#1}{\ocgxii_ocmd_expression_parser:nN{##1}#2}
+  \tl_gput_right:Nx#2{\g_ocgxii_right_bracket_tl}
+  \bool_set_false:N\l_ocgxii_vp_open_bool
+}
+% policy to expression conversion
+\cs_new_protected_nopar:Nn\ocgxii_ocmd_make_equiv_ve:nN{
+  \int_zero:N\l_ocgxii_ve_cnt_int
+  \tl_clear_new:N#2
+  \clist_map_inline:nn{#1}{\ocgxii_omcd_convert_vp:nN{##1}#2}
+}
+\cs_new_protected_nopar:Nn\ocgxii_omcd_convert_vp:nN{
+  \cs_set_eq:NN\AllOn \ocgxii_vp_check:n
+  \cs_set_eq:NN\AnyOn \ocgxii_vp_check:n
+  \cs_set_eq:NN\AnyOff\ocgxii_vp_check:n
+  \cs_set_eq:NN\AllOff\ocgxii_vp_check:n
+  \cs_set_eq:NN\Not\ocgxii_ve_check:n
+  \cs_set_eq:NN\And\ocgxii_ve_check:n
+  \cs_set_eq:NN\Or \ocgxii_ve_check:n
+  \tl_if_exist:cT{ocgxii_#1}{
+    \str_case_e:nn{\tl_use:c{ocgxii_#1}}{
+      {VisExpr}{
+        \int_incr:N\l_ocgxii_ve_cnt_int
+        \tl_set:Nn#2{#1}
+      }
+      {VisPol}{
+        \int_compare:nNnT{\l_ocgxii_ve_cnt_int}={0}{
+          \cs_set_eq:NN\AllOn \ocgxii_allon_to_ve:n
+          \cs_set_eq:NN\AnyOn \ocgxii_anyon_to_ve:n
+          \cs_set_eq:NN\AnyOff\ocgxii_anyoff_to_ve:n
+          \cs_set_eq:NN\AllOff\ocgxii_alloff_to_ve:n
+          \tl_set:No#2{#1}
+        }
+      }
+    }
+  }
+}
+\cs_new_protected_nopar:Nn\ocgxii_allon_to_ve:n{\And{#1}}
+\cs_new_protected_nopar:Nn\ocgxii_anyon_to_ve:n{\Or{#1}}
+\cs_new_protected_nopar:Nn\ocgxii_anyoff_to_ve:n{\Not{\And{#1}}}
+\cs_new_protected_nopar:Nn\ocgxii_alloff_to_ve:n{\Not{\Or{#1}}}
+% visib. boolean expressions
+\cs_new_protected_nopar:Nn\ocgxii_ve_and:nN{
+  \bool_set_true:N\l_ocgxii_ve_open_bool
+  \tl_put_right:Nx#2{\g_ocgxii_left_bracket_tl/And}
+  \clist_map_inline:nn{#1}{\ocgxii_ocmd_expression_parser:nN{##1}#2}
+  \tl_put_right:Nx#2{\g_ocgxii_right_bracket_tl}
+  \bool_set_false:N\l_ocgxii_ve_open_bool
+}
+\cs_new_protected_nopar:Nn\ocgxii_ve_or:nN{
+  \bool_set_true:N\l_ocgxii_ve_open_bool
+  \tl_put_right:Nx#2{\g_ocgxii_left_bracket_tl/Or}
+  \clist_map_inline:nn{#1}{\ocgxii_ocmd_expression_parser:nN{##1}#2}
+  \tl_put_right:Nx#2{\g_ocgxii_right_bracket_tl}
+  \bool_set_false:N\l_ocgxii_ve_open_bool
+}
+\cs_new_protected_nopar:Nn\ocgxii_ve_not:nN{
+  \bool_set_true:N\l_ocgxii_ve_open_bool
+  % only one item allowed in \Not{...} argument
+  \int_compare:nNnT{\clist_count:n{#1}}>{\c_one_int}{
+    \msg_error:nnnn{ocgx2}{generic~msg}{
+      More~than~one~item~passed~to~\Not{...}.
+    }{
+      Only~one~item~is~allowed.
+    }
+  }
+  \int_compare:nNnT{\clist_count:n{#1}}={\c_one_int}{
+    \tl_put_right:Nx#2{\g_ocgxii_left_bracket_tl/Not}
+    \clist_map_inline:nn{#1}{\ocgxii_ocmd_expression_parser:nN{##1}#2}
+    \tl_put_right:Nx#2{\g_ocgxii_right_bracket_tl}
+  }
+  \bool_set_false:N\l_ocgxii_ve_open_bool
+}
+\cs_new_protected_nopar:Nn\ocgxii_ve_check:n{VisExpr}
+\tl_set:cn{ocgxii_VisExpr}{VisExpr}
+\cs_new_protected_nopar:Nn\ocgxii_vp_check:n{VisPol}
+\tl_set:cn{ocgxii_VisPol}{VisPol}
+\tl_set:Nx\g_ocgxii_left_bracket_tl{\tl_to_str:N[}
+\tl_set:Nx\g_ocgxii_right_bracket_tl{\tl_to_str:N]}
+\int_new:N\l_ocgxii_vp_cnt_int %number of visib. policies
+\int_new:N\l_ocgxii_ve_cnt_int %number of visib. expressions
+\bool_new:N\l_ocgxii_vp_open_bool %for nesting test
+\bool_new:N\l_ocgxii_ve_open_bool %for nesting test
+\tl_set:Nn\g_ocgxii_help_msg_tl{
+  At~most~one~visibility~policy~and,~separated~by~a~comma,~at~most~one~
+  visibility~expression~may~be~passed~as~the~2nd~argument~to~the~`ocmd'~
+  environment.~A~visibility~
+  policy~is~defined~by~one~of~\AllOn{...},~\AnyOn{...},~\AnyOff{...},~
+  \AllOff{...}.~A~visibility~expression~is~a~boolean~expression~built~by~
+  nesting~any~number~of~\And{...},~\Or{...},~\Not{...}~commands.~If~both~are~
+  provided,~the~visibility~expression~takes~precedence~over~the~policy,~but~the~
+  latter~may~be~used~as~fallback~by~non-conforming~PDF~viewers.
+}
+%command that builds /OC entry from open layer stack
+\cs_new_nopar:Nn\ocgxii_make_oc_entry:{
+  \group_begin:
+  \tl_gclear:N\g_ocgxii_oc_entry_tl
+  \tl_clear:N\l_tempa_tl
+  \seq_if_empty:NF\g_ocgbase_open_stack_seq{
+    \seq_clear:N\l_tempa_seq
+    %additional level of braces around indirect PDF objects (needed for dvips)
+    \seq_map_inline:Nn\g_ocgbase_open_stack_seq{
+      \seq_put_right:Nn\l_tempa_seq{{##1}}
+    }
+    \ocgxii_omcd_parse_argument:xN{
+      \exp_not:N\And{\seq_use:Nn\l_tempa_seq{,}}
+    }\l_tempa_tl
+    \tl_gset:Nx\g_ocgxii_oc_entry_tl{/OC~<</Type/OCMD\l_tempa_tl>>}
+  }
+  \group_end:
+}
+%programmer/author command that inserts /OC << >> entry; for use in
+%annotation/xobject dicts, in order to make them layer-aware
+\cs_new_nopar:Nn\ocgxii_insert_oc:{\g_ocgxii_oc_entry_tl}
+\cs_gset_eq:NN\ocgbase_insert_oc:\ocgxii_insert_oc:
+\cs_gset_eq:NN\ocgbase@insert@oc\ocgxii_insert_oc:
+\tl_new:N\g_ocgxii_oc_entry_tl
+
+\cs_new_protected_nopar:Nn\ocgxii_stack_shipout:NN{
+  \iow_shipout_x:Nx\@mainaux{
+    \token_to_str:N#1{
+      \exp_not:N\int_use:N\g_ocgxii_page_int
+    }{\seq_use:Nn#2{,}}
+  }
+}
+
+\cs_new_protected_nopar:Npn\ocgxii@ocg@stack@on@page#1#2{
+  \seq_gset_from_clist:cn{g_pending_ocgs_on_#1_seq}{#2}
+  %re-add braces around items for dvips
+  \bool_if:nT{\sys_if_output_dvi_p: && !\g_ocgxii_dvipdfmx_bool}{
+    \seq_map_inline:cn{g_pending_ocgs_on_#1_seq}{
+      \seq_gpop_left:cN{g_pending_ocgs_on_#1_seq}\l_trash_tl
+      \seq_gput_right:cn{g_pending_ocgs_on_#1_seq}{{##1}}
+    }
+  }
+}
+\ocgxii@ocg@stack@on@page{0}{} %initialize
+
+\cs_new_protected_nopar:Npn\ocgxii@lnkcol@stack@on@page#1#2{
+  \seq_gset_from_clist:cn{g_pending_lnkcols_on_#1_seq}{#2}
+}
+\ocgxii@lnkcol@stack@on@page{0}{} %initialize
+
+%end-of-page action
+\pbs_eop_action:n{
+  \seq_if_exist:cT{g_pending_lnkcols_on_\int_use:c{g_ocgxii_page_int}_seq}{
+    %check whether end-of-page link colour stack has settled
+    \iow_shipout:Nx\@mainaux{
+      \token_to_str:N\ocgxii@newkey{ocgx2.oldlnkcol.\int_use:N\g_ocgxii_page_int}{
+        \seq_use:cn{g_pending_lnkcols_on_\int_use:c{g_ocgxii_page_int}_seq}{,}
+      }
+    }
+    \bool_if:nT{
+      !\cs_if_exist:cTF{ocgx2.oldlnkcol.\int_use:N\g_ocgxii_page_int}{
+        \str_if_eq_p:ee{
+          \tl_use:c{ocgx2.oldlnkcol.\int_use:N\g_ocgxii_page_int}
+        }{
+          \seq_use:cn{g_pending_lnkcols_on_\int_use:c{g_ocgxii_page_int}_seq}{,}
+        }
+      }{
+        \c_false_bool
+      }
+    }{
+      \tl_if_exist:NF\g_ocgxii_rerunwarned_tl{
+        \tl_new:N\g_ocgxii_rerunwarned_tl
+        \AtEndDocument{\msg_warning:nn{ocgx2}{rerun}}
+      }
+    }
+    % now close the colourlink opened last
+    \seq_get:cNT{g_pending_lnkcols_on_\int_use:c{g_ocgxii_page_int}_seq}\l_tmpa_tl{
+      \tl_gset_eq:NN\g_ocgxii_lnkcol_tl\l_tmpa_tl
+      \ocgxii_colourlink_end:
+    }
+  }
+  %check whether end-of-page ocg stack has settled
+  \iow_shipout:Nx\@mainaux{
+    \token_to_str:N\ocgxii@newkey{ocgx2.oldstack.\int_use:N\g_ocgxii_page_int}{
+      \seq_use:cn{g_pending_ocgs_on_\int_use:c{g_ocgxii_page_int}_seq}{,}
+    }
+  }
+  \bool_if:nT{
+    !\cs_if_exist:cTF{ocgx2.oldstack.\int_use:N\g_ocgxii_page_int}{
+      \str_if_eq_p:ee{
+        \tl_use:c{ocgx2.oldstack.\int_use:N\g_ocgxii_page_int}
+      }{
+        \seq_use:cn{g_pending_ocgs_on_\int_use:c{g_ocgxii_page_int}_seq}{,}
+      }
+    }{
+      \c_false_bool
+    }
+  }{
+    \tl_if_exist:NF\g_ocgxii_rerunwarned_tl{
+      \tl_new:N\g_ocgxii_rerunwarned_tl
+      \AtEndDocument{\msg_warning:nn{ocgx2}{rerun}}
+    }
+  }
+  %now close pending ocgs
+  \seq_map_variable:cNn{
+    g_pending_ocgs_on_\int_use:c{g_ocgxii_page_int}_seq
+  }\l_tmpb_tl{\ocgbase_oc_emc:}
+}
+
+%begin-of-page action
+\pbs_bop_action:n{
+  % re-open all pending ocgs in original order
+  \seq_set_eq:Nc\l_ocgxii_pending_ocgs_seq{
+    g_pending_ocgs_on_\int_use:c{g_ocgxii_page_int}_seq
+  }
+  \seq_reverse:N\l_ocgxii_pending_ocgs_seq
+  \seq_map_variable:NNn\l_ocgxii_pending_ocgs_seq\l_tmpa_tl{
+    \ocgbase_oc_bdc:n{\l_tmpa_tl}
+  }
+  % re-open the colourlink opened last
+  \seq_get:cNT{g_pending_lnkcols_on_\int_use:c{g_ocgxii_page_int}_seq}\l_tmpa_tl{
+    \tl_gset_eq:NN\g_ocgxii_lnkcol_tl\l_tmpa_tl
+    \ocgxii_colourlink_begin:
+  }
+  \int_gincr:N\g_ocgxii_page_int
+  % copy pending ocg stack from previous page, if it has not been initialized
+  % yet from aux file
+  \seq_if_exist:cF{g_pending_ocgs_on_\int_use:c{g_ocgxii_page_int}_seq}{
+    \seq_gset_eq:cc{
+      g_pending_ocgs_on_\int_use:c{g_ocgxii_page_int}_seq
+    }{
+      g_pending_ocgs_on_\int_eval:n{\g_ocgxii_page_int-\c_one_int}_seq
+    }
+  }
+  %the same for link colour stack
+  \seq_if_exist:cF{g_pending_lnkcols_on_\int_use:c{g_ocgxii_page_int}_seq}{
+    \seq_gset_eq:cc{
+      g_pending_lnkcols_on_\int_use:c{g_ocgxii_page_int}_seq
+    }{
+      g_pending_lnkcols_on_\int_eval:n{\g_ocgxii_page_int-\c_one_int}_seq
+    }
+  }
+}
+\int_new:N\g_ocgxii_page_int %abs. page counter
+
+\cs_new_protected_nopar:Nn\ocgxii_ocglist_reset:{
+  \tl_clear_new:N\l_ocgxii_u_list_tl
+  \tl_clear_new:N\l_ocgxii_d_list_tl
+  \tl_clear_new:N\l_ocgxii_e_list_tl
+  \tl_clear_new:N\l_ocgxii_x_list_tl
+}
+
+\cs_new_protected_nopar:Nn\ocgxii_ocglist_build:Nn{
+  \tl_set:Nx\l_ocglistarg_tl{#2}\tl_trim_spaces:N\l_ocglistarg_tl
+  % first try splitting at commas (ocgx2 syntax)
+  \tl_set_eq:NN\l_tmpa_tl\l_ocglistarg_tl
+  \tl_remove_all:Nn\l_tmpa_tl{~}
+  \seq_set_split:NnV\l_ocgxii_ocglistarg_seq{,}\l_tmpa_tl
+  \seq_remove_all:Nn\l_ocgxii_ocglistarg_seq{}
+  \tl_set:Nx\l_tmpa_tl{\seq_count:N\l_ocgxii_ocglistarg_seq}
+  % now at spaces (legacy ocgx/ocg-p)
+  \tl_set_eq:NN\l_tmpb_tl\l_ocglistarg_tl
+  \tl_remove_all:Nn\l_tmpb_tl{,}
+  \seq_set_split:NnV\l_tmpb_seq{~}\l_tmpb_tl
+  \seq_remove_all:Nn\l_tmpb_seq{}
+  \tl_set:Nx\l_tmpb_tl{\seq_count:N\l_tmpb_seq}
+  %take the seq having more elements (guessing the separator most likely used)
+  \int_compare:nT{\l_tmpb_tl>\l_tmpa_tl}{
+    \seq_set_eq:NN\l_ocgxii_ocglistarg_seq\l_tmpb_seq
+  }
+  \seq_map_variable:NNn\l_ocgxii_ocglistarg_seq\l_tempa_tl{
+    \ocgxii_process_ocgref:NN#1\l_tempa_tl
+  }
+}
+
+\cs_new_protected:Nn\ocgxii_commalist_process:n{
+  \seq_set_split:Nnn\l_tmpa_seq{,}{#1}
+  \ocgxii_ocglist_build:Nn\l_ocgxii_e_list_tl{\seq_item:Nn\l_tmpa_seq{1}}
+  \ocgxii_ocglist_build:Nn\l_ocgxii_x_list_tl{\seq_item:Nn\l_tmpa_seq{2}}
+  \ocgxii_ocglist_build:Nn\l_ocgxii_d_list_tl{\seq_item:Nn\l_tmpa_seq{3}}
+  \ocgxii_ocglist_build:Nn\l_ocgxii_u_list_tl{\seq_item:Nn\l_tmpa_seq{4}}
+}
+
+\cs_new_protected_nopar:Nn\ocgxii_ocglist_process_idlist:nn{
+  \ocgxii_ocglist_reset:
+  \tl_set:Nx\l_ocgxii_opt_tl{#1}\tl_remove_all:Nn\l_ocgxii_opt_tl{~}
+  \str_case_e:nnF{\l_ocgxii_opt_tl}{
+    {onmouseup}{
+      \ocgxii_ocglist_build:Nn\l_ocgxii_u_list_tl{#2}
+    }
+    {onmousedown}{
+      \ocgxii_ocglist_build:Nn\l_ocgxii_d_list_tl{#2}
+    }
+    {onmouseenter}{
+      \ocgxii_ocglist_build:Nn\l_ocgxii_e_list_tl{#2}
+    }
+    {onmouseexit}{
+      \ocgxii_ocglist_build:Nn\l_ocgxii_x_list_tl{#2}
+    }
+    {onmouseall}{
+      \ocgxii_commalist_process:n{#2}
+    }
+  }{
+    \msg_error:nnx{ocgx2}{unknown~option}{\l_ocgxii_opt_tl}
+  }
+}
+
+\int_new:N\g_ocgxii_widcount_int% widget counter
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% re-implement commands from ocgx.sty (all engines including ps2pdf [gs>=9.15])
+% adding optional `*' (arg 1) -> non-breakable link instead of plain (multiline)
+% Link;
+% adding optional 2nd argument -> Button Widget (non-breakable) with one of
+% various mouse triggers (`troggerocgs` option from ocg-p)
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\DeclareDocumentCommand\switchocg{s O{} m +m}{
+  \ocgxii_actionsocg:nnnnnn{#1}{#2}{#3}{}{}{#4}
+}
+
+\DeclareDocumentCommand\showocg{s O{} m +m}{
+  \ocgxii_actionsocg:nnnnnn{#1}{#2}{}{#3}{}{#4}
+}
+
+\DeclareDocumentCommand\hideocg{s O{} m +m}{
+  \ocgxii_actionsocg:nnnnnn{#1}{#2}{}{}{#3}{#4}
+}
+
+\DeclareDocumentCommand\actionsocg{s O{} m m m +m}{
+  \ocgxii_actionsocg:nnnnnn{#1}{#2}{#3}{#4}{#5}{#6}
+}
+
+\bool_new:N\l_ocgxii_mouse_triggers_bool
+\bool_new:N\l_ocgxii_nobreak_bool
+\cs_new_protected:Nn\ocgxii_actionsocg:nnnnnn{
+  \group_begin:
+  \mode_leave_vertical:
+  \bool_set_false:N\l_ocgxii_mouse_triggers_bool
+  \bool_set_false:N\l_ocgxii_nobreak_bool
+  % explicitly non-breakable?
+  \bool_if:nT{#1}{\bool_set_true:N\l_ocgxii_nobreak_bool}
+  %
+  %clear actions for various mouse triggers (e,d,x)
+  \tl_clear:N\l_ocgxii_toswitch_e_tl
+  \tl_clear:N\l_ocgxii_toswitch_x_tl
+  \tl_clear:N\l_ocgxii_toswitch_d_tl
+  \tl_clear:N\l_ocgxii_toshow_e_tl
+  \tl_clear:N\l_ocgxii_toshow_x_tl
+  \tl_clear:N\l_ocgxii_toshow_d_tl
+  \tl_clear:N\l_ocgxii_tohide_e_tl
+  \tl_clear:N\l_ocgxii_tohide_x_tl
+  \tl_clear:N\l_ocgxii_tohide_d_tl
+  %
+  %process *all* mouse triggers (e,d,u,x)
+  \ocgxii_ocglist_process_idlist:nn{
+    \tl_if_blank:oTF{#2}{onmouseup}{#2}
+  }{#3}
+  \tl_set_eq:NN\l_ocgxii_toswitch_e_tl\l_ocgxii_e_list_tl
+  \tl_set_eq:NN\l_ocgxii_toswitch_x_tl\l_ocgxii_x_list_tl
+  \tl_set_eq:NN\l_ocgxii_toswitch_d_tl\l_ocgxii_d_list_tl
+  \tl_set_eq:NN\l_ocgxii_toswitch_u_tl\l_ocgxii_u_list_tl
+  \ocgxii_ocglist_process_idlist:nn{
+    \tl_if_blank:oTF{#2}{onmouseup}{#2}
+  }{#4}
+  \tl_set_eq:NN\l_ocgxii_toshow_e_tl\l_ocgxii_e_list_tl
+  \tl_set_eq:NN\l_ocgxii_toshow_x_tl\l_ocgxii_x_list_tl
+  \tl_set_eq:NN\l_ocgxii_toshow_d_tl\l_ocgxii_d_list_tl
+  \tl_set_eq:NN\l_ocgxii_toshow_u_tl\l_ocgxii_u_list_tl
+  \ocgxii_ocglist_process_idlist:nn{
+    \tl_if_blank:oTF{#2}{onmouseup}{#2}
+  }{#5}
+  \tl_set_eq:NN\l_ocgxii_tohide_e_tl\l_ocgxii_e_list_tl
+  \tl_set_eq:NN\l_ocgxii_tohide_x_tl\l_ocgxii_x_list_tl
+  \tl_set_eq:NN\l_ocgxii_tohide_d_tl\l_ocgxii_d_list_tl
+  \tl_set_eq:NN\l_ocgxii_tohide_u_tl\l_ocgxii_u_list_tl
+  %any triggers apart from mouse-up?
+  \str_if_eq:eeF{
+    \l_ocgxii_toswitch_e_tl\l_ocgxii_toswitch_x_tl\l_ocgxii_toswitch_d_tl
+    \l_ocgxii_toshow_e_tl\l_ocgxii_toshow_x_tl\l_ocgxii_toshow_d_tl
+    \l_ocgxii_tohide_e_tl\l_ocgxii_tohide_x_tl\l_ocgxii_tohide_d_tl
+  }{}{
+    \bool_set_true:N\l_ocgxii_mouse_triggers_bool
+  }
+  %
+  \bool_if:nTF{\l_ocgxii_nobreak_bool || \l_ocgxii_mouse_triggers_bool}{
+    \hbox_set:Nn\l_tmpa_box{#6}
+    \bool_if:NTF\l_ocgxii_mouse_triggers_bool{
+      % e,d,x mouse triggers require (non-breakable) /Widget annot
+      \pdfannot_dict_put:nnn{link/GoTo}{Subtype}{/Widget}
+      \pdfannot_dict_remove:nn{link/GoTo}{Border}
+    }{
+      \pdfannot_dict_put:nnn{link/GoTo}{Border}{[0~0~0]}
+    }
+    \pdfannot_dict_remove:nn{link/GoTo}{C}
+    \pbs_pdfannot:nnnn{
+      \dim_use:N\box_wd:N\l_tmpa_box}{
+      \dim_use:N\box_ht:N\l_tmpa_box}{
+      \dim_use:N\box_dp:N\l_tmpa_box
+    }{
+      \pdfannot_dict_use:n{link/GoTo}
+      \bool_if:NTF\l_ocgxii_mouse_triggers_bool{
+        /Ff~65536/FT/Btn/BS<</W~0>>
+        /T~(ocgx2@\int_use:N\g_ocgxii_widcount_int)
+        %treat mouse-up as mouse-click --> handle through /A dictionary
+        \str_if_eq:eeF{}{
+          \l_ocgxii_toswitch_u_tl\l_ocgxii_toshow_u_tl\l_ocgxii_tohide_u_tl
+        }{
+          /A <</S/SetOCGState/State [
+            \str_if_eq:VnF\l_ocgxii_toswitch_u_tl{}{
+              /Toggle~\l_ocgxii_toswitch_u_tl
+            }
+            \str_if_eq:VnF\l_ocgxii_toshow_u_tl{}{
+              /ON~\l_ocgxii_toshow_u_tl
+            }
+            \str_if_eq:VnF\l_ocgxii_tohide_u_tl{}{
+              /OFF~\l_ocgxii_tohide_u_tl
+            }
+          ]>>
+        }
+        % other mouse triggers need add. actions dict
+        /AA <<
+          %\str_if_eq:eeF{}{ % mouse-up
+          %  \l_ocgxii_toswitch_u_tl\l_ocgxii_toshow_u_tl\l_ocgxii_tohide_u_tl
+          %}{
+          %  /U <</S/SetOCGState/State [
+          %    \str_if_eq:VnF\l_ocgxii_toswitch_u_tl{}{
+          %      /Toggle~\l_ocgxii_toswitch_u_tl
+          %    }
+          %    \str_if_eq:VnF\l_ocgxii_toshow_u_tl{}{
+          %      /ON~\l_ocgxii_toshow_u_tl
+          %    }
+          %    \str_if_eq:VnF\l_ocgxii_tohide_u_tl{}{
+          %      /OFF~\l_ocgxii_tohide_u_tl
+          %    }
+          %  ]>>
+          %}
+          \str_if_eq:eeF{}{ % mouse-down
+            \l_ocgxii_toswitch_d_tl\l_ocgxii_toshow_d_tl\l_ocgxii_tohide_d_tl
+          }{
+            /D <</S/SetOCGState/State [
+              \str_if_eq:VnF\l_ocgxii_toswitch_d_tl{}{
+                /Toggle~\l_ocgxii_toswitch_d_tl
+              }
+              \str_if_eq:VnF\l_ocgxii_toshow_d_tl{}{
+                /ON~\l_ocgxii_toshow_d_tl
+              }
+              \str_if_eq:VnF\l_ocgxii_tohide_d_tl{}{
+                /OFF~\l_ocgxii_tohide_d_tl
+              }
+            ]>>
+          }
+          \str_if_eq:eeF{}{ % mouse-enter
+            \l_ocgxii_toswitch_e_tl\l_ocgxii_toshow_e_tl\l_ocgxii_tohide_e_tl
+          }{
+            /E <</S/SetOCGState/State [
+              \str_if_eq:VnF\l_ocgxii_toswitch_e_tl{}{
+                /Toggle~\l_ocgxii_toswitch_e_tl
+              }
+              \str_if_eq:VnF\l_ocgxii_toshow_e_tl{}{
+                /ON~\l_ocgxii_toshow_e_tl
+              }
+              \str_if_eq:VnF\l_ocgxii_tohide_e_tl{}{
+                /OFF~\l_ocgxii_tohide_e_tl
+              }
+            ]>>
+          }
+          \str_if_eq:eeF{}{ % mouse-exit
+            \l_ocgxii_toswitch_x_tl\l_ocgxii_toshow_x_tl\l_ocgxii_tohide_x_tl
+          }{
+            /X <</S/SetOCGState/State [
+              \str_if_eq:VnF\l_ocgxii_toswitch_x_tl{}{
+                /Toggle~\l_ocgxii_toswitch_x_tl
+              }
+              \str_if_eq:VnF\l_ocgxii_toshow_x_tl{}{
+                /ON~\l_ocgxii_toshow_x_tl
+              }
+              \str_if_eq:VnF\l_ocgxii_tohide_x_tl{}{
+                /OFF~\l_ocgxii_tohide_x_tl
+              }
+            ]>>
+          }
+        >>
+      }{
+        %mouse-up alone
+        /A <</S/SetOCGState
+          /State [
+            \str_if_eq:VnF{\l_ocgxii_toswitch_u_tl}{}{
+              /Toggle~\l_ocgxii_toswitch_u_tl}~
+            \str_if_eq:VnF{\l_ocgxii_toshow_u_tl}{}{/ON~\l_ocgxii_toshow_u_tl}~
+            \str_if_eq:VnF{\l_ocgxii_tohide_u_tl}{}{/OFF~\l_ocgxii_tohide_u_tl}
+          ]
+        >>
+      }
+    }\box_use_drop:N\l_tmpa_box
+    \bool_if:NT\l_ocgxii_mouse_triggers_bool{
+      \pbs_appendtofields:n{\pbs_pdflastann:}
+      \int_gincr:N\g_ocgxii_widcount_int
+    }
+  }{
+    %line-breakable annotation
+    \pbs_pdflink:nn{
+      %look and feel of hyperref internal links
+      \pdfannot_dict_use:n{link/GoTo}
+      /A <</S/SetOCGState
+        /State [
+          \str_if_eq:VnF{\l_ocgxii_toswitch_u_tl}{}{
+            /Toggle~\l_ocgxii_toswitch_u_tl}~
+          \str_if_eq:VnF{\l_ocgxii_toshow_u_tl}{}{/ON~\l_ocgxii_toshow_u_tl}~
+          \str_if_eq:VnF{\l_ocgxii_tohide_u_tl}{}{/OFF~\l_ocgxii_tohide_u_tl}
+        ]
+      >>
+    }{
+      \hook_use:n{pdfannot/link/GoTo/begin}
+      #6
+      \hook_use:n{pdfannot/link/GoTo/end}
+    }
+  }
+  \group_end:
+}
+
+%mimic commands from ocg-p
+\keys_define:nn{ocgx2/ocgpcmd}{
+  triggerocg .choices:nn = {
+    onmouseenter, onmouseexit, onmousedown, onmouseup, allactions
+  }{
+    \str_if_eq:eeTF{\l_keys_choice_tl}{allactions}{
+      \tl_set:Nn\l_ocgxii_trigger_tl{onmouseall}
+    }{
+      \tl_set_eq:NN\l_ocgxii_trigger_tl\l_keys_choice_tl
+    }
+  }
+}
+\DeclareDocumentCommand\toggleocgs{O{} m +m}{
+  \tl_clear_new:N\l_ocgxii_trigger_tl
+  \keys_set:nn{ocgx2/ocgpcmd}{#1}
+  \switchocg*[\l_ocgxii_trigger_tl]{#2}{#3}
+}
+\DeclareDocumentCommand\showocgs{O{} m +m}{
+  \tl_clear_new:N\l_ocgxii_trigger_tl
+  \keys_set:nn{ocgx2/ocgpcmd}{#1}
+  \showocg*[\l_ocgxii_trigger_tl]{#2}{#3}
+}
+\DeclareDocumentCommand\hideocgs{O{} m +m}{
+  \tl_clear_new:N\l_ocgxii_trigger_tl
+  \keys_set:nn{ocgx2/ocgpcmd}{#1}
+  \hideocg*[\l_ocgxii_trigger_tl]{#2}{#3}
+}
+\DeclareDocumentCommand\setocgs{O{} m m m +m}{
+  \tl_clear_new:N\l_ocgxii_trigger_tl
+  \keys_set:nn{ocgx2/ocgpcmd}{#1}
+  \actionsocg*[\l_ocgxii_trigger_tl]{#2}{#3}{#4}{#5}
+}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\cs_new_protected:Nn\ocgxii_process_ocgref:NN{
+  \tl_if_exist:cTF{ocgx2.ocg.#2}{
+    \tl_put_right:Nx#1{~\tl_use:c{ocgx2.ocg.#2}}
+  }{
+    \msg_warning:nnx{ocgx2}{undefined~OCG}{#2}
+    \tl_if_exist:NF\g_ocgxii_refundefwarned_tl{
+      \tl_new:N\g_ocgxii_refundefwarned_tl
+      \AtEndDocument{\msg_warning:nn{ocgx2}{undefined~OCGs}}
+    }
+  }
+}
+
+%ocg environment opts
+\keys_define:nn{ocgx2/ocgenv}{
+  viewocg .choice:,
+  viewocg / always .code:n={
+    \tl_set:Nn\l_ocgxii_view_tl{/View<</ViewState/ON>>}},
+  viewocg / never .code:n={
+    \tl_set:Nn\l_ocgxii_view_tl{/View<</ViewState/OFF>>}},
+  viewocg / ifvisible .code:n={
+    \tl_clear:N\l_ocgxii_view_tl},
+  viewocg .default:n={ifvisible},
+
+  printocg .choice:,
+  printocg / always .code:n={
+    \tl_set:Nn\l_ocgxii_print_tl{/Print<</PrintState/ON>>}},
+  printocg / never .code:n={
+    \tl_set:Nn\l_ocgxii_print_tl{/Print<</PrintState/OFF>>}},
+  printocg / ifvisible .code:n={
+    \tl_clear:N\l_ocgxii_print_tl},
+  printocg .default:n={ifvisible},
+
+  exportocg .choice:,
+  exportocg / always .code:n={
+    \tl_set:Nn\l_ocgxii_export_tl{/Export<</ExportState/ON>>}},
+  exportocg / never .code:n={
+    \tl_set:Nn\l_ocgxii_export_tl{/Export<</ExportState/OFF>>}},
+  exportocg / ifvisible .code:n={\tl_clear:N\l_ocgxii_export_tl},
+  exportocg .default:n={ifvisible},
+
+  showingui .choices:nn = {true,false,always,never,iffirstuse}{
+    \bool_if:nTF{
+      \str_if_eq_p:ee{#1}{false} ||
+      \str_if_eq_p:ee{#1}{never}
+    }{
+      \bool_set_false:N\l_ocgxii_showingui_bool
+    }{
+      \bool_set_true:N\l_ocgxii_showingui_bool
+    }
+  },
+  showingui .default:n={true},
+
+  listintoolbar .meta:n = {showingui=#1},
+  listintoolbar .default:n={true},
+
+  radiobtngrps .code:n = {
+    \clist_map_inline:nn{#1}{
+      \seq_if_in:NxF\l_ocgxii_rbgrps_seq{##1}{
+        \seq_put_right:Nx\l_ocgxii_rbgrps_seq{##1}
+      }
+    }
+  },
+  radiobtngrps .value_required:n = {true},
+  radiobtngrp .meta:n={radiobtngrps={#1}},
+  radiobtngrp .value_required:n = {true}
+}
+
+\cs_new_protected:Nn\ocgxii_reset_cmd_opts:{
+  \tl_set_eq:NN\l_ocgxii_view_tl\g_ocgxii_view_tl
+  \tl_set_eq:NN\l_ocgxii_print_tl\g_ocgxii_print_tl
+  \tl_set_eq:NN\l_ocgxii_export_tl\g_ocgxii_export_tl
+  \bool_set_eq:NN\l_ocgxii_showingui_bool\g_ocgxii_showingui_bool
+  %stack of radio button group names the current ocg belongs to
+  \seq_clear_new:N\l_ocgxii_rbgrps_seq
+}
+
+\msg_set:nnn{ocgx2}{rerun}{Rerun~to~get~OCG~references~right!}
+\msg_set:nnn{ocgx2}{undefined~OCG}{
+  Line~\msg_line_number: :~OCG~`#1'~is~not~defined.
+}
+\msg_set:nnn{ocgx2}{undefined~OCGs}{There~were~undefined~OCGs!}
+\msg_set:nnn{ocgx2}{unknown~option}{
+  Line~\msg_line_number: :~unknown~option~`#1'.
+}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% allows `ocgcolorlinks' to extend over line-breaks AND page-breaks with
+% pdftex, luatex, xetex, dvipdfmx drivers
+%
+% based on Ben Lerner's idea
+%   http://tex.stackexchange.com/a/104227;
+% with some improvements
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\bool_if:NT\l_ocgxii_ocgcolorlinks_bool{
+  % option ocgcolorlinks and beamer are not compatible
+  \@ifclassloaded{beamer}{
+    \bool_set_false:N\l_ocgxii_ocgcolorlinks_bool
+    \hypersetup{colorlinks}
+    \msg_warning:nn{ocgx2}{beamer~and~ocgcolorlinks}
+  }{}
+  % make sure that hyperref has been loaded if `ocgcolorlinks' is set via
+  % pkg option
+  \@ifpackageloaded{hyperref}{
+    \hypersetup{ocgcolorlinks}
+  }{
+    \msg_error:nnn{ocgx2}{missing~package}{hyperref}
+  }
+}
+
+% we'll be using the downscaled space character (32) from the pzdr
+% (dingbats) font at the start and at the end of every ocgcolorlink
+\cs_new_nopar:Npn\ocgxii_tiny_space_char:{
+  \group_begin: \font\l_tmpa_tl=pzdr~scaled~1\l_tmpa_tl\char32 \group_end:
+}
+
+\@ifpackageloaded{hyperref}{
+  \bool_if:nTF{\sys_if_output_dvi_p: && !\g_ocgxii_dvipdfmx_bool}{
+    \prop_map_inline:Nn\c__hyp_map_hyp_annot_prop{
+      \hook_gremove_code:nn{pdfannot/link/#2/begin}{hyp/ocg}
+      \hook_gput_code:nnn{pdfannot/link/#2/begin}{hyp/ocg}{
+        \bool_if:cT{l_hyp_annot_ocgcolor#1_bool}{
+          \ocgxii_colorlinks_init:
+          \group_begin:
+          \color_export:nnN{hyp/color/#1}{backend}\l_tempb_tl
+          \tl_set:Nx\l_tempa_tl{\tl_item:Nn\l_tempb_tl{1}}
+          \tl_set:Nx\l_tempb_tl{\tl_item:Nn\l_tempb_tl{2}}
+          \str_replace_all:Nnn\l_tempb_tl{~}{,}
+          \tl_set:Nx\l_ocgxii_lnkcol_tl{{\l_tempa_tl}{\l_tempb_tl}}
+          \ocgxii_colourlink_nobreak_begin:
+        }
+      }
+      \hook_gremove_code:nn{pdfannot/link/#2/end}{hyp/ocg}
+      \hook_gput_code:nnn{pdfannot/link/#2/end}{hyp/ocg}{
+        \bool_if:cT{l_hyp_annot_ocgcolor#1_bool}{
+          \ocgxii_colourlink_nobreak_end:
+          \group_end:
+        }
+      }
+    }
+  }{
+    \prop_map_inline:Nn\c__hyp_map_hyp_annot_prop{
+      \hook_gremove_code:nn{pdfannot/link/#2/begin}{hyp/ocg}
+      \hook_gput_code:nnn{pdfannot/link/#2/begin}{hyp/ocg}{
+        \bool_if:cT{l_hyp_annot_ocgcolor#1_bool}{
+          \ocgxii_colorlinks_init:
+          \seq_get_left:NNT\g_ocgxii_lnk_color_seq\l_tmpa_tl{
+            \tl_gset_eq:NN\g_ocgxii_lnkcol_tl\l_tmpa_tl
+            \ocgxii_colourlink_end:
+          }
+          \group_begin:
+          \ocgxii_colourlink_begin:
+          %query current link colour, export it into backend format
+          %and put it on the link colour stack
+          \color_export:nnN{hyp/color/#1}{backend}\l_tempb_tl
+          \tl_set:Nx\l_tempa_tl{\tl_item:Nn\l_tempb_tl{1}} % model
+          \tl_set:Nx\l_tempb_tl{\tl_item:Nn\l_tempb_tl{2}} % components
+          \str_replace_all:Nnn\l_tempb_tl{~}{,}
+          \seq_gpush:Nx\g_ocgxii_lnk_color_seq{{\l_tempa_tl}{\l_tempb_tl}}
+          \ocgxii_stack_shipout:NN\ocgxii@lnkcol@stack@on@page\g_ocgxii_lnk_color_seq
+        }
+      }
+      \hook_gremove_code:nn{pdfannot/link/#2/end}{hyp/ocg}
+      \hook_gput_code:nnn{pdfannot/link/#2/end}{hyp/ocg}{
+        \bool_if:cT{l_hyp_annot_ocgcolor#1_bool}{
+          \seq_gpop:NN\g_ocgxii_lnk_color_seq\l_tmpa_tl
+          \tl_gset_eq:NN\g_ocgxii_lnkcol_tl\l_tmpa_tl
+          \ocgxii_stack_shipout:NN\ocgxii@lnkcol@stack@on@page\g_ocgxii_lnk_color_seq
+          \ocgxii_colourlink_end:
+          \group_end:
+          \seq_get_left:NNT\g_ocgxii_lnk_color_seq\l_tmpa_tl{
+            \tl_gset_eq:NN\g_ocgxii_lnkcol_tl\l_tmpa_tl
+            \ocgxii_colourlink_begin:
+          }
+        }
+      }
+    }
+  }
+}{}
+
+\seq_new:N\g_ocgxii_lnk_color_seq %stack of colours of currently open links
+
+\cs_new_protected_nopar:Nn\ocgxii_colourlink_begin:{
+  %tiny space char put here in order to neutralise possible transformation
+  %matrix modifications from previous \pdfliteral{} (TikZ makes a lot use of it)
+  \hbox_overlap_left:n{\ocgxii_tiny_space_char:}
+  \pbs_literal:nn{page}{q~7~Tr}
+}
+\cs_new_protected_nopar:Nn\ocgxii_colourlink_end:{
+  %a tiny space char should keep empty link annots from flooding the page
+  % with link colour
+  %tiny space char put here in order to neutralise possible transformation
+  \hbox_overlap_left:n{\ocgxii_tiny_space_char:}
+  \ocgbase_oc_bdc:n{\tl_use:c{ocgxii_ocg_OCPrint}}
+    \pbs_literal:nn{page}{-88888~-88888~99999~99999~re~f}
+  \ocgbase_oc_emc:
+  \ocgbase_oc_bdc:n{\tl_use:c{ocgxii_ocg_OCView}}
+    \group_begin:
+      \exp_after:wN\color_select:nn\g_ocgxii_lnkcol_tl
+      \pbs_literal:nn{page}{-88888~-88888~99999~99999~re~f}
+    \group_end:
+  \ocgbase_oc_emc:
+  \pbs_literal:nn{page}{0~Tr~Q}
+}
+
+\cs_new_protected_nopar:Nn\ocgxii_colourlink_nobreak_begin:{
+  \hbox_set:Nw\l_tmpa_box
+}
+\cs_new_protected_nopar:Nn\ocgxii_colourlink_nobreak_end:{
+  \hbox_set_end:
+  \mbox{
+    \ocgbase_oc_bdc:n{\tl_use:c{ocgxii_ocg_OCPrint}}
+    \hbox_overlap_right:n{\box_use:N\l_tmpa_box}
+    \ocgbase_oc_emc:
+    \ocgbase_oc_bdc:n{\tl_use:c{ocgxii_ocg_OCView}}
+    \group_begin:
+      \exp_after:wN\color_select:nn\l_ocgxii_lnkcol_tl
+      \box_use_drop:N\l_tmpa_box
+    \group_end:
+    \ocgbase_oc_emc:
+  }
+}
+
+% creates OCG objects for printing and viewing
+\cs_new_protected:Npn\ocgxii_colorlinks_init:{
+  \ocgbase_new_ocg:nnn{OCView}{
+    /Print<</PrintState/OFF>>
+    /Export<</ExportState/OFF>>
+  }{on}
+  \tl_gset:cx{ocgxii_ocg_OCView}{\ocgbase_last_ocg:}
+  %in case somebody wants to reopen with \begin{ocg}...
+  \tl_gset:cx{ocgxii_ocg_OCView.opts}{
+    showingui=never,printocg=never,exportocg=never
+  }
+  \ocgbase_new_ocg:nnn{OCPrint}{
+    /Print<</PrintState/ON>>
+    /Export<</ExportState/ON>>
+  }{off}
+  \tl_gset:cx{ocgxii_ocg_OCPrint}{\ocgbase_last_ocg:}
+  \tl_gset:cx{ocgxii_ocg_OCPrint.opts}{
+    showingui=never,printocg=always,exportocg=always
+  }
+  \iow_now:Nx\@mainaux{
+    \token_to_str:N\ocgxii@newkey{ocgx2.ocg.OCView}{
+      \tl_use:c{ocgxii_ocg_OCView}}
+  }
+  \iow_now:Nx\@mainaux{
+    \token_to_str:N\ocgxii@newkey{ocgx2.ocg.OCPrint}{
+      \tl_use:c{ocgxii_ocg_OCPrint}}
+  }
+  \cs_gset:Npn\ocgxii_colorlinks_init:{}
+}
+
+% user command for protecting graphical content (external file, inline
+% [e. g. TikZ], \fbox{...}) inside breakable ocgcolorlink
+\DeclareDocumentCommand\ocglinkprotect{m}{
+  \seq_get_left:NNTF\g_ocgxii_lnk_color_seq\l_tmpa_tl{
+    \tl_gset_eq:NN\g_ocgxii_lnkcol_tl\l_tmpa_tl
+    \ocgxii_colourlink_end:
+    \group_begin:
+      \tl_set_eq:NN\l_ocgxii_lnkcol_tl\l_tmpa_tl
+      \ocgxii_colourlink_nobreak_begin:
+        \cs_set_nopar:Npn\ocglinkprotect##1{##1} % in case of nesting
+        \sys_if_output_pdf:TF{
+          \mode_leave_vertical:
+          \hbox_set:Nn\l_tmpb_box{\skip_horizontal:n{1em}#1\skip_horizontal:n{1em}}
+          \box_set_ht:Nn\l_tmpb_box{\box_ht:N\l_tmpb_box+1em}
+          \box_set_dp:Nn\l_tmpb_box{\box_dp:N\l_tmpb_box+1em}
+          \hbox_to_wd:nn{\box_wd:N\l_tmpb_box-2em}{
+            \vrule~
+              width~\c_zero_dim~
+              height~\dim_eval:n{\box_ht:N\l_tmpb_box-1em}~
+              depth~\dim_eval:n{\box_dp:N\l_tmpb_box -1em}~
+            \pbs_pdfxform:nnnnn{1}{0}{}{}{\l_tmpb_box}
+            \skip_horizontal:n{-1em}
+            \pbs_pdfrefxform:n{\pbs_pdflastxform:}
+            \hss
+          }
+        }{#1}
+      \ocgxii_colourlink_nobreak_end:
+    \group_end:
+    \ocgxii_colourlink_begin:
+  }{#1}
+}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+% TikZ related code follows (to be enabled with package option `tikz')
+
+\bool_if:NF\l_ocgxii_tikz_bool{\endinput}
+\cs_set_eq:NN\ocgxii@trmspc\tl_trim_spaces:N
+\ExplSyntaxOff
+\RequirePackage{tikz}
+\usetikzlibrary{calc}
+
+% helper, replaces all spaces in #1 with `_'
+\def\ocgxii@cnvspc#1{\expandafter\ocgxii@@cnvspc#1 \@nil}
+\def\ocgxii@@cnvspc#1 #2\@nil{#1\ifx\@nil#2\@nil\else_\ocgxii@@cnvspc#2\@nil\fi}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Copyright notice: The code that follows until the end of the file was
+% taken in large parts from Paul Gaborit's `tikzlibraryocgx.code.tex' with
+% some additions/fixes:
+%
+%  - opts={...} inside ocg={...} allows ocg-environment options to be passed
+%    to a TikZ scope
+%
+%  - The style ocmd={...} is another way for turning a TikZ scope into a PDF
+%    layer (in addition to ocg={...}). It has two sub-keys, ref={...} and
+%    visibility={...}, which have the same meaning as the optional and the
+%    mandatory arguments of the `ocmd' environment
+%
+%  - TikZ objects to be turned into OCG switching links accept the additional
+%    key
+%
+%      trigger ocg = onmousenter | onmouseexit | onmousedown | onmouseup |
+%                      onmouseall
+%
+%    to react to various mouse gestures
+%
+%  - switching links properly sized and working in scaled tikzpictures
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\tikzset{
+  ocg/.style={ocg/.cd,#1,/tikz/.cd},
+  ocg={
+    % parameters
+    name/.store in=\ocgxii@name,
+    opts/.store in=\ocgxii@opts,
+    visibility/.store in=\ocgxii@visibility,
+    status/.is choice,
+    status/visible/.style={visibility=1},
+    status/invisible/.style={visibility=0},
+    status/true/.style={visibility=1},
+    status/false/.style={visibility=0},
+    status/on/.style={visibility=1},
+    status/off/.style={visibility=0},
+    status/1/.style={visibility=1},
+    status/0/.style={visibility=0},
+    % default values
+    name=,
+    opts=, % NEW
+    status=on,
+    % ref
+    ref/.style={
+      /tikz/execute at begin scope={%
+        \begin{ocg}[\ocgxii@opts]{%
+            \ifx\empty\ocgxii@name\empty#1\else\ocgxii@name\fi%
+        }{#1}{\ocgxii@visibility}},
+      /tikz/execute at end scope={\end{ocg}},
+    }
+  },
+  ocmd/.style={
+    ocmd/.cd,
+    #1,
+    /tikz/execute at begin scope={%
+      \begin{ocmd}[\ocgxii@ocmdref]{\ocgxii@ocmdvisibility}%
+    },
+    /tikz/execute at end scope={\end{ocmd}},
+    /tikz/.cd
+  },
+  ocmd={
+    % parameters
+    ref/.store in=\ocgxii@ocmdref,
+    visibility/.store in=\ocgxii@ocmdvisibility,
+    % default values
+    ref=,
+    visibility=,
+  },
+  trigger ocg/.store in=\ocgxii@trigger,
+  trigger ocg/.value required,
+  switch ocg/.style={
+    postaction={
+      path picture={
+        \path (path picture bounding box.south west) coordinate (p1)
+          (path picture bounding box.north east) coordinate (p2)
+          (p1) node[inner sep=0pt,anchor=south west,outer sep=0pt] {%
+            \ifdefined\ocgxii@trigger%
+              \switchocg*[\ocgxii@trigger]{#1}{%
+                \tikz \useasboundingbox (p1) rectangle (p2);}%
+            \else%
+              \switchocg*{#1}{\tikz \useasboundingbox (p1) rectangle (p2);}%
+            \fi%
+          };
+      }
+    }
+  },
+  switch ocg with mark on/.style 2 args={
+    postaction={
+      path picture={%
+        \edef\ocgxii@argone{#1}%ocg ref for checkmark
+        \ocgxii@trmspc\ocgxii@argone%
+        \global\let\ocgxii@argone\ocgxii@argone%
+        %default ocg ref for checkmark, if nothing provided in #1
+        \xdef\ocgxii@argtwo{#2.mark}%
+        \xdef\ocgxii@argtwo{\ocgxii@cnvspc{\ocgxii@argtwo}}%
+        \begin{ocg}[showingui=false]{%
+          \ifx\ocgxii@argone\@empty\ocgxii@argtwo\else\ocgxii@argone\fi%
+        }{%
+          \ifx\ocgxii@argone\@empty\ocgxii@argtwo\else\ocgxii@argone\fi%
+        }{on}%
+          \draw
+          (path picture bounding box.south west)
+          --
+          (path picture bounding box.north east)
+          (path picture bounding box.south east)
+          --
+          (path picture bounding box.north west)
+          ;
+        \end{ocg}%
+      },
+      switch ocg={%
+        \ifx\ocgxii@argone\@empty\ocgxii@argtwo\else{\ocgxii@argone}\fi\space #2%
+      }
+    }
+  },
+  switch ocg with mark off/.style 2 args={
+    postaction={
+      path picture={%
+        \edef\ocgxii@argone{#1}%ocg ref for checkmark
+        \ocgxii@trmspc\ocgxii@argone%
+        \global\let\ocgxii@argone\ocgxii@argone%
+        %default ocg ref for checkmark, if nothing provided in #1
+        \xdef\ocgxii@argtwo{#2.mark}%
+        \xdef\ocgxii@argtwo{\ocgxii@cnvspc{\ocgxii@argtwo}}%
+        \begin{ocg}[showingui=false]{%
+          \ifx\ocgxii@argone\@empty\ocgxii@argtwo\else\ocgxii@argone\fi%
+        }{%
+          \ifx\ocgxii@argone\@empty\ocgxii@argtwo\else\ocgxii@argone\fi%
+        }{off}%
+          \draw
+          (path picture bounding box.south west)
+          --
+          (path picture bounding box.north east)
+          (path picture bounding box.south east)
+          --
+          (path picture bounding box.north west)
+          ;
+        \end{ocg}%
+      },
+      switch ocg={%
+        \ifx\ocgxii@argone\@empty\ocgxii@argtwo\else{\ocgxii@argone}\fi\space #2%
+      }
+    }
+  },
+  show ocg/.style={
+    postaction={
+      path picture={
+        \path (path picture bounding box.south west) coordinate (p1)
+          (path picture bounding box.north east) coordinate (p2)
+          (p1) node[inner sep=0pt,anchor=south west,outer sep=0pt] {%
+            \ifdefined\ocgxii@trigger%
+              \showocg*[\ocgxii@trigger]{#1}{%
+                \tikz \useasboundingbox (p1) rectangle (p2);}%
+            \else%
+              \showocg*{#1}{\tikz \useasboundingbox (p1) rectangle (p2);}%
+            \fi%
+          };
+      }
+    }
+  },
+  hide ocg/.style={
+    postaction={
+      path picture={
+        \path (path picture bounding box.south west) coordinate (p1)
+          (path picture bounding box.north east) coordinate (p2)
+          (p1) node[inner sep=0pt,anchor=south west,outer sep=0pt] {%
+            \ifdefined\ocgxii@trigger%
+              \hideocg*[\ocgxii@trigger]{#1}{%
+                \tikz \useasboundingbox (p1) rectangle (p2);}%
+            \else%
+              \hideocg*{#1}{\tikz \useasboundingbox (p1) rectangle (p2);}%
+            \fi%
+          };
+      }
+    }
+  },
+  actions ocg/.style n args={3}{
+    postaction={
+      path picture={
+        \path (path picture bounding box.south west) coordinate (p1)
+          (path picture bounding box.north east) coordinate (p2)
+          (p1) node[inner sep=0pt,anchor=south west,outer sep=0pt] {%
+            \ifdefined\ocgxii@trigger%
+              \actionsocg*[\ocgxii@trigger]{#1}{#2}{#3}{%
+                \tikz \useasboundingbox (p1) rectangle (p2);}%
+            \else%
+              \actionsocg*{#1}{#2}{#3}{%
+                \tikz \useasboundingbox (p1) rectangle (p2);}%
+            \fi%
+          };
+      }
+    }
+  }
+}
diff --git a/macros/latex/contrib/tuda-ci/README.md b/macros/latex/contrib/tuda-ci/README.md
index 8e742ec83a..4f60b15476 100644
--- a/macros/latex/contrib/tuda-ci/README.md
+++ b/macros/latex/contrib/tuda-ci/README.md
@@ -2,7 +2,7 @@
 
  Copyright (C) Marei Peischl <marei@peitex.de>, 2018–2021
 
- tuda-ci 2021/05/26 v3.15
+ tuda-ci 2021/06/03 v3.16
 
 ***************************************************************************
 
@@ -278,3 +278,5 @@ leaflets 				| DEMO-TUDaLeaflet.tex							| tudaleaflet.cls
    - add \inst to tudasciposter to support multiple affiliations
    - fix calculation of headwidth with department=mecheng
    - improve documentation on document margins for tudapub and tudapub based examples
+ * v3.16 (2021-06-03)
+   - adjust option expansion due to changes in the LaTeX kernel
diff --git a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaAnnouncement.pdf b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaAnnouncement.pdf
index 9ed4c9d115..61f14277e9 100644
--- a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaAnnouncement.pdf
+++ b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaAnnouncement.pdf
diff --git a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaBeamer.pdf b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaBeamer.pdf
index f611878bb0..c4df254ab5 100644
--- a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaBeamer.pdf
+++ b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaBeamer.pdf
diff --git a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaExercise.pdf b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaExercise.pdf
index dfd41d0890..5e09114100 100644
--- a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaExercise.pdf
+++ b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaExercise.pdf
diff --git a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaLeaflet.pdf b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaLeaflet.pdf
index a06e0c8c74..3d3234ba9c 100644
--- a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaLeaflet.pdf
+++ b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaLeaflet.pdf
diff --git a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaLetter.pdf b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaLetter.pdf
index 1f3e44d832..8c430d1b8c 100644
--- a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaLetter.pdf
+++ b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaLetter.pdf
diff --git a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaPhD.pdf b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaPhD.pdf
index 9950732c8c..e4d778763c 100644
--- a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaPhD.pdf
+++ b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaPhD.pdf
diff --git a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaPoster.pdf b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaPoster.pdf
index 0b93731820..78f66cd986 100644
--- a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaPoster.pdf
+++ b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaPoster.pdf
diff --git a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaPub.pdf b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaPub.pdf
index 6f8bcfa126..4060cb823c 100644
--- a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaPub.pdf
+++ b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaPub.pdf
diff --git a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaReport.pdf b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaReport.pdf
index 9e9cbe1b73..7f832bb6ba 100644
--- a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaReport.pdf
+++ b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaReport.pdf
diff --git a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaSciPoster.pdf b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaSciPoster.pdf
index 458459aa49..2d26814ba1 100644
--- a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaSciPoster.pdf
+++ b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaSciPoster.pdf
diff --git a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaThesis.pdf b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaThesis.pdf
index 294d45f823..9a0f4acd7e 100644
--- a/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaThesis.pdf
+++ b/macros/latex/contrib/tuda-ci/doc/DEMO-TUDaThesis.pdf
diff --git a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaAnnouncement.tex b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaAnnouncement.tex
index 86baadf7d7..a92c09c86a 100644
--- a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaAnnouncement.tex
+++ b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaAnnouncement.tex
@@ -1,4 +1,4 @@
-%% This is file `DEMO-TUDaAnnouncement.tex' version 3.15 (2021/05/26),
+%% This is file `DEMO-TUDaAnnouncement.tex' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaBeamer.tex b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaBeamer.tex
index 0d61d58e71..d41ec09c21 100644
--- a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaBeamer.tex
+++ b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaBeamer.tex
@@ -1,4 +1,4 @@
-%% This is file `DEMO-TUDaBeamer.tex' version 3.15 (2021/05/26),
+%% This is file `DEMO-TUDaBeamer.tex' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaBibliography.bib b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaBibliography.bib
index f23ef2f42c..f60c07a49b 100644
--- a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaBibliography.bib
+++ b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaBibliography.bib
@@ -1,4 +1,4 @@
-%% This is file `DEMO-TUDaBibliography.bib' version 3.15 (2021/05/26),
+%% This is file `DEMO-TUDaBibliography.bib' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaExercise.tex b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaExercise.tex
index ac7e5d454b..26cdeb5c56 100644
--- a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaExercise.tex
+++ b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaExercise.tex
@@ -1,4 +1,4 @@
-%% This is file `DEMO-TUDaExercise.tex' version 3.15 (2021/05/26),
+%% This is file `DEMO-TUDaExercise.tex' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaFromaddress.lco b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaFromaddress.lco
index 818cc2f7e6..171649509f 100644
--- a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaFromaddress.lco
+++ b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaFromaddress.lco
@@ -1,4 +1,4 @@
-%% This is file `DEMO-TUDaFromaddress.lco' version 3.15 (2021/05/26),
+%% This is file `DEMO-TUDaFromaddress.lco' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaLeaflet.tex b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaLeaflet.tex
index e7e1315117..fb71971345 100644
--- a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaLeaflet.tex
+++ b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaLeaflet.tex
@@ -1,4 +1,4 @@
-%% This is file `DEMO-TUDaLeaflet.tex' version 3.15 (2021/05/26),
+%% This is file `DEMO-TUDaLeaflet.tex' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaLetter.tex b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaLetter.tex
index bbf595a51e..eaa0b60f40 100644
--- a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaLetter.tex
+++ b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaLetter.tex
@@ -1,4 +1,4 @@
-%% This is file `DEMO-TUDaLetter.tex' version 3.15 (2021/05/26),
+%% This is file `DEMO-TUDaLetter.tex' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaPhD.tex b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaPhD.tex
index f2e3d8d95b..22e5b70de8 100644
--- a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaPhD.tex
+++ b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaPhD.tex
@@ -1,4 +1,4 @@
-%% This is file `DEMO-TUDaPhD.tex' version 3.15 (2021/05/26),
+%% This is file `DEMO-TUDaPhD.tex' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaPoster.tex b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaPoster.tex
index 4b275abba4..66ba28640a 100644
--- a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaPoster.tex
+++ b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaPoster.tex
@@ -1,4 +1,4 @@
-%% This is file `DEMO-TUDaPoster.tex' version 3.15 (2021/05/26),
+%% This is file `DEMO-TUDaPoster.tex' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaPub.tex b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaPub.tex
index 2d2f1946ee..fe6b6e3216 100644
--- a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaPub.tex
+++ b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaPub.tex
@@ -1,4 +1,4 @@
-%% This is file `DEMO-TUDaPub.tex' version 3.15 (2021/05/26),
+%% This is file `DEMO-TUDaPub.tex' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaReport.tex b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaReport.tex
index c8f3d0df52..3836badbe9 100644
--- a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaReport.tex
+++ b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaReport.tex
@@ -1,4 +1,4 @@
-%% This is file `DEMO-TUDaReport.tex' version 3.15 (2021/05/26),
+%% This is file `DEMO-TUDaReport.tex' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaSciPoster.tex b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaSciPoster.tex
index da2c18840c..2780fec0c8 100644
--- a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaSciPoster.tex
+++ b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaSciPoster.tex
@@ -1,4 +1,4 @@
-%% This is file `DEMO-TUDaSciPoster.tex' version 3.15 (2021/05/26),
+%% This is file `DEMO-TUDaSciPoster.tex' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaThesis.tex b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaThesis.tex
index 65bfd35a51..d6d903bd16 100644
--- a/macros/latex/contrib/tuda-ci/example/DEMO-TUDaThesis.tex
+++ b/macros/latex/contrib/tuda-ci/example/DEMO-TUDaThesis.tex
@@ -1,4 +1,4 @@
-%% This is file `DEMO-TUDaThesis.tex' version 3.15 (2021/05/26),
+%% This is file `DEMO-TUDaThesis.tex' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/tex/beamercolorthemeTUDa.sty b/macros/latex/contrib/tuda-ci/tex/beamercolorthemeTUDa.sty
index 5e5689e764..2749f0bf1a 100644
--- a/macros/latex/contrib/tuda-ci/tex/beamercolorthemeTUDa.sty
+++ b/macros/latex/contrib/tuda-ci/tex/beamercolorthemeTUDa.sty
@@ -1,4 +1,4 @@
-%% This is file `beamercolorthemeTUDa.sty' version 3.15 (2021/05/26),
+%% This is file `beamercolorthemeTUDa.sty' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{beamercolorthemeTUDa}
 [\filedate\space\fileversion]
diff --git a/macros/latex/contrib/tuda-ci/tex/beamerfontthemeTUDa.sty b/macros/latex/contrib/tuda-ci/tex/beamerfontthemeTUDa.sty
index 7778b24938..a276fa4064 100644
--- a/macros/latex/contrib/tuda-ci/tex/beamerfontthemeTUDa.sty
+++ b/macros/latex/contrib/tuda-ci/tex/beamerfontthemeTUDa.sty
@@ -1,4 +1,4 @@
-%% This is file `beamerfontthemeTUDa.sty' version 3.15 (2021/05/26),
+%% This is file `beamerfontthemeTUDa.sty' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{beamerfontthemeTUDa}
  [\filedate\space\fileversion]
diff --git a/macros/latex/contrib/tuda-ci/tex/beamerinnerthemeTUDa.sty b/macros/latex/contrib/tuda-ci/tex/beamerinnerthemeTUDa.sty
index a23e64d81b..581bc18606 100644
--- a/macros/latex/contrib/tuda-ci/tex/beamerinnerthemeTUDa.sty
+++ b/macros/latex/contrib/tuda-ci/tex/beamerinnerthemeTUDa.sty
@@ -1,4 +1,4 @@
-%% This is file `beamerinnerthemeTUDa.sty' version 3.15 (2021/05/26),
+%% This is file `beamerinnerthemeTUDa.sty' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesExplPackage{beamerinnerthemeTUDa}{\filedate}{\fileversion}{Inner~beamer~theme~of~tuda-ci}
 
diff --git a/macros/latex/contrib/tuda-ci/tex/beamerouterthemeTUDa.sty b/macros/latex/contrib/tuda-ci/tex/beamerouterthemeTUDa.sty
index 8749ea5290..b646a48bff 100644
--- a/macros/latex/contrib/tuda-ci/tex/beamerouterthemeTUDa.sty
+++ b/macros/latex/contrib/tuda-ci/tex/beamerouterthemeTUDa.sty
@@ -1,4 +1,4 @@
-%% This is file `beamerouterthemeTUDa.sty' version 3.15 (2021/05/26),
+%% This is file `beamerouterthemeTUDa.sty' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesExplPackage{beamerouterthemeTUDa}{\filedate}{\fileversion}{Outer~beamer~theme~of~tuda-ci}
 
diff --git a/macros/latex/contrib/tuda-ci/tex/beamerthemeTUDa-mecheng.sty b/macros/latex/contrib/tuda-ci/tex/beamerthemeTUDa-mecheng.sty
index 524561055d..5eec56c863 100644
--- a/macros/latex/contrib/tuda-ci/tex/beamerthemeTUDa-mecheng.sty
+++ b/macros/latex/contrib/tuda-ci/tex/beamerthemeTUDa-mecheng.sty
@@ -1,4 +1,4 @@
-%% This is file `beamerthemeTUDa-mecheng.sty' version 3.15 (2021/05/26),
+%% This is file `beamerthemeTUDa-mecheng.sty' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \RequirePackage{expl3}
 \ProvidesExplPackage{beamerthemeTUDa-mecheng}{\filedate}{\fileversion}{specific tudabeamer configuration for the department of mechanical engineering}
 
diff --git a/macros/latex/contrib/tuda-ci/tex/beamerthemeTUDa.sty b/macros/latex/contrib/tuda-ci/tex/beamerthemeTUDa.sty
index 1b1553d7cf..da07e3a984 100644
--- a/macros/latex/contrib/tuda-ci/tex/beamerthemeTUDa.sty
+++ b/macros/latex/contrib/tuda-ci/tex/beamerthemeTUDa.sty
@@ -1,4 +1,4 @@
-%% This is file `beamerthemeTUDa.sty' version 3.15 (2021/05/26),
+%% This is file `beamerthemeTUDa.sty' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{beamerthemeTUDa}
  [\filedate\space\fileversion\space beamer theme using the Corporate Design of TU Darmstadt]
diff --git a/macros/latex/contrib/tuda-ci/tex/tuda-a0paper.clo b/macros/latex/contrib/tuda-ci/tex/tuda-a0paper.clo
index e4ee466b67..3d69d9c001 100644
--- a/macros/latex/contrib/tuda-ci/tex/tuda-a0paper.clo
+++ b/macros/latex/contrib/tuda-ci/tex/tuda-a0paper.clo
@@ -1,4 +1,4 @@
-%% This is file `tuda-a0paper.clo' version 3.15 (2021/05/26),
+%% This is file `tuda-a0paper.clo' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \ProvidesExplFile{tuda-a0paper.clo}{\filedate}{\fileversion}{tuda-ci~size~adjustments~for~a0paper}
 \cs_set:Nn \ptxcd_setup_title_sizes: {
 	\cs_set:Nn \ptxcd_title_fontsize: {{125pt}{165pt}}
diff --git a/macros/latex/contrib/tuda-ci/tex/tuda-a1paper.clo b/macros/latex/contrib/tuda-ci/tex/tuda-a1paper.clo
index 3e048932ee..d376e2c66a 100644
--- a/macros/latex/contrib/tuda-ci/tex/tuda-a1paper.clo
+++ b/macros/latex/contrib/tuda-ci/tex/tuda-a1paper.clo
@@ -1,4 +1,4 @@
-%% This is file `tuda-a1paper.clo' version 3.15 (2021/05/26),
+%% This is file `tuda-a1paper.clo' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \ProvidesExplFile{tuda-a1paper.clo}{\filedate}{\fileversion}{tuda-ci~size~adjustments~for~a0paper}
 \cs_set:Nn \ptxcd_setup_title_sizes: {
 		\cs_set:Nn \ptxcd_title_fontsize: {{86pt}{120pt}}
diff --git a/macros/latex/contrib/tuda-ci/tex/tuda-a2paper.clo b/macros/latex/contrib/tuda-ci/tex/tuda-a2paper.clo
index 8ff84a57ed..a3f57b3b0c 100644
--- a/macros/latex/contrib/tuda-ci/tex/tuda-a2paper.clo
+++ b/macros/latex/contrib/tuda-ci/tex/tuda-a2paper.clo
@@ -1,4 +1,4 @@
-%% This is file `tuda-a2paper.clo' version 3.15 (2021/05/26),
+%% This is file `tuda-a2paper.clo' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \ProvidesExplFile{tuda-a2paper.clo}{\filedate}{\fileversion}{tuda-ci~size~adjustments~for~a0paper}
 \cs_set:Nn \ptxcd_setup_title_sizes: {
 		\cs_set:Nn \ptxcd_title_fontsize: {{65pt}{82pt}}
diff --git a/macros/latex/contrib/tuda-ci/tex/tuda-a3paper.clo b/macros/latex/contrib/tuda-ci/tex/tuda-a3paper.clo
index 763f212c2a..effd50311f 100644
--- a/macros/latex/contrib/tuda-ci/tex/tuda-a3paper.clo
+++ b/macros/latex/contrib/tuda-ci/tex/tuda-a3paper.clo
@@ -1,4 +1,4 @@
-%% This is file `tuda-a3paper.clo' version 3.15 (2021/05/26),
+%% This is file `tuda-a3paper.clo' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \ProvidesExplFile{tuda-a3paper.clo}{\filedate}{\fileversion}{tuda-ci~size~adjustments~for~a3paper}
 \cs_set:Nn \ptxcd_setup_title_sizes: {
   \cs_set:Nn \ptxcd_title_fontsize: {{47pt}{61pt}}
diff --git a/macros/latex/contrib/tuda-ci/tex/tuda-a4paper.clo b/macros/latex/contrib/tuda-ci/tex/tuda-a4paper.clo
index fe1e4eca56..f780875c72 100644
--- a/macros/latex/contrib/tuda-ci/tex/tuda-a4paper.clo
+++ b/macros/latex/contrib/tuda-ci/tex/tuda-a4paper.clo
@@ -1,4 +1,4 @@
-%% This is file `tuda-a4paper.clo' version 3.15 (2021/05/26),
+%% This is file `tuda-a4paper.clo' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \ProvidesExplFile{tuda-a4paper.clo}{\filedate}{\fileversion}{tuda-ci~size~adjustments~for~a4paper}
 \cs_set:Nn \ptxcd_setup_title_sizes: {
   \cs_set:Nn \ptxcd_title_fontsize: {{36pt}{47pt}}
diff --git a/macros/latex/contrib/tuda-ci/tex/tuda-a5paper.clo b/macros/latex/contrib/tuda-ci/tex/tuda-a5paper.clo
index a1726191f6..322f6fbc6e 100644
--- a/macros/latex/contrib/tuda-ci/tex/tuda-a5paper.clo
+++ b/macros/latex/contrib/tuda-ci/tex/tuda-a5paper.clo
@@ -1,4 +1,4 @@
-%% This is file `tuda-a5paper.clo' version 3.15 (2021/05/26),
+%% This is file `tuda-a5paper.clo' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \ProvidesExplFile{tuda-a5paper.clo}{\filedate}{\fileversion}{tuda-ci~size~adjustments~for~a5paper}
 \cs_set:Nn \ptxcd_setup_title_sizes: {
   \cs_set:Nn \ptxcd_title_fontsize: {{22pt}{28pt}}
diff --git a/macros/latex/contrib/tuda-ci/tex/tuda-pgfplots.sty b/macros/latex/contrib/tuda-ci/tex/tuda-pgfplots.sty
index edc1a52a04..57c59baa02 100644
--- a/macros/latex/contrib/tuda-ci/tex/tuda-pgfplots.sty
+++ b/macros/latex/contrib/tuda-ci/tex/tuda-pgfplots.sty
@@ -1,4 +1,4 @@
-%% This is file `tuda-pgfplots.sty' version 3.15 (2021/05/26),
+%% This is file `tuda-pgfplots.sty' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 % Special thanks to: Sebastian Schöps Institut Theorie Elektromagnetischer Felder (TEMF), TU Darmstadt
 % The original version of this file has been inspired by the colorscheme in the Metropolis beamer theme by Matthias Vogelgesang https://github.com/matze/mtheme
 \ProvidesPackage{tuda-pgfplots}[\filedate\space\fileversion\space tuda-ci pgfplots color schemes]
diff --git a/macros/latex/contrib/tuda-ci/tex/tudabeamer.cls b/macros/latex/contrib/tuda-ci/tex/tudabeamer.cls
index 1638f50476..96489f31ee 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudabeamer.cls
+++ b/macros/latex/contrib/tuda-ci/tex/tudabeamer.cls
@@ -1,4 +1,4 @@
-%% This is file `tudabeamer.cls' version 3.15 (2021/05/26),
+%% This is file `tudabeamer.cls' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesClass{tudabeamer}
  [\filedate\space\fileversion\space]
@@ -44,8 +44,8 @@
 \str_new:N \g_ptxcd_department_str
 \keys_define:nn {ptxcd/beamer} {
 	accentcolor .code:n = \PassOptionsToPackage{accentcolor=#1}{tudacolors},
-	colorframetitle .code:n = \PassOptionsToPackage{\l_keys_key_tl=#1}{beamercolorthemeTUDa}
-	\PassOptionsToPackage{\l_keys_key_tl=#1}{beamerouterthemeTUDa},
+	colorframetitle .code:n = \exp_args:Nx \PassOptionsToPackage{\l_keys_key_tl=#1}{beamercolorthemeTUDa}
+	\exp_args:Nx \PassOptionsToPackage{\l_keys_key_tl=#1}{beamerouterthemeTUDa},
 	colorframetitle .default:n = true,
 	logo .code:n = \PassOptionsToPackage{logo=#1}{beamerouterthemeTUDa},
 	pdfa .bool_gset:N = \g_ptxcd_pdfa_bool,
diff --git a/macros/latex/contrib/tuda-ci/tex/tudacolors.def b/macros/latex/contrib/tuda-ci/tex/tudacolors.def
index 843631b68a..db447baad2 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudacolors.def
+++ b/macros/latex/contrib/tuda-ci/tex/tudacolors.def
@@ -1,4 +1,4 @@
-%% This is file `tudacolors.def' version 3.15 (2021/05/26),
+%% This is file `tudacolors.def' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \ProvidesFile{tudacolors.def}
 [\filedate\space\fileversion\space Color definitions for tuda-ci]
 
diff --git a/macros/latex/contrib/tuda-ci/tex/tudacolors.sty b/macros/latex/contrib/tuda-ci/tex/tudacolors.sty
index 1e53382ac8..92e8030ed5 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudacolors.sty
+++ b/macros/latex/contrib/tuda-ci/tex/tudacolors.sty
@@ -1,4 +1,4 @@
-%% This is file `tudacolors.sty' version 3.15 (2021/05/26),
+%% This is file `tudacolors.sty' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \RequirePackage{expl3}
 \ProvidesExplPackage{tudacolors}{\filedate}{\fileversion}{Color definition for TU Darmstadt's tuda-ci bundle}
diff --git a/macros/latex/contrib/tuda-ci/tex/tudaexercise.cls b/macros/latex/contrib/tuda-ci/tex/tudaexercise.cls
index 9303c530ca..2aeae4f839 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudaexercise.cls
+++ b/macros/latex/contrib/tuda-ci/tex/tudaexercise.cls
@@ -1,4 +1,4 @@
-%% This is file `tudaexercise.cls' version 3.15 (2021/05/26),
+%% This is file `tudaexercise.cls' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \RequirePackage{expl3}
 \ProvidesExplClass{tudaexercise}
@@ -152,9 +152,9 @@
 	titlepage .code:n = {\msg_warning:nnn {tudapub} {titlepage-option-disabled} {#1}},
 	paper .choices:nn = {a0,a1,a2,a3,a4,a5,a6}{
 		\int_gset_eq:NN \g_ptxcd_paper_int  \l_keys_choice_int
-		\PassOptionsToPackage{paper=\l_keys_choice_tl}{tudarules}
-		\PassOptionsToPackage{paper=\l_keys_choice_tl}{typearea}
-		\PassOptionsToPackage{\l_keys_choice_tl paper}{geometry}
+		\exp_args:Nx \PassOptionsToPackage{paper=\l_keys_choice_tl}{tudarules}
+		\exp_args:Nx \PassOptionsToPackage{paper=\l_keys_choice_tl}{typearea}
+		\exp_args:Nx \PassOptionsToPackage{\l_keys_choice_tl paper}{geometry}
 	},
 	paper .initial:n = a4,
 	logofile .tl_gset:N = \g_ptxcd_logofile_tl,
diff --git a/macros/latex/contrib/tuda-ci/tex/tudafonts.sty b/macros/latex/contrib/tuda-ci/tex/tudafonts.sty
index 3815336425..1ea353f04e 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudafonts.sty
+++ b/macros/latex/contrib/tuda-ci/tex/tudafonts.sty
@@ -1,4 +1,4 @@
-%% This is file `tudafonts.sty' version 3.15 (2021/05/26),
+%% This is file `tudafonts.sty' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \ProvidesPackage{tudafonts}
  [\filedate\space\fileversion\space
diff --git a/macros/latex/contrib/tuda-ci/tex/tudaleaflet.cls b/macros/latex/contrib/tuda-ci/tex/tudaleaflet.cls
index b801cda1f1..ba91e39950 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudaleaflet.cls
+++ b/macros/latex/contrib/tuda-ci/tex/tudaleaflet.cls
@@ -1,4 +1,4 @@
-%% This is file `tudaleaflet.cls' version 3.15 (2021/05/26),
+%% This is file `tudaleaflet.cls' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \RequirePackage{expl3}
 \ProvidesExplPackage{tudaleaflet}{\filedate}{\fileversion}{Leaflets using the Corporate Design of TU Darmstadt}
diff --git a/macros/latex/contrib/tuda-ci/tex/tudaletter.cls b/macros/latex/contrib/tuda-ci/tex/tudaletter.cls
index ae2719e752..14b3dec695 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudaletter.cls
+++ b/macros/latex/contrib/tuda-ci/tex/tudaletter.cls
@@ -1,4 +1,4 @@
-%% This is file `tudaletter.cls' version 3.15 (2021/05/26),
+%% This is file `tudaletter.cls' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \RequirePackage{expl3}
 \ProvidesExplClass{tudaletter}
diff --git a/macros/latex/contrib/tuda-ci/tex/tudalettersize10pt.clo b/macros/latex/contrib/tuda-ci/tex/tudalettersize10pt.clo
index 2902767a13..be2276079e 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudalettersize10pt.clo
+++ b/macros/latex/contrib/tuda-ci/tex/tudalettersize10pt.clo
@@ -1,4 +1,4 @@
-%% This is file `tudalettersize10pt.clo' version 3.15 (2021/05/26),
+%% This is file `tudalettersize10pt.clo' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/tex/tudamecheng.cfg b/macros/latex/contrib/tuda-ci/tex/tudamecheng.cfg
index 6bdb3451f3..7280a31a39 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudamecheng.cfg
+++ b/macros/latex/contrib/tuda-ci/tex/tudamecheng.cfg
@@ -1,4 +1,4 @@
-%% This is file `tudamecheng.cfg' version 3.15 (2021/05/26),
+%% This is file `tudamecheng.cfg' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \RequirePackage{expl3}
 \ProvidesExplFile{tudamecheng.cfg}
 {\filedate}{\fileversion}{Special Features the department of mechanical engineering of Darmstadt's Corporate Design (tuda-ci)}
diff --git a/macros/latex/contrib/tuda-ci/tex/tudaposter.cls b/macros/latex/contrib/tuda-ci/tex/tudaposter.cls
index 93a732bd30..4328cb9049 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudaposter.cls
+++ b/macros/latex/contrib/tuda-ci/tex/tudaposter.cls
@@ -1,4 +1,4 @@
-%% This is file `tudaposter.cls' version 3.15 (2021/05/26),
+%% This is file `tudaposter.cls' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \RequirePackage{expl3}
 \ProvidesExplPackage{tudaposter}{\filedate}{\fileversion}{Poster Layouts for the Corporate Design of TU Darmstadt}
@@ -59,7 +59,7 @@
 	footheight .dim_gset:N = \g_ptxcd_footheight_dim,
 	paper .choices:nn = {a0,a1,a2,a3,a4}{
 		\int_gset_eq:NN \g_ptxcd_paper_int  \l_keys_choice_int
-		\PassOptionsToPackage{paper=\l_keys_choice_tl}{tudarules}
+		\exp_args:Nx \PassOptionsToPackage{paper=\l_keys_choice_tl}{tudarules}
 		\tl_gset_eq:NN \g_ptxcd_paper_tl \l_keys_choice_tl
 	},
 	fontsize .choice:,
diff --git a/macros/latex/contrib/tuda-ci/tex/tudapub.cls b/macros/latex/contrib/tuda-ci/tex/tudapub.cls
index a2f9bd08fa..5574218e28 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudapub.cls
+++ b/macros/latex/contrib/tuda-ci/tex/tudapub.cls
@@ -1,4 +1,4 @@
-%% This is file `tudapub.cls' version 3.15 (2021/05/26),
+%% This is file `tudapub.cls' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \RequirePackage{expl3}
 \ProvidesExplClass{tudapub}
@@ -150,9 +150,9 @@
 	logo .initial:n = {body},
 	paper .choices:nn = {a0,a1,a2,a3,a4,a5,a6}{
 		\int_gset_eq:NN \g_ptxcd_paper_int  \l_keys_choice_int
-		\PassOptionsToPackage{paper=\l_keys_choice_tl}{tudarules}
-		\PassOptionsToPackage{paper=\l_keys_choice_tl}{typearea}
-		\PassOptionsToPackage{\l_keys_choice_tl paper}{geometry}
+		\exp_args:Nx \PassOptionsToPackage{paper=\l_keys_choice_tl}{tudarules}
+		\exp_args:Nx \PassOptionsToPackage{paper=\l_keys_choice_tl}{typearea}
+		\exp_args:Nx \PassOptionsToPackage{\l_keys_choice_tl paper}{geometry}
 	},
 	paper .initial:n = a4,
 	IMRAD .bool_gset:N = \g_ptxcd_IMRAD_bool,
diff --git a/macros/latex/contrib/tuda-ci/tex/tudarules.sty b/macros/latex/contrib/tuda-ci/tex/tudarules.sty
index e86d41923e..ed549312d2 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudarules.sty
+++ b/macros/latex/contrib/tuda-ci/tex/tudarules.sty
@@ -1,4 +1,4 @@
-%% This is file `tudarules.sty' version 3.15 (2021/05/26),
+%% This is file `tudarules.sty' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \RequirePackage{expl3}
 \ProvidesExplPackage{tudarules}{\filedate}{\fileversion}{Creation of colored bars for tuda-ci bundle}
diff --git a/macros/latex/contrib/tuda-ci/tex/tudasciposter.cls b/macros/latex/contrib/tuda-ci/tex/tudasciposter.cls
index 9b0990a2bf..6a551813b6 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudasciposter.cls
+++ b/macros/latex/contrib/tuda-ci/tex/tudasciposter.cls
@@ -1,4 +1,4 @@
-%% This is file `tudasciposter.cls' version 3.15 (2021/05/26),
+%% This is file `tudasciposter.cls' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \NeedsTeXFormat{LaTeX2e}
 \RequirePackage{expl3}
 \ProvidesExplPackage{tudasciposter}{\filedate}{\fileversion}{Scientific Poster Layout for TU Darmstadt}
@@ -62,8 +62,8 @@
 	unknown .code:n = {\prop_gput:NVn \g_ptxcd_clsopts_prop \l_keys_key_tl {#1}},
 	paper .choices:nn = {a0,a1,a2,a3}{
 		\int_gset_eq:NN \g_ptxcd_paper_int  \l_keys_choice_int
-		\PassOptionsToPackage{paper=\l_keys_choice_tl}{tudarules}
-		\PassOptionsToPackage{\l_keys_choice_tl paper}{geometry}
+		\exp_args:Nx \PassOptionsToPackage{paper=\l_keys_choice_tl}{tudarules}
+		\exp_args:Nx \PassOptionsToPackage{\l_keys_choice_tl paper}{geometry}
 	},
 	paper .initial:n = a0,
 	fontsize .tl_gset:N = \g_ptxcd_fontsize_tl,
diff --git a/macros/latex/contrib/tuda-ci/tex/tudasize9pt.clo b/macros/latex/contrib/tuda-ci/tex/tudasize9pt.clo
index 404b04a01f..3f923ae763 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudasize9pt.clo
+++ b/macros/latex/contrib/tuda-ci/tex/tudasize9pt.clo
@@ -1,4 +1,4 @@
-%% This is file `tudasize9pt.clo' version 3.15 (2021/05/26),
+%% This is file `tudasize9pt.clo' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
diff --git a/macros/latex/contrib/tuda-ci/tex/tudathesis.cfg b/macros/latex/contrib/tuda-ci/tex/tudathesis.cfg
index 6542186891..5e0b5b4f9c 100644
--- a/macros/latex/contrib/tuda-ci/tex/tudathesis.cfg
+++ b/macros/latex/contrib/tuda-ci/tex/tudathesis.cfg
@@ -1,4 +1,4 @@
-%% This is file `tudathesis.cfg' version 3.15 (2021/05/26),
+%% This is file `tudathesis.cfg' version 3.16 (2021/06/03),
 %% it is part of
 %% TUDa-CI -- Corporate Design for TU Darmstadt
 %% ----------------------------------------------------------------------------
@@ -26,8 +26,8 @@
 %%
 %% ============================================================================
 %%
-\def\fileversion{3.15}
-\def\filedate{2021/05/26}
+\def\fileversion{3.16}
+\def\filedate{2021/06/03}
 \RequirePackage{expl3}
 \ProvidesExplFile{tudathesis.cfg}
 {\filedate}{\fileversion}{Special Features for publication type 'thesis' using TU Darmstadt's Corporate Design (tuda-ci)}