From fbf10cac26085bc907b57fd36ea1dc09b2e6afc1 Mon Sep 17 00:00:00 2001 From: Robert Göhler Date: Sun, 22 Dec 2019 19:31:29 +0100 Subject: Sphinx: create sphinx-vyos extension --- docs/_ext/vyos.py | 204 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 204 insertions(+) create mode 100644 docs/_ext/vyos.py (limited to 'docs/_ext') diff --git a/docs/_ext/vyos.py b/docs/_ext/vyos.py new file mode 100644 index 00000000..7ef88d0a --- /dev/null +++ b/docs/_ext/vyos.py @@ -0,0 +1,204 @@ +from docutils import nodes, utils +from docutils.parsers.rst.roles import set_classes +from docutils.parsers.rst import Directive +from sphinx.util.docutils import SphinxDirective + + +def setup(app): + + app.add_config_value( + 'vyos_phabricator_url', + 'https://phabricator.vyos.net/', '' + ) + app.add_role('vytask', vytask_role) + + print(app.config.vyos_phabricator_url) + + app.add_node( + CmdDiv, + html=(CmdDiv.visit_div, CmdDiv.depart_div), + latex=(CmdDiv.visit_div, CmdDiv.depart_div), + text=(CmdDiv.visit_div, CmdDiv.depart_div) + ) + app.add_node( + CmdHeader, + html=(CmdHeader.visit_div, CmdHeader.depart_div), + latex=(CmdHeader.visit_div, CmdHeader.depart_div), + text=(CmdHeader.visit_div, CmdHeader.depart_div) + ) + app.add_node(CfgcmdList) + app.add_directive('cfgcmdlist', CfgcmdlistDirective) + + app.add_node(OpcmdList) + app.add_directive('opcmdlist', OpcmdlistDirective) + + app.add_directive('cfgcmd', CfgCmdDirective) + app.add_directive('opcmd', OpCmdDirective) + app.connect('doctree-resolved', process_cmd_nodes) + + +class CfgcmdList(nodes.General, nodes.Element): + pass + + +class OpcmdList(nodes.General, nodes.Element): + pass + + +class CmdHeader(nodes.General, nodes.Element): + + @staticmethod + def visit_div(self, node): + self.body.append(self.starttag(node, 'div')) + + @staticmethod + def depart_div(self, node=None): + self.body.append('\n') + + +class CmdDiv(nodes.General, nodes.Element): + + @staticmethod + def visit_div(self, node): + self.body.append(self.starttag(node, 'div')) + + @staticmethod + def depart_div(self, node=None): + self.body.append('\n') + + +class CfgcmdlistDirective(Directive): + + def run(self): + return [CfgcmdList('')] + + +class OpcmdlistDirective(Directive): + + def run(self): + return [OpcmdList('')] + + +class CmdDirective(SphinxDirective): + + has_content = True + custom_class = '' + + def run(self): + title_list = [] + content_list = [] + title_text = '' + content_text = '' + has_body = False + + cfgmode = self.custom_class + "cmd" + + if '' in self.content: + index = self.content.index('') + title_list = self.content[0:index] + content_list = self.content[index + 1:] + title_text = ' '.join(title_list) + content_text = '\n'.join(content_list) + has_body = True + else: + title_text = ' '.join(self.content) + + anchor_id = nodes.make_id(self.custom_class + "cmd-" + title_text) + target = nodes.target(ids=[anchor_id]) + + panel_name = 'cmd-{}'.format(self.custom_class) + panel_element = CmdDiv() + panel_element['classes'] += ['cmd', panel_name] + + heading_element = CmdHeader(title_text) + title_nodes, messages = self.state.inline_text(title_text, + self.lineno) + + title = nodes.inline(title_text, '', *title_nodes) + target['classes'] += [] + title['classes'] += [cfgmode] + heading_element.append(target) + heading_element.append(title) + + heading_element['classes'] += [self.custom_class + 'cmd-heading'] + + panel_element.append(heading_element) + + append_list = { + 'docname': self.env.docname, + 'cmdnode': title.deepcopy(), + 'cmd': title_text, + 'target': target, + } + + if cfgmode == 'opcmd': + if not hasattr(self.env, "vyos_opcmd"): + self.env.vyos_opcmd = [] + self.env.vyos_opcmd.append(append_list) + + if cfgmode == 'cfgcmd': + if not hasattr(self.env, "vyos_cfgcmd"): + self.env.vyos_cfgcmd = [] + self.env.vyos_cfgcmd.append(append_list) + + if has_body: + body_element = CmdDiv(content_text) + self.state.nested_parse( + content_list, + self.content_offset, + body_element + ) + + body_element['classes'] += [self.custom_class + 'cmd-body'] + panel_element.append(body_element) + return [panel_element] + + +class OpCmdDirective(CmdDirective): + custom_class = 'op' + + +class CfgCmdDirective(CmdDirective): + custom_class = 'cfg' + + +def process_cmd_node(app, cmd, fromdocname): + para = nodes.paragraph() + newnode = nodes.reference(' ', ' ') + innernode = cmd['cmdnode'] + newnode['refdocname'] = cmd['docname'] + newnode['refuri'] = app.builder.get_relative_uri( + fromdocname, cmd['docname']) + newnode['refuri'] += '#' + cmd['target']['refid'] + newnode['classes'] += ['cmdlink'] + newnode.append(innernode) + para += newnode + return para + + +def process_cmd_nodes(app, doctree, fromdocname): + env = app.builder.env + + for node in doctree.traverse(CfgcmdList): + content = [] + + for cmd in sorted(env.vyos_cfgcmd, key=lambda i: i['cmd']): + content.append(process_cmd_node(app, cmd, fromdocname)) + node.replace_self(content) + + for node in doctree.traverse(OpcmdList): + content = [] + + for cmd in sorted(env.vyos_opcmd, key=lambda i: i['cmd']): + content.append(process_cmd_node(app, cmd, fromdocname)) + node.replace_self(content) + + +def vytask_role(name, rawtext, text, lineno, inliner, options={}, content=[]): + app = inliner.document.settings.env.app + base = app.config.vyos_phabricator_url + ref = base + str(text) + set_classes(options) + node = nodes.reference( + rawtext, utils.unescape(str(text)), refuri=ref, **options) + return [node], [] -- cgit v1.2.3 From faf67e43dff6c16aba6df68dbfb490daaa0ff584 Mon Sep 17 00:00:00 2001 From: Robert Göhler Date: Sun, 29 Dec 2019 10:21:10 +0100 Subject: Sphinx: prepare tex layout --- docs/_ext/vyos.py | 56 +++++++++++++++++++++++++++++++++++++++++---- docs/_static/css/custom.css | 18 ++++++++++++++- 2 files changed, 69 insertions(+), 5 deletions(-) (limited to 'docs/_ext') diff --git a/docs/_ext/vyos.py b/docs/_ext/vyos.py index 7ef88d0a..71b039d1 100644 --- a/docs/_ext/vyos.py +++ b/docs/_ext/vyos.py @@ -11,19 +11,28 @@ def setup(app): 'https://phabricator.vyos.net/', '' ) app.add_role('vytask', vytask_role) + app.add_role('cfgcmd', cmd_role) + app.add_role('opcmd', cmd_role) print(app.config.vyos_phabricator_url) + app.add_node( + inlinecmd, + html=(inlinecmd.visit_span, inlinecmd.depart_span), + latex=(inlinecmd.tex, inlinecmd.tex), + text=(inlinecmd.visit_span, inlinecmd.depart_span) + ) + app.add_node( CmdDiv, html=(CmdDiv.visit_div, CmdDiv.depart_div), - latex=(CmdDiv.visit_div, CmdDiv.depart_div), + latex=(CmdDiv.tex, CmdDiv.tex), text=(CmdDiv.visit_div, CmdDiv.depart_div) ) app.add_node( CmdHeader, html=(CmdHeader.visit_div, CmdHeader.depart_div), - latex=(CmdHeader.visit_div, CmdHeader.depart_div), + latex=(CmdHeader.tex, CmdHeader.tex), text=(CmdHeader.visit_div, CmdHeader.depart_div) ) app.add_node(CfgcmdList) @@ -44,6 +53,7 @@ class CfgcmdList(nodes.General, nodes.Element): class OpcmdList(nodes.General, nodes.Element): pass +import json class CmdHeader(nodes.General, nodes.Element): @@ -53,7 +63,15 @@ class CmdHeader(nodes.General, nodes.Element): @staticmethod def depart_div(self, node=None): - self.body.append('\n') + # self.body.append('\n') + self.body.append('' % ( + 'Permalink to this Command')) + + @staticmethod + def tex(self, node=None): + pass class CmdDiv(nodes.General, nodes.Element): @@ -66,6 +84,31 @@ class CmdDiv(nodes.General, nodes.Element): def depart_div(self, node=None): self.body.append('\n') + @staticmethod + def tex(self, node=None): + pass + + +class inlinecmd(nodes.inline): + + @staticmethod + def visit_span(self, node): + self.body.append(self.starttag(node, 'span')) + + @staticmethod + def depart_span(self, node=None): + self.body.append('\n') + + @staticmethod + def tex(self, node=None): + print('=====================') + #print(json.dumps(dir(self))) + print('---------------------') + print((self.visit_inline)) + exit() + #self.body.append('\\chapter') + pass + class CfgcmdlistDirective(Directive): @@ -114,7 +157,7 @@ class CmdDirective(SphinxDirective): title_nodes, messages = self.state.inline_text(title_text, self.lineno) - title = nodes.inline(title_text, '', *title_nodes) + title = inlinecmd(title_text, '', *title_nodes) target['classes'] += [] title['classes'] += [cfgmode] heading_element.append(target) @@ -202,3 +245,8 @@ def vytask_role(name, rawtext, text, lineno, inliner, options={}, content=[]): node = nodes.reference( rawtext, utils.unescape(str(text)), refuri=ref, **options) return [node], [] + + +def cmd_role(name, rawtext, text, lineno, inliner, options={}, content=[]): + node = nodes.literal(text, text) + return [node], [] diff --git a/docs/_static/css/custom.css b/docs/_static/css/custom.css index 52bdf6f9..a1e34259 100644 --- a/docs/_static/css/custom.css +++ b/docs/_static/css/custom.css @@ -12,7 +12,7 @@ span.cfgcmd { .opcmd-heading, .cfgcmd-heading { - display: block; + display: inline-block; margin: 6px 0; font-size: 90%; line-height: normal; @@ -32,8 +32,24 @@ span.cfgcmd { } + +.cfgcmd-heading .cmdlink:after, +.opcmd-heading .cmdlink:after { + content: ""; + font-family: FontAwesome +} + + +.cfgcmd-heading:not(:hover) .cmdlink, +.opcmd-heading:not(:hover) .cmdlink { + display: none; +} + + + a.cmdlink { font-size: 80%; + margin-left: 6px; } .wy-nav-content { -- cgit v1.2.3 From d2159df64738df01474b248f572c23b735d9ed0e Mon Sep 17 00:00:00 2001 From: Robert Göhler Date: Sat, 4 Jan 2020 12:48:07 +0100 Subject: sphinx: implement latex layout --- docs/_ext/vyos.py | 60 +++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 49 insertions(+), 11 deletions(-) (limited to 'docs/_ext') diff --git a/docs/_ext/vyos.py b/docs/_ext/vyos.py index 71b039d1..7a3d75ba 100644 --- a/docs/_ext/vyos.py +++ b/docs/_ext/vyos.py @@ -19,16 +19,22 @@ def setup(app): app.add_node( inlinecmd, html=(inlinecmd.visit_span, inlinecmd.depart_span), - latex=(inlinecmd.tex, inlinecmd.tex), + latex=(inlinecmd.visit_tex, inlinecmd.depart_tex), text=(inlinecmd.visit_span, inlinecmd.depart_span) ) app.add_node( CmdDiv, html=(CmdDiv.visit_div, CmdDiv.depart_div), - latex=(CmdDiv.tex, CmdDiv.tex), + latex=(CmdDiv.visit_tex, CmdDiv.depart_tex), text=(CmdDiv.visit_div, CmdDiv.depart_div) ) + app.add_node( + CmdBody, + html=(CmdBody.visit_div, CmdBody.depart_div), + latex=(CmdBody.visit_tex, CmdBody.depart_tex), + text=(CmdBody.visit_div, CmdBody.depart_div) + ) app.add_node( CmdHeader, html=(CmdHeader.visit_div, CmdHeader.depart_div), @@ -88,6 +94,38 @@ class CmdDiv(nodes.General, nodes.Element): def tex(self, node=None): pass + @staticmethod + def visit_tex(self, node=None): + self.body.append('\n\n\\begin{changemargin}{0cm}{0cm}\n') + + @staticmethod + def depart_tex(self, node=None): + self.body.append('\n\\end{changemargin}\n\n') + +class CmdBody(nodes.General, nodes.Element): + + @staticmethod + def visit_div(self, node): + self.body.append(self.starttag(node, 'div')) + + @staticmethod + def depart_div(self, node=None): + self.body.append('\n') + + @staticmethod + def visit_tex(self, node=None): + self.body.append('\n\n\\begin{changemargin}{0.5cm}{0.5cm}\n') + + + @staticmethod + def depart_tex(self, node=None): + self.body.append('\n\\end{changemargin}\n\n') + + + @staticmethod + def tex(self, node=None): + pass + class inlinecmd(nodes.inline): @@ -100,14 +138,14 @@ class inlinecmd(nodes.inline): self.body.append('\n') @staticmethod - def tex(self, node=None): - print('=====================') - #print(json.dumps(dir(self))) - print('---------------------') - print((self.visit_inline)) - exit() - #self.body.append('\\chapter') - pass + def visit_tex(self, node=None): + self.body.append(r'\sphinxbfcode{\sphinxupquote{') + #self.literal_whitespace += 1 + + @staticmethod + def depart_tex(self, node=None): + self.body.append(r'}}') + #self.literal_whitespace -= 1 class CfgcmdlistDirective(Directive): @@ -185,7 +223,7 @@ class CmdDirective(SphinxDirective): self.env.vyos_cfgcmd.append(append_list) if has_body: - body_element = CmdDiv(content_text) + body_element = CmdBody(content_text) self.state.nested_parse( content_list, self.content_offset, -- cgit v1.2.3