Giter VIP home page Giter VIP logo

Comments (5)

OrangeChannel avatar OrangeChannel commented on June 18, 2024 1

https://github.com/OrangeChannel/guide.encode.moe/tree/mdbook I started testing with mdbook and it looks pretty good so far, a lot of pages have to change still though because of missing/changed features.

Preview at https://github.com/OrangeChannel/guide.encode.moe/tree/gh-pages but actual github pages won't build yet because of missing plug-ins etc.

from guide.encode.moe.

OrangeChannel avatar OrangeChannel commented on June 18, 2024

What do you think about migrating the book to rust's mdBook https://github.com/rust-lang/mdBook? The way to contribute to the book would stay the same and this seems pretty flexible, enough to support most of the stuff we have on the book now, while simplifying a lot and adding a few things that would be nice (like draft pages and allowing deeper section numbers for pages). It's also an actively maintained project and they seem pretty open to feature requests, and there's a recently opened PR + issue for "edit this page" functionality which is one of the things from old gitbook that's missing.

Not sure how migrating should happen though, ideally it would be nice to keep the current contributors list via the current commits but at the same time, the repo is becoming pretty large with all the image commits and changes.

from guide.encode.moe.

FichteFoll avatar FichteFoll commented on June 18, 2024

the repo is becoming pretty large with all the image commits and changes.

We might want to consider moving the images to git LFS, especially since need to be lossless. The only problem is that it requires rewriting the history to properly prune them. But that's separate from the mdbook changes, which we'll discuss in #61.

from guide.encode.moe.

anonyno avatar anonyno commented on June 18, 2024

issue is because gitbook unmaintained #62 (comment)

from guide.encode.moe.

FichteFoll avatar FichteFoll commented on June 18, 2024

Indeed. #61 is there to address this, but I haven't been able to get around to that. Sorry about that, but it's on my radar.

from guide.encode.moe.

Related Issues (10)

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.