Giter Club home page Giter Club logo

adbook's People

Contributors

toyboot4e avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

Forkers

jianglu

adbook's Issues

html/css/hbs fixes

  • Run formatter
  • Highlight current article in the sidebar (update HBS template)
  • Consider browser chromes on mobile

More?

Diagrams do not work

If I use a diagram, it does not work.

The diagram is created in 'src/static/img', but it is not moved/copied to 'site'.

It might be a bigger issue. It seems nothing is copied from static.

I also think that there should be 2 dirs :

  • 'src' for adoc files
  • 'static' for user css/icons/images

and diagrams should go in a temp dir, like .adbook-cache.

Does not work on windows

I created the scaffold and tried to build it, but it fails.

I think the source_file is too much escaped. And most likely source_dir too.
It is both quoted and double bachslashed.

2 errors while building the book:
- when running `asciidoctor`:
  src: \\?\S:\Rust\toto\src\index.adoc
  dst: \\?\S:\Rust\toto\.adbook-cache\b\index.html
  cmd: "asciidoctor" "\\\\?\\S:\\Rust\\toto\\src\\index.adoc" "-o" "-" "-r" "asciidoctor-diagram" "--trace" "--verbose" "-B" "\\\\?\\S:\\Rust\\toto\\src" "-a" "hbs@=theme/hbs/article.hbs" "-a" "linkcss" "-a" "stylesdir@=/theme/css" "-a" "stylesheet@=article.css" "-a" "imagesdir@=/static/img" "-a" "imagesoutdir@=\\\\?\\S:\\Rust\\toto\\src/static/img" "-a" "hardbreaks" "-a" "sectnums" "-a" "sectnumlevels@=2" "-a" "tabside@=4" "-a" "experimental" "-a" "stem@=latexmath" "-a" "icons@=font" "-a" "adbook=https://github.com/toyboot4e/adbook[adbook]" "-a" "rust=https://www.rust-lang.org/[Rust]" "-a" "asciidoctor=https://asciidoctor.org/[Asciidoctor]" "-a" "mdbook=https://github.com/rust-lang/mdBook[mdBook]" "-a" "handlebars=https://handlebarsjs.com/[Handlebars]" "-a" "prismjs=https://prismjs.com/[Prism.js]" "--embedded"

I could not find how to remove either quotes or backslashes.

Cache

Use two step cache:

  • Cache AsciiDoc output
  • Cache final output

cargo install fails on windows

I tried to use adbook, but it does not install.

I’m using rust 1.57.0.

I also cloned the repo, but it fails too.

There are many errors, but it’s just a few repeated :

error: cannot find derive macro `Parser` in this scope
  --> src\cli.rs:33:10
   |
33 | #[derive(Parser, Debug)]
   |          ^^^^^^
   |
note: `Parser` is imported here, but it is only a trait, without a derive macro
  --> src\cli.rs:27:5
   |
27 | use clap::Parser;
   |     ^^^^^^^^^^^^

error: cannot find attribute `clap` in this scope
  --> src\cli.rs:34:3
   |
34 | #[clap(name = "adbook is a simple SSG powered by asciidoctor")]
   |   ^^^^
   |
   = note: `clap` is in scope, but it is a crate, not an attribute

A problem with clap. It just needs the « derive » feature in cargo.toml.

A confusion for the compiler between the various « Ok ».

Cache fix

I was converting the same file twice. I fixed it other than cache updates, so wil fix it today.

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.