Code Monkey home page Code Monkey logo

Comments (4)

lurch avatar lurch commented on July 22, 2024

It would also be great if that RTD link was provided somewhere in this project's README or somewhere on devicetree.org!

Currently https://www.devicetree.org/specifications/ just links to https://github.com/devicetree-org/devicetree-specification/releases/tag/v0.3-rc1 and IMHO it's a bit user-unfriendly to only offer a source code zipfile 🙁

from devicetree-specification.

robherring avatar robherring commented on July 22, 2024

from devicetree-specification.

lurch avatar lurch commented on July 22, 2024

the PDF building is broken on v0.3-rc1 and I haven't investigated why

Just out of curiosity, I decided to take a quick look... seems like one (or more?) of the Sphinx requirements now needs at least Python3.5 (I did this by creating a virtualenv). And in Python 3, subprocess.check_output returns bytes by default, which lead to an exception on line 259 of conf.py. So I fixed that by adding the universal_newlines=True parameter to line 69 of source/conf.py, and after doing that make latexpdf works fine, and I get a build/latex/devicetree-specification.pdf (which seems to be okay AFAICT).

from devicetree-specification.

robherring avatar robherring commented on July 22, 2024

Adding the version in the html output is done. A problem with RTD output remains. It will probably work if a tag is pushed before a branch with the tag is. A branch push doesn't find a version likely because a shallow clone is done. Pushing a tag afterwards doesn't work because RTD thinks it already built that version. @glikely will have to fix the RTD side.

Note that GH Pages works fine: http://devicetree-org.github.io/devicetree-specification/

from devicetree-specification.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.