Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

share JS/CSS between all doc versions #7

Open
millermedeiros opened this issue Jun 4, 2013 · 2 comments
Open

share JS/CSS between all doc versions #7

millermedeiros opened this issue Jun 4, 2013 · 2 comments

Comments

@millermedeiros
Copy link
Member

will be easier to make changes across all files.

@patocallaghan
Copy link
Contributor

So are you happy with pulling the assets directory to the top-level to share between docs and templates? E.g.

-- assets_
-- docs
-- templates

or where you just referring to sharing them between the docs directory? E.g.

-- templates
    -- assets_
    -- latest
    -- v0.1.0 etc

@millermedeiros
Copy link
Member Author

I think we can simply change the path to the assets and point it to the template/assets_ on the root folder - instead of {{root_path}}assets_/css/main.css we would use something like ../../template/assets_/css/main.css.

the ideal option would be to add new setting to mdoc to avoid copying the assets folder, but I can totally live with a non-optimal approach specially since mdoc source code is such a big mess... (I coded it in a few hours over a weekend and after that I only monkey-patched new features as needed).

this change will also require some sort of metadata on the HTML to set which version tag to use on the "source" and "specs" links (since the content of the files changes quite often) - I would probably add something to the body element like VERSION_TAG = $('body').data('versionTag') || 'master'

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants