You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@edgent.apache.org by Katherine Marsden <km...@apache.org> on 2016/03/02 19:05:20 UTC
Questions on website request
I was thinking for the setup of the website, I would mimic this Jira:
https://issues.apache.org/jira/browse/INFRA-10807 using the template at
https://git-wip-us.apache.org/repos/asf?p=apache-website-template.git
The template uses Jekyll.
With Git Repository name incubator-quarks-website and notification
mailing list commits@quarks.incubator.apache.org
An example of a website developed from the template is
http://systemml.incubator.apache.org
Does this sound like the right approach for initial setup of our site?
Any volunteers to work on site content once it is setup?
Best
Kathey
Re: Questions on website request
Posted by Kathy Saunders <os...@gmail.com>.
On Wed, Mar 2, 2016 at 10:05 AM, Katherine Marsden <km...@apache.org>
wrote:
> I was thinking for the setup of the website, I would mimic this Jira:
>
> https://issues.apache.org/jira/browse/INFRA-10807 using the template at
> https://git-wip-us.apache.org/repos/asf?p=apache-website-template.git
> The template uses Jekyll.
>
I think this a good starting place, and Quarks on Github uses Jekyll as
well, so that fits in with our existing doc content. I think once it is
up, I can make suggestions on how to adjust to give it a Quarks
personality, and I hope others will as well.
Does this sound like the right approach for initial setup of our site? Any
> volunteers to work on site content once it is setup?
>
I want to contribute to the web site. I've been updating links and working
on documentation on the Quarks Github site.
Regards,
Kathy
Re: Questions on website request
Posted by Katherine Marsden <km...@apache.org>.
On 3/3/2016 6:14 AM, Katherine Marsden wrote:
>
> Most of my experience is with svn but I think that for Quarks it makes
> sense to keep everything in git, so am guessing gitpubsub is the way
> to go. I see this blog
> https://blogs.apache.org/infra/entry/git_based_websites_available but
> am having trouble finding more documentation. I guess we need an
> asf-site branch for our repo and then commit the jekyll served website
> to that, then file an INFRA issue to request gitpubsub?
>
I still need guidance on this but found this comment in a Jira issue
that explains how it works:
https://issues.apache.org/jira/browse/INFRA-10249?focusedCommentId=14729921&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-14729921
It says:
"We create a repo for you (generally incubator-apex-site.git)
You create a branch called asf-site
You commit the raw html files to the asf site branch in 1 of two folder
layouts:
$REPO_ROOT/<raw html> **OR** $REPO_ROOT/content/<raw html>
If you opt for the 2nd layout, the *only* thing that can exist in the
root of the repo is the folder called content, otherwise your website
will not work properly.
Also, gitpubsub is not tied into any sort of build system, so you would
have to build the site somehow and then copy over the generated html
file to the repo in the above layout."
The apex repo is at
https://git-wip-us.apache.org/repos/asf?p=incubator-apex-site.git and
looking at the layout it looks like we would maintain the site on the
master branch and create an orphan branch asf-site which has just the
content directory which we create with jekyll serve -d content_tmp on
the master and then mv that to content the asf-branch. If there is a
way to just generate without serving we could have a build script like
apex's build.sh that would publish the site.
Does it sound like I am on the right track here? I appreciate an
assistance.
Kathey
Re: Questions on website request
Posted by Katherine Marsden <km...@apache.org>.
On 3/2/2016 8:16 PM, Luciano Resende wrote:
> In order to get your website published, you need to request either
> svn-pub-sub or git-pub-sub (I only have worked with svn-pub-sub). Once you
> have that, you can ask jekyll to serve the website to the location of the
> svn checkout, something like :
>
> jekyll s -d ../quarks-site-svn
>
> then go to quarks-site-svn and svn add/ svn ci any files you need to
> add/update, and that automagically gets published as the live website.
>
>
Thank you Luciano. The pieces are beginning to come together in my mind,
but it is still kind of fuzzy.
Most of my experience is with svn but I think that for Quarks it makes
sense to keep everything in git, so am guessing gitpubsub is the way to
go. I see this blog
https://blogs.apache.org/infra/entry/git_based_websites_available but am
having trouble finding more documentation. I guess we need an asf-site
branch for our repo and then commit the jekyll served website to that,
then file an INFRA issue to request gitpubsub?
I also have the problem that my work computer is Windows for which I
understand Jekyll is not officially supported, so I am wondering if I am
actually the best person for this website task. I wonder if another
mentor would be willing to take on this task or give me more detailed
steps. If someone wants to walk me through it I can also work on
updating the out of date podling website documentation. I can work from
home tomorrow and use my mac but wouldn't be able to work on this today
from the office.
Best
Kathey
Re: Questions on website request
Posted by Luciano Resende <lu...@gmail.com>.
On Wed, Mar 2, 2016 at 4:49 PM, Katherine Marsden <km...@apache.org>
wrote:
> On 3/2/2016 1:25 PM, Katherine Marsden wrote:
>
>> On 3/2/2016 10:05 AM, Katherine Marsden wrote:
>>
>>> I was thinking for the setup of the website, I would mimic this Jira:
>>>
>>> https://issues.apache.org/jira/browse/INFRA-10807 using the template at
>>> https://git-wip-us.apache.org/repos/asf?p=apache-website-template.git
>>> The template uses Jekyll.
>>>
>>> Thanks Kathy and Alex volunteering to work on the website and validation
>> on the approach. I will go ahead and submit the request in an hour unless
>> I hear objections.
>>
>> Well, Infrastructure worked like lightning within seconds returning with:
> -----
> Repo cloned, url:
> https://git-wip-us.apache.org/repos/asf/incubator-quarks-website.git
>
> I have also added it to the github mirror host and GitHub will pick it up
> at roughly 07:00 UTC.
> ------
>
> But from here I am a bit lost. I read the README.md but am unclear where
> I perform these steps.
>
> I also looked at http://incubator.apache.org/guides/sites.html under
> Publishing The Website (which says it is old).
> It says the website will be under /www/<project>.incubator.apache.org on
> people, but I don't actually see any incubating projects on
> minotaur.apache.org under /www, just top level projects.
>
> How can I get the template published initially just to get something
> working, so we can move forward with updating it for Quarks?
>
>
> Kathey
>
>
>
>
In order to get your website published, you need to request either
svn-pub-sub or git-pub-sub (I only have worked with svn-pub-sub). Once you
have that, you can ask jekyll to serve the website to the location of the
svn checkout, something like :
jekyll s -d ../quarks-site-svn
then go to quarks-site-svn and svn add/ svn ci any files you need to
add/update, and that automagically gets published as the live website.
--
Luciano Resende
http://people.apache.org/~lresende
http://twitter.com/lresende1975
http://lresende.blogspot.com/
Re: Questions on website request
Posted by Katherine Marsden <km...@apache.org>.
On 3/2/2016 1:25 PM, Katherine Marsden wrote:
> On 3/2/2016 10:05 AM, Katherine Marsden wrote:
>> I was thinking for the setup of the website, I would mimic this Jira:
>>
>> https://issues.apache.org/jira/browse/INFRA-10807 using the template at
>> https://git-wip-us.apache.org/repos/asf?p=apache-website-template.git
>> The template uses Jekyll.
>>
> Thanks Kathy and Alex volunteering to work on the website and
> validation on the approach. I will go ahead and submit the request in
> an hour unless I hear objections.
>
Well, Infrastructure worked like lightning within seconds returning with:
-----
Repo cloned, url:
https://git-wip-us.apache.org/repos/asf/incubator-quarks-website.git
I have also added it to the github mirror host and GitHub will pick it
up at roughly 07:00 UTC.
------
But from here I am a bit lost. I read the README.md but am unclear
where I perform these steps.
I also looked at http://incubator.apache.org/guides/sites.html under
Publishing The Website (which says it is old).
It says the website will be under /www/<project>.incubator.apache.org on
people, but I don't actually see any incubating projects on
minotaur.apache.org under /www, just top level projects.
How can I get the template published initially just to get something
working, so we can move forward with updating it for Quarks?
Kathey
Re: Questions on website request
Posted by Katherine Marsden <km...@apache.org>.
On 3/2/2016 10:05 AM, Katherine Marsden wrote:
> I was thinking for the setup of the website, I would mimic this Jira:
>
> https://issues.apache.org/jira/browse/INFRA-10807 using the template at
> https://git-wip-us.apache.org/repos/asf?p=apache-website-template.git
> The template uses Jekyll.
>
Thanks Kathy and Alex volunteering to work on the website and validation
on the approach. I will go ahead and submit the request in an hour
unless I hear objections.
Re: Questions on website request
Posted by Alexander Cook <ac...@umn.edu>.
I will volunteer to work on site content and design once things are setup.
I'm used to working in Github, so will probably need some help with
actually contributing the content and how to get feedback from the
community.
I believe that should be fine as an initial setup.
Best,
Alex
On Wed, Mar 2, 2016 at 7:05 PM, Katherine Marsden <km...@apache.org>
wrote:
> I was thinking for the setup of the website, I would mimic this Jira:
>
> https://issues.apache.org/jira/browse/INFRA-10807 using the template at
> https://git-wip-us.apache.org/repos/asf?p=apache-website-template.git
> The template uses Jekyll.
>
> With Git Repository name incubator-quarks-website and notification
> mailing list commits@quarks.incubator.apache.org
>
> An example of a website developed from the template is
> http://systemml.incubator.apache.org
>
> Does this sound like the right approach for initial setup of our site? Any
> volunteers to work on site content once it is setup?
>
> Best
>
> Kathey
>
>