Once Grimoire starts getting custom examples, we could provide a corresponding client like clojuredocs-client that slurps _includes/**/examples and strips text only between raw and endraw tags. That would allow you to keep Grimoire as simple static HTML while still allowing for painless example contributions.
On Tuesday, July 8, 2014 3:11:32 PM UTC-4, Reid McKenzie wrote: > > Not as such. Strictly speaking one can navigate to say > https://github.com/arrdem/grimoire/edit/master/_includes/1.4.0/clojure.core/DASH/examples.md > > and find all the examples for what is in this case clojure.core/-. However > there is no examples API at present and due to the flat file nature of > Grimoire I consider one more or less out of scope until such time as > Grimoire gets reworked into a "real" webapp if ever. > > As Grimoire contains only examples from clojuredocs at present, the > clojuredocs REPL client (https://github.com/dakrone/clojuredocs-client) > (which is what Grimoire uses to access clojuredocs' examples) should give > you identical results for the time being. > > I'm open to comment and issues as to whether or not having REPL access to > examples is potentially useful and a desired feature. > > Reid > > > On 07/08/2014 05:28 AM, Colin Fleming wrote: > > If we think that Grimoire should be the official ClojureDocs > replacement, why don't we do that? Could we just host Grimoire under the > clojuredocs.org domain, perhaps structuring the URLs to match? > > One thing that I couldn't see - does Grimoire offer an API to get access > to the examples? > > > On 8 July 2014 11:52, Andy Fingerhut <andy.fi...@gmail.com <javascript:>> > wrote: > >> Mark, creating separate versions of the Clojure cheat sheet that link >> to Grimoire instead of ClojureDocs.org should be fairly straightforward, >> but due to other work I won't get to it for at least a few days. If >> someone else is interested, and not put off by my code, they are welcome to >> go for it and submit a pull request: >> >> https://github.com/jafingerhut/clojure-cheatsheets >> >> The time-consuming part isn't getting the first version up and running, >> but checking that all the symbols with odd characters in them actually have >> working links in both the HTML and PDF versions, although arguably the >> links in the PDF versions aren't as important. >> >> I can publish the results here, which is one click away from >> http://clojure.org/cheatsheet >> >> http://jafingerhut.github.io >> >> Once done, Clojure folks other than myself can consider whether the >> version with links to Grimoire belongs at http://clojure.org/cheatsheet, >> too. >> >> Andy >> >> >> On Mon, Jul 7, 2014 at 9:49 PM, Mark Mandel <mark....@gmail.com >> <javascript:>> wrote: >> >>> Nice work! I've been using Grimoire all day :) >>> >>> Two small suggestions, which you have probably thought of: (1) search >>> (2) a copy of the clojure cheat sheet that points to grimoire instead. >>> (Maybe Grimoire needs it's own domain?) >>> >>> CrossClj is *awesome* as well. I've been wanting something similar for >>> a looong time. Thanks! >>> >>> Mark >>> >>> >>> >>> On Tue, Jul 8, 2014 at 2:31 PM, Reid McKenzie <rmcke...@gmail.com >>> <javascript:>> wrote: >>> >>>> I'm delighted to announce that thanks to the official Clojuredocs >>>> client (https://github.com/dakrone/clojuredocs-client) Grimoire now >>>> features every example posted on Clojuredocs. >>>> >>>> Ex. >>>> http://www.arrdem.com/grimoire/1.6.0/clojure.core/DASH__GT__GT/#example-0 >>>> >>>> Currently at 0.0.13, which represents a slew of changes since the >>>> original announcement including the dropping of 1.5.1 as a documented >>>> version (it's a patch release, nothing changed from 1.5.0) and a major >>>> rework of the way I munge symbols and include examples between versions. >>>> >>>> I'd like to give Alex (puredanger) a huge shout out for handing me a >>>> SQL dump of the clojuredocs examples table right after I got a dakrone's >>>> client working. >>>> >>>> More tooling thanks to Phil (technomancy), lein's profiles enabled me >>>> to ditch a make target which downloaded old Clojure versions in favor of >>>> simply having one lein profile for each documented Clojure version. >>>> >>>> >>>> Reid >>>> >>>> On 07/07/2014 04:54 PM, cldwalker wrote: >>>> >>>> Hey Reid, >>>> >>>> Nice work! I think this is a much more maintainable approach for a >>>> community-based examples repository. Have you thought about seeding >>>> examples from clojuredocs using their api e.g. >>>> http://api.clojuredocs.org/examples/1.3.0/clojure.core/map? I think >>>> this would help if the goal is to become the canonical site for clojure fn >>>> examples. >>>> >>>> It is worth noting that clojuredocs is undergoing a rewrite, >>>> https://github.com/zk/clojuredocs/tree/clj-rewrite. If this rewrite >>>> lands soon than it may be worth adding a Motivation section to the home >>>> page to distinguish it from clojuredocs.org. >>>> >>>> On Tuesday, July 1, 2014 7:34:38 PM UTC-4, Reid McKenzie wrote: >>>>> >>>>> Hey guys, >>>>> >>>>> If you're like me while using clojure.repl/doc works for the most part >>>>> there are just times that you need to send someone a link to the >>>>> official docs and navigating the docstrings in the core Clojure >>>>> repository is a pain. >>>>> >>>>> After several months of being frustrated that clojuredocs is out of >>>>> date, I finally sat down and built an alternative which I'm pleased to >>>>> present here: http://www.arrdem.com/grimoire/ >>>>> >>>>> Grimoire is still alpha and subject to change, especially with regards >>>>> to the example contribution process which needs streamlining beyond >>>>> the >>>>> current "click a link, edit on github and submit a PR". >>>>> >>>> >>>> I think this is a reasonable approach. It's better than having a >>>> login just for clojuredocs. >>>> >>>> >>>>> >>>>> I'd like to give a shout out to César for porting clojure.repl/source >>>>> into the doc generation script and to Nicola for his random usability >>>>> criticisms. >>>>> >>>> >>>> >>>> >>>> Cheers, >>>> Gabriel >>>> >>>> >>>>> >>>>> Reid McKenzie >>>>> >>>> -- >>>> You received this message because you are subscribed to the Google >>>> Groups "Clojure" group. >>>> To post to this group, send email to clo...@googlegroups.com >>>> <javascript:> >>>> Note that posts from new members are moderated - please be patient with >>>> your first post. >>>> To unsubscribe from this group, send email to >>>> clojure+u...@googlegroups.com <javascript:> >>>> For more options, visit this group at >>>> http://groups.google.com/group/clojure?hl=en >>>> --- >>>> You received this message because you are subscribed to the Google >>>> Groups "Clojure" group. >>>> To unsubscribe from this group and stop receiving emails from it, send >>>> an email to clojure+u...@googlegroups.com <javascript:>. >>>> For more options, visit https://groups.google.com/d/optout. >>>> >>>> >>>> -- >>>> You received this message because you are subscribed to the Google >>>> Groups "Clojure" group. >>>> To post to this group, send email to clo...@googlegroups.com >>>> <javascript:> >>>> Note that posts from new members are moderated - please be patient with >>>> your first post. >>>> To unsubscribe from this group, send email to >>>> clojure+u...@googlegroups.com <javascript:> >>>> For more options, visit this group at >>>> http://groups.google.com/group/clojure?hl=en >>>> --- >>>> You received this message because you are subscribed to the Google >>>> Groups "Clojure" group. >>>> To unsubscribe from this group and stop receiving emails from it, send >>>> an email to clojure+u...@googlegroups.com <javascript:>. >>>> For more options, visit https://groups.google.com/d/optout. >>>> >>> >>> >>> >>> -- >>> E: mark....@gmail.com <javascript:> >>> T: http://www.twitter.com/neurotic >>> W: www.compoundtheory.com >>> >>> 2 Devs from Down Under Podcast >>> http://www.2ddu.com/ >>> -- >>> You received this message because you are subscribed to the Google >>> Groups "Clojure" group. >>> To post to this group, send email to clo...@googlegroups.com >>> <javascript:> >>> Note that posts from new members are moderated - please be patient with >>> your first post. >>> To unsubscribe from this group, send email to >>> clojure+u...@googlegroups.com <javascript:> >>> For more options, visit this group at >>> http://groups.google.com/group/clojure?hl=en >>> --- >>> You received this message because you are subscribed to the Google >>> Groups "Clojure" group. >>> To unsubscribe from this group and stop receiving emails from it, send >>> an email to clojure+u...@googlegroups.com <javascript:>. >>> For more options, visit https://groups.google.com/d/optout. >>> >> >> -- >> You received this message because you are subscribed to the Google >> Groups "Clojure" group. >> To post to this group, send email to clo...@googlegroups.com >> <javascript:> >> Note that posts from new members are moderated - please be patient with >> your first post. >> To unsubscribe from this group, send email to >> clojure+u...@googlegroups.com <javascript:> >> For more options, visit this group at >> http://groups.google.com/group/clojure?hl=en >> --- >> You received this message because you are subscribed to the Google Groups >> "Clojure" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to clojure+u...@googlegroups.com <javascript:>. >> For more options, visit https://groups.google.com/d/optout. >> > > -- > You received this message because you are subscribed to the Google > Groups "Clojure" group. > To post to this group, send email to clo...@googlegroups.com <javascript:> > Note that posts from new members are moderated - please be patient with > your first post. > To unsubscribe from this group, send email to > clojure+u...@googlegroups.com <javascript:> > For more options, visit this group at > http://groups.google.com/group/clojure?hl=en > --- > You received this message because you are subscribed to the Google Groups > "Clojure" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to clojure+u...@googlegroups.com <javascript:>. > For more options, visit https://groups.google.com/d/optout. > > > -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clojure@googlegroups.com Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en --- You received this message because you are subscribed to the Google Groups "Clojure" group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
