Comments (4)
At the moment, it makes poor use of "real estate". I'd recommend starting with the simpler Bootstrap and then add in any necessary links.
from ro-crate.
+1
from ro-crate.
@ljgarcia suggested using a ReadTheDocs style theme, see for instance https://isa-specs.readthedocs.io/en/latest/isajson.html
That would look very nice! And we could do a similar page split of the main sections, e.g. Contextual Entities, each of the appendices, etc.
I am not sure how we can activate that in GitHub pages as a theme, at least I hope we don't need to rewrite the Markdown to RST! Do @ljgarcia have any suggestions?
I also think if we change the markdown theme it would change the look on the old https://researchobject.github.io/ro-crate/1.0/ - however if this breaks we could save/archive 1.0 and older as the existing HTML rather than MarkDown.
from ro-crate.
You can include a remote theme. In the config.yml you need to add
remote_theme: pmarsceill/just-the-docs #rather than #theme: jekyll-theme-minimal
Other configurations possible for just-the-docs
logo: #I put it on the root, not sure it can be inside a folder
search_enabled: true/false
aux_links: #the ones that go on the top
footer_content:
All the "docs" I wanted listed on the left, I added them to a folder named docs. I think by default they will appear on alphabetical order. You can also add a header to the ./docs/*.md
---
layout: default
title: Title
nav_order: 2
---
And yes, the annoying bit is that if you want a new page on position 2, you will have to update the 3, 4, and so (if you want to keep all tidy up, if not, you will have two pages in position 2 and they will be displayed following alphabetical order, the rest will follow the specified positions)
from ro-crate.
Related Issues (20)
- Add ELN file format use case
- Not all favicons updated HOT 1
- Some old links do not work anymore HOT 3
- Use Case: Record Git repository, release tag/version, and dependencies within a workflow description inside RO-Crate HOT 1
- Use ETT table of contents
- Use only the `title: ` attribute in the frontmatter for titles, avoid duplicating title in Markdown
- Reinstate ETT logo in the footer HOT 1
- Review overwrites of ETT theme includes
- Add links to find out more about RO-Crate to top of homepage
- BioDT use case HOT 2
- BUG: Spec is hard to find HOT 1
- RO-Crate Profiles on the website as a menu option HOT 1
- Issue with ROHub downloads (contextual entities still not linked correctly - they are string values)
- Search results do not include spec pages HOT 2
- Use Case: I want to indicate where Web-based Data Entities should be downloaded to
- Use Case: Deep archive of RO-Crate with downloaded references
- Guidance and best practice for nested RO-Crates
- Use Case: how to reference data entities within a referenced RO-Crate HOT 2
- Use Case: How can the RO-Crate enable future maintenance/changes
- Use Case: Building combined knowledge graph of nested RO-Crates
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
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.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from ro-crate.