mii/tokenizers
1
0
Fork 0
mirror of https://github.com/mii443/tokenizers.git synced 2025-08-23 00:35:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

Doc - Improve quicktour support for multi-lang

Browse Source
This commit is contained in:
Anthony MOI
2020-10-24 09:14:35 -04:00
committed by Anthony MOI
parent 57391e0170
commit 290a885b76
4 changed files with 90 additions and 46 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
docs/source/_ext/rust_doc.py
View File

@ -14,20 +14,21 @@ class RustRef:
parts = text.split("::")
if text.startswith("~"):
content = parts[-1]
title = parts[-1]
parts[0] = parts[0][1:]
else:
content = text
link = self.base_link()
if doctype == "struct":
link += self.make_struct_link(parts)
l, title = self.make_struct_link(parts, title)
if doctype == "func":
link += self.make_func_link(parts)
l, title = self.make_func_link(parts, title)
if doctype == "meth":
link += self.make_meth_link(parts)
l, title = self.make_meth_link(parts, title)
link += l
node = nodes.reference(internal=False, refuri=link, text=content)
node = nodes.reference(internal=False, refuri=link, text=title)
wrapper = nodes.literal(classes=["xref"])
wrapper += node
@ -36,7 +37,7 @@ class RustRef:
def base_link(self):
return f"https://docs.rs/tokenizers/{rust_version}"
def make_struct_link(self, parts):
def make_struct_link(self, parts, title):
link = ""
struct_name = parts[-1]
path = parts[:-1]
@ -45,9 +46,9 @@ class RustRef:
link += f"/{p}"
link += f"/struct.{struct_name}.html"
return link
return link, title
def make_func_link(self, parts):
def make_func_link(self, parts, title):
link = ""
fn_name = parts[-1]
@ -56,17 +57,20 @@ class RustRef:
link += f"/{p}"
link += f"/fn.{fn_name}.html"
return link
return link, title
def make_meth_link(self, parts):
def make_meth_link(self, parts, title):
meth_name = parts[-1]
if meth_name.endswith("()"):
meth_name = meth_name[:-2]
link = self.make_struct_link(parts[:-1])
link, title = self.make_struct_link(parts[:-1], title)
link += f"#method.{meth_name}"
return link
if not title.endswith(")"):
title += "()"
return link, title
def setup(app):