

PathConverter

概观

PathConverter是一个扩展，可以将本地，相对参考路径转换为链接和图像的绝对路径或相对路径。 它最初是为一个项目编写的，该项目希望通过将其呈现在临时位置来预览降价。 该扩展允许将路径转换为从临时位置开始工作。 当试图理解为什么创建这个扩展时，这个上下文很重要。 它的实际使用仅限于这样的情况，所以它不是在大多数正常情况下使用的东西。

PathConverter需要一个绝对的基本路径。 基本路径是Markdown内容在转换时的假定位置。 该路径用作查找相对于Markdown内容的图像和参考文件的参考。 本质上，Markdown文件中的引用当前将在转换时相对于此基本路径。 参考文献的存在性没有得到验证，但分析确定它是否是相对路径，如果是，则有资格进行转换。 在绝对模式的​​情况下，相对的Markdown引用将被转换为绝对路径。

如果PathConverter处于相对模式，那么扩展名也需要一个相对路径来转换。 相对路径必须是转换后HTML假定位置的绝对路径。 如果可以确定引用路径是相对的，那么这些引用将被转换为与提供的相对路径参数对齐的相对路径。 这个想法是，一个Markdown文件可以在一个并不意味着它是最终位置的位置找到。 Markdown源文件中的引用将链接到相对于基本路径，但它们将被转换为相对于它的新位置 - 相对路径参数。

目前PathConverter会搜索href和src属性的所需标签。 默认情况下，只搜索a，script，img和link标签。

PathConverter也足够智能，只能在参考链接的文件部分进行操作。 考虑以下情况：path/to/file.html＃header-to-jump-to。 在这个例子中，path/to/file.html将被转换，但是＃header-to-jump-to将保持不变。

正如前面提到的，像这样的用例是有限的，但是如果你有这样的情况，这种情况下，PathConverter可以帮助。

选项

选项	类型	默认	描述
base_path	string	''	指示要用于查找的绝对基路径的字符串referenced files.
relative_path	string	''	表示引用相对于绝对路径的字符串（绝对值设置为true时不使用）。
absolute	bool	False	确定路径是否转换为绝对或相对。
tags	string	'a script img link'	标签（用空格分隔）用于查找href和src属性。