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

Andy Bauer andy.bauer at kitware.com
Wed May 3 14:36:47 EDT 2017


Hi Bill,

Great effort pushing this forward! It looks really good to me.

Cheers,
Andy

On Wed, May 3, 2017 at 1:57 PM, Bill Lorensen <bill.lorensen at gmail.com>
wrote:

> Aron,
>
> That is pretty cool. I think we can do some kind of image gallery to
> navigate the examples.
>
> Bill
>
>
> On Wed, May 3, 2017 at 1:45 PM, Aron Helser <aron.helser at kitware.com>
> wrote:
>
>> 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
>>>
>>>
>>>
>>
>
>
> --
> 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/6d655b40/attachment.html>


More information about the vtk-developers mailing list