[Neuroimaging] Website Update

Mon Aug 17 16:02:34 CEST 2015

Getting the packages to render dynamically in multiple places from data
objects and the design itself, whether we are in flask, jekyll, or
something else, is non-trivial, however we must first focus on our
implementation strategy - namely that it satisfies:

   - preview via continuous integration
   - easy development workflow
   - deployment to github pages

With the current, we are close, and the issue at hand is rendering paths on
pages that are not at the root. I had originally created a design with core
pages in subfolders as "index.html" (having "nipy.org/blog/index.html seems
to be the only way to achieve a url like "nipy.org/blog"), however this ran
into this formatting issue. I had several ideas:

   - *using special templates for subfolders:* was my first go, but
   generating everything in two seemed redundant and annoying to need to
   update both things. That said, it would work, and I could possibly
   consolidate elements of the main design into one layout, and then just vary
   the includes depending on the level of the page.
   - *Ideal: *would be liquid syntax, a statement that can detect if we are
   in a subdirectory. I had a pretty simple solution
   <https://github.com/vsoch/nipy-jekyll/commit/2ac70c6dee2372be6676848aac9766459f4c57c2#diff-218971ba81da1d7752f7a6e5d6e87789R23>
   that would work for a small set of pages, but of course ran into trouble
   with the blog subpages. For this reason I moved the main pages back to the
   root.
   - *Build custom script: *A solution I thought of this morning would be
   to get the baseurl working for local development and jekyll deployment, and
   then write a quick script to be run after build to find and fix whatever
   absolute paths would break when being rendered on circle. That would go
   after this
   <https://github.com/vsoch/nipy-jekyll/blob/master/circle.yml#L15>.

Looking forward to getting input on this! There are definitely solutions,
and I'm hoping someone might have an idea to satisfy the second bullet.
Don't worry about details of the design for now, the infrastructure is what
must be figured out.

On Mon, Aug 17, 2015 at 4:56 AM, Alexandre ABRAHAM <
abraham.alexandre at gmail.com> wrote:

>
> Those are the snakey thoughts!
>>
>
> Oh, OK.
>
>
>> It's just a fun detail - when you mouse over they correspond to the
>> packages, and you can click on them, and the graphic is produced
>> dynamically from the data.
>>
>
> Yes, I've seen that. But I guess that ball sizes and colors are random?
> Something like a wordcloud seems more useful to me.
>
>
>> Do you see the snake logo?
>>
>
> BTW, the rendering is weird on a big screen: the balls are really far from
> the snake.
>
>
>
>>
>> On Mon, Aug 17, 2015 at 2:23 AM, Alexandre ABRAHAM <
>> abraham.alexandre at gmail.com> wrote:
>>
>>> Hi Vanessa,
>>>
>>> This looks good, maybe a little dry, but good. However, I don't get the
>>> small balls at the top right, what do they represent?
>>>
>>> Alex.
>>>
>>> On Mon, Aug 17, 2015 at 6:46 AM, vanessa sochat <vsochat at stanford.edu>
>>> wrote:
>>>
>>>> I'm not completely convinced that an interactive sidebar-thing is
>>>> really that useful, but it does work nicely on mobile. And for the
>>>> structure of the actual pages for each package, something simple with
>>>> smaller font and a clean sidebar with a link tree would be easiest to
>>>> navigate, akin to sphinx. We possibly will try all these packages only to
>>>> converge onto the simplest form and functionality (something like sphinx?)
>>>> That would be terribly funny and pathetic at the same time, but at least we
>>>> can be confident about robustly investigating options! I'm interested to
>>>> hear what others think, of course on Monday. I'll keep thinking about this.
>>>>
>>>> On Sun, Aug 16, 2015 at 3:18 PM, vanessa sochat <vsochat at stanford.edu>
>>>> wrote:
>>>>
>>>>> Hi Everyone,
>>>>>
>>>>> Here is an update to the site. I've ported it into jekyll
>>>>> <https://github.com/vsoch/nipy-jekyll>, and tested the template on
>>>>> iphone and computer (seems reasonable). I've also gotten it to render the
>>>>> artifacts on circle.ci <https://circleci.com/gh/vsoch/nipy-jekyll/32>,
>>>>> so we could preview PRs (Click "artifact" and then find home.html
>>>>> <https://circle-artifacts.com/gh/vsoch/nipy-jekyll/32/artifacts/0/home/ubuntu/nipy-jekyll/_site/home.html>).
>>>>> However, I've run into a bug with regard to absolute vs. relative paths -
>>>>> when you click the demo link above, the "posts" not being at the base url
>>>>> means they will not be linked or render correctly (for example, here
>>>>> is a link
>>>>> <https://circle-artifacts.com/gh/vsoch/nipy-jekyll/32/artifacts/0/home/ubuntu/nipy-jekyll/_site/code-syntax/index.html>
>>>>> to a post on circle, and you won't see styling because the css/js links are
>>>>> broken)
>>>>>
>>>>> The site works perfectly given that we aren't serving it at a relative
>>>>> path, eg:
>>>>>
>>>>> jekyll serve --baseurl="/"
>>>>>
>>>>> And the challenge is finding a solution that will render locally, on
>>>>> github pages, and circle.ci, and what we need, I think, is some kind
>>>>> of liquid syntax that will detect when we are in a subfolder and render
>>>>> appropriately. I've been messing around with it for 7 hours today and can't
>>>>> figure it out, and I need to ask for help. Could someone else take a look?
>>>>> Likely someone with more experience than me with Jekyll could figure this
>>>>> out in a heartbeat (Ariel?) The plan right now, I'd like to propose, would
>>>>> be to figure out this bug, get it onto a (test) github pages, tweak the
>>>>> details of the content, make proper documentation, and then release to
>>>>> official github pages.
>>>>>
>>>>> Best,
>>>>>
>>>>> Vanessa
>>>>>
>>>>>
>>>>> --
>>>>> Vanessa Villamia Sochat
>>>>> Stanford University
>>>>> (603) 321-0676
>>>>>
>>>>
>>>>
>>>>
>>>> --
>>>> Vanessa Villamia Sochat
>>>> Stanford University
>>>> (603) 321-0676
>>>>
>>>> _______________________________________________
>>>> Neuroimaging mailing list
>>>> Neuroimaging at python.org
>>>> https://mail.python.org/mailman/listinfo/neuroimaging
>>>>
>>>>
>>>
>>> _______________________________________________
>>> Neuroimaging mailing list
>>> Neuroimaging at python.org
>>> https://mail.python.org/mailman/listinfo/neuroimaging
>>>
>>>
>>
>>
>> --
>> Vanessa Villamia Sochat
>> Stanford University
>> (603) 321-0676
>>
>> _______________________________________________
>> Neuroimaging mailing list
>> Neuroimaging at python.org
>> https://mail.python.org/mailman/listinfo/neuroimaging
>>
>>
>
> _______________________________________________
> Neuroimaging mailing list
> Neuroimaging at python.org
> https://mail.python.org/mailman/listinfo/neuroimaging
>
>

-- 
Vanessa Villamia Sochat
Stanford University
(603) 321-0676
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/neuroimaging/attachments/20150817/0c7c789d/attachment.html>