Giter Club home page Giter Club logo

Comments (6)

ulyngs avatar ulyngs commented on July 24, 2024

Agreed - I was thinking a bit about this when I was looking into the different ways to allow for customisation of link colouring etc.

Could you submit a PR and also add a suggested section that documents this to the new 'How to Use' chapter?

from oxforddown.

shirdekel avatar shirdekel commented on July 24, 2024

Just submitted the PR. Can you clarify what you expect for the 'How to Use' chapter, though? Currently it seems quite high level and it feels like adding something about TOC link highlighting would be out of place. Or do you eventually want to it be quite detailed?

from oxforddown.

ulyngs avatar ulyngs commented on July 24, 2024

Good question, I was wondering a bit about what would be best.

There's a couple of options:

  1. the 'How to Use' chapter remains high-level, and more detailed things such as TOC link highlighting go in the 'Customisations and Extensions chapter'
  2. the 'How to Use' chapter adds a section named something like 'setting layout options in index.Rmd' - this section has brief explanations for each of the setting that are available directly from index.Rmd's YAML header, without any further tweaking

I favour the second option - would you agree?

from oxforddown.

ulyngs avatar ulyngs commented on July 24, 2024

Merged pull request and tweaked

from oxforddown.

Zenahr avatar Zenahr commented on July 24, 2024

@ulyngs since this has been merged the issue can be closed.

from oxforddown.

shirdekel avatar shirdekel commented on July 24, 2024

Good question, I was wondering a bit about what would be best.

There's a couple of options:

  1. the 'How to Use' chapter remains high-level, and more detailed things such as TOC link highlighting go in the 'Customisations and Extensions chapter'

  2. the 'How to Use' chapter adds a section named something like 'setting layout options in index.Rmd' - this section has brief explanations for each of the setting that are available directly from index.Rmd's YAML header, without any further tweaking

I favour the second option - would you agree?

Sorry for the delayed response. Yes, I thought that something like option 2 is better!

from oxforddown.

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.