1. Pypy
  2. Untitled project
  3. pypy

Commits

Rami Chowdhury  committed 33b19de

Remove unused Sphinx configuration / customization

  • Participants
  • Parent commits 837ebf4
  • Branches improve-docs

Comments (0)

Files changed (3)

File pypy/doc/config/confrest.py

-from pypy.doc.confrest import *
-from pypy.config.makerestdoc import make_cmdline_overview
-from pypy.config import pypyoption
-from rpython.config.config import Config
-from rpython.config import translationoption
-
-
-all_optiondescrs = [pypyoption.pypy_optiondescription,
-                    translationoption.translation_optiondescription,
-                   ]
-start_to_descr = dict([(descr._name, descr) for descr in all_optiondescrs])
-
-class PyPyPage(PyPyPage): 
-    def fill(self):
-        super(PyPyPage, self).fill()
-        self.menubar[:] = html.div(
-            html.a("general documentation", href="../index.html",
-                   class_="menu"), " ",
-            html.a("config index", href="index.html",
-                   class_="menu"), " ",
-            html.a("command-line overview", href="commandline.html",
-                   class_="menu"), " ",
-            " ", id="menubar")
-
-class Project(Project): 
-    stylesheet = "../style.css"
-    title = "PyPy Configuration"
-    prefix_title = "PyPy Configuration"
-    Page = PyPyPage 
-
-    def get_content(self, txtpath, encoding):
-        if txtpath.basename == "commandline.rst":
-            result = []
-            for line in txtpath.read().splitlines():
-                if line.startswith('.. GENERATE:'):
-                    start = line[len('.. GENERATE:'):].strip()
-                    descr = start_to_descr[start]
-                    line = make_cmdline_overview(descr, title=False).text()
-                result.append(line)
-            return "\n".join(result)
-        fullpath = txtpath.purebasename
-        start = fullpath.split(".")[0]
-        path = fullpath.rsplit(".", 1)[0]
-        basedescr = start_to_descr.get(start)
-        if basedescr is None:
-            return txtpath.read()
-        if fullpath.count(".") == 0:
-            descr = basedescr
-            path = ""
-        else:
-            conf = Config(basedescr)
-            subconf, step = conf._cfgimpl_get_home_by_path(
-                    fullpath.split(".", 1)[1])
-            descr = getattr(subconf._cfgimpl_descr, step)
-        text = unicode(descr.make_rest_doc(path).text())
-        if txtpath.check(file=True):
-            content = txtpath.read()
-            if content:
-                text += "\nDescription\n==========="
-                return u"%s\n\n%s" % (text, unicode(txtpath.read(), encoding))
-        return text
-

File pypy/doc/confrest.py

-import py
-
-# XXX importing/inheriting from an internal py lib class is hackish
-from confrest_oldpy import Project, Page, relpath
-html = py.xml.html
-
-
-class PyPyPage(Page):
-    googlefragment = """
-<script type="text/javascript">
-var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
-document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
-</script>
-<script type="text/javascript">
-try {
-var pageTracker = _gat._getTracker("UA-7778406-2");
-pageTracker._trackPageview();
-} catch(err) {}</script>
-"""
-
-    def fill_menubar(self):
-        self.menubar = html.div(
-            html.a("home",
-                   href=self.get_doclink("index.html"),
-                   class_="menu"),
-            " ",
-            html.a("blog", href="http://morepypy.blogspot.com", class_="menu"),
-            " ",
-            html.a("getting-started",
-                   href=self.get_doclink("getting-started.html"),
-                   class_="menu"),
-            " ",
-            html.a("documentation", href=self.get_doclink("docindex.html"),
-                   class_="menu"),
-            " ",
-            html.a("hg", href="https://bitbucket.org/pypy/pypy",
-                   class_="menu"),
-            " ",
-            html.a("issues",
-                   href="https://bugs.pypy.org/",
-                   class_="menu"),
-            " ", id="menubar")
-
-    def get_doclink(self, target):
-        return relpath(self.targetpath.strpath,
-                       self.project.docpath.join(target).strpath)
-
-    def unicode(self, doctype=True):
-        page = self._root.unicode()
-        page = page.replace("</body>", self.googlefragment + "</body>")
-        if doctype:
-            return self.doctype + page
-        else:
-            return page
-
-
-class Project(Project):
-    mydir = py.path.local(__file__).dirpath()
-
-    title = "PyPy"
-    stylesheet = 'style.css'
-    encoding = 'latin1'
-    prefix_title = "PyPy"
-    logo = html.div(
-        html.a(
-            html.img(alt="PyPy", id="pyimg",
-                     src="http://codespeak.net/pypy/img/py-web1.png",
-                     height=110, width=149)))
-    Page = PyPyPage

File pypy/doc/confrest_oldpy.py

-import py
-from pypy.tool.rest.rest import convert_rest_html, strip_html_header 
-from pypy.tool.difftime import worded_time 
-
-html = py.xml.html 
-
-class Page(object): 
-    doctype = ('<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"'
-               ' "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\n')
-
-    def __init__(self, project, title, targetpath, stylesheeturl=None,
-                 type="text/html", encoding="ISO-8859-1"): 
-        self.project = project 
-        self.title = project.prefix_title + title 
-        self.targetpath = targetpath
-        self.stylesheeturl = stylesheeturl 
-        self.type = type 
-        self.encoding = encoding 
-
-        self.body = html.body()
-        self.head = html.head() 
-        self._root = html.html(self.head, self.body) 
-        self.fill() 
-
-    def a_docref(self, name, relhtmlpath):
-        docpath = self.project.docpath
-        return html.a(name, class_="menu",
-                      href=relpath(self.targetpath.strpath,
-                                   docpath.join(relhtmlpath).strpath))
-
-    def a_apigenref(self, name, relhtmlpath):
-        apipath = self.project.apigenpath
-        return html.a(name, class_="menu",
-                      href=relpath(self.targetpath.strpath,
-                                   apipath.join(relhtmlpath).strpath))
-        
-    def fill_menubar(self):
-        items = [
-            self.a_docref("index", "index.html"),
-            #self.a_apigenref("api", "api/index.html"),
-            #self.a_apigenref("source", "source/index.html"),
-            self.a_docref("contact", "contact.html"),
-            self.a_docref("download", "download.html"),
-        ]
-        items2 = [items.pop(0)]
-        sep = " "
-        for item in items:
-            items2.append(sep)
-            items2.append(item)
-        self.menubar = html.div(id="menubar", *items2)
-
-    def fill(self):
-        content_type = "%s;charset=%s" %(self.type, self.encoding)
-        self.head.append(html.title(self.title))
-        self.head.append(html.meta(name="Content-Type", content=content_type))
-        if self.stylesheeturl:
-            self.head.append(
-                    html.link(href=self.stylesheeturl,
-                              media="screen", rel="stylesheet",
-                              type="text/css"))
-        self.fill_menubar()
-
-        self.metaspace = html.div(
-                html.div(self.title, class_="project_title"),
-                self.menubar,
-                id='metaspace')
-
-        self.body.append(self.project.logo)
-        self.body.append(self.metaspace)
-        self.contentspace = html.div(id="contentspace")
-        self.body.append(self.contentspace)
-
-    def unicode(self, doctype=True): 
-        page = self._root.unicode() 
-        if doctype: 
-            return self.doctype + page 
-        else: 
-            return page 
-
-class PyPage(Page): 
-    def get_menubar(self):
-        menubar = super(PyPage, self).get_menubar()
-        # base layout 
-        menubar.append(
-            html.a("issue", href="https://codespeak.net/issue/py-dev/",
-                   class_="menu"),
-        )
-        return menubar
-                            
-
-def getrealname(username):
-    try:
-        import uconf
-    except ImportError:
-        return username
-    try:
-        user = uconf.system.User(username)
-    except KeyboardInterrupt:
-        raise
-    try: 
-        return user.realname or username
-    except KeyError:
-        return username
-    
-
-class Project:
-    mydir = py.path.local(__file__).dirpath()
-    title = "py lib"
-    prefix_title = ""  # we have a logo already containing "py lib"
-    encoding = 'latin1' 
-    stylesheet = None
-    logo = html.div(
-        html.a(
-            html.img(alt="py lib", id='pyimg', height=114, width=154, 
-                              src="http://codespeak.net/img/pylib.png"), 
-                            href="http://codespeak.net"))
-    Page = PyPage 
-
-    def __init__(self, sourcepath=None):
-        if sourcepath is None:
-            sourcepath = self.mydir
-        self.setpath(sourcepath)
-
-    def setpath(self, sourcepath, docpath=None, 
-                apigenpath=None, stylesheet=None):
-        self.sourcepath = sourcepath
-        if docpath is None:
-            docpath = sourcepath
-        self.docpath = docpath
-        if apigenpath is None:
-            apigenpath = docpath
-        self.apigenpath = apigenpath
-        if stylesheet is None:
-            p = sourcepath.join(self.stylesheet or "style.css")
-            if p.check():
-                self.stylesheet = p
-            else:
-                self.stylesheet = None
-        else:
-            p = sourcepath.join(stylesheet)
-            if p.check():
-                stylesheet = p
-            self.stylesheet = stylesheet
-        #assert self.stylesheet
-        self.apigen_relpath = relpath(
-            self.docpath.strpath + '/', self.apigenpath.strpath + '/')
-
-    def get_content(self, txtpath, encoding):
-        return unicode(txtpath.read(), encoding)
-
-    def get_htmloutputpath(self, txtpath):
-        reloutputpath = txtpath.new(ext='.html').relto(self.sourcepath)
-        return self.docpath.join(reloutputpath)
-
-    def process(self, txtpath): 
-        encoding = self.encoding
-        content = self.get_content(txtpath, encoding)
-        outputpath = self.get_htmloutputpath(txtpath)
-
-        stylesheet = self.stylesheet
-        if isinstance(stylesheet, py.path.local):
-            if not self.docpath.join(stylesheet.basename).check():
-                self.docpath.ensure(dir=True)
-                stylesheet.copy(self.docpath)
-            stylesheet = relpath(outputpath.strpath,
-                                 self.docpath.join(stylesheet.basename).strpath)
-
-        content = convert_rest_html(content, txtpath,
-                                    stylesheet=stylesheet, encoding=encoding)
-        content = strip_html_header(content, encoding=encoding)
-
-        page = self.Page(self, "[%s] " % txtpath.purebasename,
-                         outputpath, stylesheeturl=stylesheet)
-
-        try:
-            svninfo = txtpath.info() 
-            modified = " modified %s by %s" % (worded_time(svninfo.mtime),
-                                               getrealname(svninfo.last_author))
-        except (KeyboardInterrupt, SystemExit): 
-            raise
-        except:
-            modified = " "
-
-        page.contentspace.append(
-            html.div(html.div(modified, style="float: right; font-style: italic;"), 
-                     id = 'docinfoline'))
-
-        page.contentspace.append(py.xml.raw(content))
-        f = outputpath.open('w')
-        f.write(page.unicode().encode(encoding))
-        f.close()
-
-# XXX this function comes from apigen/linker.py, put it
-# somewhere in py lib 
-import os
-def relpath(p1, p2, sep=os.path.sep, back='..', normalize=True):
-    """ create a relative path from p1 to p2
-
-        sep is the seperator used for input and (depending
-        on the setting of 'normalize', see below) output
-
-        back is the string used to indicate the parent directory
-
-        when 'normalize' is True, any backslashes (\) in the path
-        will be replaced with forward slashes, resulting in a consistent
-        output on Windows and the rest of the world
-
-        paths to directories must end on a / (URL style)
-    """
-    if normalize:
-        p1 = p1.replace(sep, '/')
-        p2 = p2.replace(sep, '/')
-        sep = '/'
-        # XXX would be cool to be able to do long filename
-        # expansion and drive
-        # letter fixes here, and such... iow: windows sucks :(
-    if (p1.startswith(sep) ^ p2.startswith(sep)):
-        raise ValueError("mixed absolute relative path: %r -> %r" %(p1, p2))
-    fromlist = p1.split(sep)
-    tolist = p2.split(sep)
-
-    # AA
-    # AA BB     -> AA/BB
-    #
-    # AA BB
-    # AA CC     -> CC
-    #
-    # AA BB 
-    # AA      -> ../AA
-
-    diffindex = 0
-    for x1, x2 in zip(fromlist, tolist):
-        if x1 != x2:
-            break
-        diffindex += 1
-    commonindex = diffindex - 1
-
-    fromlist_diff = fromlist[diffindex:]
-    tolist_diff = tolist[diffindex:]
-
-    if not fromlist_diff:
-        return sep.join(tolist[commonindex:])
-    backcount = len(fromlist_diff)
-    if tolist_diff:
-        return sep.join([back,]*(backcount-1) + tolist_diff)
-    return sep.join([back,]*(backcount) + tolist[commonindex:])
-
-