[vtk-developers] [EXTERNAL] Re: Request for feedback: Gitlab examples wiki

[Aron Helser]

The automatically generated list of examples is looking quite good - the
clean look of the wiki suits the content well, I think.

I pointed out two examples of an image gallery I liked during the hackathon
- First https://d3js.org/, which has a hand-picked gallery of examples as
the banner "image" explaining what d3.js is.
The second and more applicable example was https://bl.ocks.org/mbostock, or
https://bl.ocks.org/ which is an automatically generated gallery of all
examples (possibly filtered to those written by the author of d3).  Once
you click an example, it is interactive, because they are all done in
javascript.

Anyone can contribute to bl.ocks.org, and each example is backed by a
github 'gist', like https://gist.github.com/mbostock/4063269
This setup makes it very easy to work with single examples, and fork them
to make your own versions.

I don't propose that this is the right approach for VTK, but for ideas or
inspiration.
Thanks,
Aron

On Wed, May 3, 2017 at 11:35 AM, Bill Lorensen <bill.lorensen at gmail.com>
wrote:

> Jon,
>
> Thanks for the feedback. All of the pages on the wiki are generated from
> the repo. I think I can generate a gallery of images. Still some cleanup
> before I get to that.
>
> Bill
>
> On Wed, May 3, 2017 at 11:32 AM, Jon Haitz Legarreta <
> jhlegarreta at vicomtech.org> wrote:
>
>> Nice job Bill. Thanks.
>>
>> Despite the limitations you have identified, I think transitioning to
>> gitlab makes it easier for people to use the examples resource, and also,
>> easier to maintain the VTK eco-system.
>>
>> The yet-to-come steps to add an example will also be a nice addition.
>>
>> IMHO, the right pane could be helpful if it were a true index of the
>> sections so that one could easily switch between them without scrolling
>> back to the top of the page, and if it could be collapsed.
>>
>> I think this is a step yet too distant, but having an image gallery
>> instead of (or in addition to) a list would be helpful for such cases in
>> which the person seeks by a visualization rather than by the filter name.
>> It may happen that we have difficulties in identifying the right name/class
>> in the class index. I think someone pointed an example during the
>> hackathon, but as pointed then, the wiki is not well adapted to that.
>>
>> May be sharing that could be useful in case someone has a better idea, or
>> else just for the records.
>>
>> JON HAITZ
>>
>>
>> --
>>
>>
>> On 3 May 2017 at 01:00, Scott, W Alan <wascott at sandia.gov> wrote:
>>
>>> Very nice.  Well done.
>>>
>>>
>>>
>>> *From:* vtk-developers [mailto:vtk-developers-bounces at vtk.org] *On
>>> Behalf Of *Will Schroeder
>>> *Sent:* Tuesday, May 2, 2017 1:03 PM
>>> *To:* Bill Lorensen <bill.lorensen at gmail.com>
>>> *Cc:* VTK Developers <vtk-developers at vtk.org>
>>> *Subject:* [EXTERNAL] Re: [vtk-developers] Request for feedback: Gitlab
>>> examples wiki
>>>
>>>
>>>
>>> I am pretty impressed!
>>>
>>>
>>>
>>> The file list doesn't bother me all that much. I'm not sure how to
>>> address the other issues you list. I agree the Camel case problem is
>>> annoying; it'd be nice if this could be fixed.
>>>
>>>
>>>
>>> Great work,
>>>
>>> W
>>>
>>>
>>>
>>> On Tue, May 2, 2017 at 2:46 PM, Bill Lorensen <bill.lorensen at gmail.com>
>>> wrote:
>>>
>>> Folks,
>>>
>>> Time to kick the tires.
>>>
>>> Try https://gitlab.kitware.com/lorensen/VTKExamples/wikis/Home
>>>
>>> I have converted the top level example and cxx example pages.
>>>
>>> The wiki pages are automatically created from the gitlab repo pages.
>>>
>>> Need feedback before proceeding.
>>>
>>> Things I don't like:
>>> 1) Rendering of the large Cxx page is very slow.
>>> 2) I can't get rid of the file list on the right of the page.
>>> 3) gitlab converts the camel case to lower except for the first letter.
>>>
>>> markdown formatting is very limited.
>>>
>>> Bill
>>> _______________________________________________
>>> Powered by www.kitware.com
>>>
>>> Visit other Kitware open-source projects at
>>> http://www.kitware.com/opensource/opensource.html
>>>
>>> Search the list archives at: http://markmail.org/search/?q=
>>> vtk-developers
>>>
>>> Follow this link to subscribe/unsubscribe:
>>> http://public.kitware.com/mailman/listinfo/vtk-developers
>>>
>>>
>>>
>>>
>>>
>>> --
>>>
>>> William J. Schroeder, PhD
>>> Kitware, Inc. - Building the World's Technical Computing Software
>>> 28 Corporate Drive
>>> Clifton Park, NY 12065
>>> will.schroeder at kitware.com
>>> http://www.kitware.com
>>> (518) 881-4902
>>>
>>> _______________________________________________
>>> Powered by www.kitware.com
>>>
>>> Visit other Kitware open-source projects at
>>> http://www.kitware.com/opensource/opensource.html
>>>
>>> Search the list archives at: http://markmail.org/search/?q=
>>> vtk-developers
>>>
>>> Follow this link to subscribe/unsubscribe:
>>> http://public.kitware.com/mailman/listinfo/vtk-developers
>>>
>>>
>>>
>>
>
>
> --
> Unpaid intern in BillsBasement at noware dot com
>
> _______________________________________________
> Powered by www.kitware.com
>
> Visit other Kitware open-source projects at http://www.kitware.com/
> opensource/opensource.html
>
> Search the list archives at: http://markmail.org/search/?q=vtk-developers
>
> Follow this link to subscribe/unsubscribe:
> http://public.kitware.com/mailman/listinfo/vtk-developers
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://public.kitware.com/pipermail/vtk-developers/attachments/20170503/34539142/attachment.html>