Comments (18)
Can you elaborate a bit? I'm not sure what exactly you're asking for here.
If you elaborate a bit and I know enough to do it, I'll take it. :)
from sinatra.github.com.
intro-.html files are currently generated from README..rdoc files from the sinatra/sinatra repo. Howerver, in master, the upcoming Sinatra 1.4.0 release, most of these are now *.md files.
from sinatra.github.com.
The (not that nice) code is in Rakefile.
from sinatra.github.com.
Ah, gotcha. I'll start poking around tomorrow after I get some sleep! If you've got any tidbits that you think would be of help, just dump them here and I'll read them before getting started in the morning.
from sinatra.github.com.
First one would be to remove the rdoc_to_html generation and add-in a markdown to html parser like maruku.
from sinatra.github.com.
If we remove it, we need to convert all the outstanding rdoc files to markdown, too.
from sinatra.github.com.
That is true. I forgot there are still some Readmes pending.
from sinatra.github.com.
rdoc 4 parses markdown and rdoc just fine.
from sinatra.github.com.
@rkh I was actually really looking forward to working on this, but I'm gonna have to back out. Short version is "family issues." Github's not the place to discuss it further than that. Sorry I didn't get back to you quicker this morning about that.
from sinatra.github.com.
I've been fiddling with the Rakefile. Trying out the various Markdown parsers to get proper code-block parsing but failing miserably. Will update soon.
@burningTyger The Rdoc 4 Markdown parser doesn't support fenced codeblocks I think :/ Having trouble "requiring" the right file while using it but wasn't lucky in my attempts.
from sinatra.github.com.
I think you can use redcarpet plus some option to get it working.
from sinatra.github.com.
Tried that. The parsing happens well but the table of contents is being
generated after the first header block. Will check other options in a
while. Dinner time :)
On Tuesday, February 26, 2013, Konstantin Haase wrote:
I think you can use redcarpet plus some option to get it working.
—
Reply to this email directly or view it on GitHubhttps://github.com//issues/97#issuecomment-14115317
.
Kashyap KMBC
from sinatra.github.com.
I also added a ToC to the README.md, not sure if we wanna reuse that or remove that.
from sinatra.github.com.
Oh! I think that needs to be removed (especially if Redcarpet is to be
used) since the html IDs that get generated are messing with the ToC IDs
generated in the README body. I'll try some options and see if anything
works.
On Tue, Feb 26, 2013 at 7:40 PM, Konstantin Haase
[email protected]:
I also added a ToC to the README.md, not sure if we wanna reuse that or
remove that.—
Reply to this email directly or view it on GitHubhttps://github.com//issues/97#issuecomment-14115960
.
Kashyap KMBC
from sinatra.github.com.
This works with the current snapshot of the Sinatra repo: kgrz@1b77777 (except the inline ToC which can be enabled if needed)
This is a hack at best. This checks for each of the languages where the READMEs are still in RDoc and, depending on the list, parse the README either using the RDoc parser or the Redcarpet markdown parser. This will break if the main Sinatra repo gets updated with a new README. However, I think this can server the purpose if this is what holding back the 1.4.0 release.
@rkh The ToC gets generated twice in the english README section. Either this should be removed entirely from the README or a <div>
can be added surrounding the ToC and can be hidden via JS.
from sinatra.github.com.
All Markdown now!
from sinatra.github.com.
See #100
from sinatra.github.com.
@kgrz I gave you commit access.
from sinatra.github.com.
Related Issues (20)
- Add protection docs to the site HOT 1
- Documentation changelog is out of date
- Site has a redirect loop HOT 2
- Chris Schneider’s Blog: GITTR HOT 3
- Design Tasks HOT 2
- Wild page contains broken links HOT 1
- Can't access Sinatra website HOT 3
- http://sinatrarb.com/intro.html not working nor displays a error page.
- enable HTTPS HOT 5
- Anchor in documentation HOT 3
- Bump up package.json dependencies
- Clean up gulp or perhaps consider better options (hint: parcel!)
- Update Ruby gem versions to the latest and greatest!
- Use a consistent and simpler font-stack
- Do we use lang attribute in html?
- sinatra v1.4.8 not picking right port from config HOT 1
- [API documentation] clicking 'classes', 'methods' links resulted in "SQLite3::CorruptException: database disk image is malformed" message
- Wrong url for maintenance policy for Sinatra on Contribution page
- The broken links to language specific READMEs are still remaining.
- Use https for links HOT 2
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 sinatra.github.com.