You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@marmotta.apache.org by wi...@apache.org on 2013/02/19 11:55:43 UTC

svn commit: r1447665 - /incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt

Author: wikier
Date: Tue Feb 19 10:55:43 2013
New Revision: 1447665

URL: http://svn.apache.org/r1447665
Log:
added marmotta's web site howto, based on the stanbol one

Added:
    incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt

Added: incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt
URL: http://svn.apache.org/viewvc/incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt?rev=1447665&view=auto
==============================================================================
--- incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt (added)
+++ incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt Tue Feb 19 10:55:43 2013
@@ -0,0 +1,47 @@
+How to update the Marmotta website
+---------------------------------
+
+INTRO
+-----
+The http://incubator.apache.org/marmotta/ is managed by the ASF CMS
+(http://cms.apache.org).
+
+All Marmotta committers have read-write access to the website content,
+but it's good practice to discuss big changes on the dev list in advance.
+
+Content is provided in markdown structured text format, see cms.a.o for
+pointers to syntax and conventions.
+
+See also http://wiki.apache.org/general/ApacheCms2010 for help and links.
+
+WORKING IN SVN
+--------------
+Committing content under
+  https://svn.apache.org/repos/asf/incubator/marmotta/site/trunk
+causes a staging build of the website to be executed.
+
+The staged content becomes available under 
+  http://marmotta.staging.apache.org/
+
+The build process can be followed at 
+  http://ci.apache.org/builders/marmotta-site-staging
+
+See the existing content for how to add images and additional files.
+
+To push the changes in production, connect to
+  https://cms.apache.org/marmotta/publish 
+with your LDAP credentials (as set on people.apache.org).
+
+BROWSER-BASED EDITING AND PUBLISHING
+------------------------------------
+Starting at https://cms.apache.org/marmotta/ , one can get a working copy, 
+edit it if needed (with simple preview) and publish it to the live site.
+
+THAT'S IT
+---------
+The Apache CMS is a simple tool compared to some of the CMS we're used to.
+
+The nice thing is that the workflow happens in svn, so it's no different
+than what we do for code.
+
+Enjoy.



Re: svn commit: r1447665 - /incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt

Posted by Sergio Fernández <wi...@apache.org>.
Thanks, Daniel!

In r1447684 I tried to address those and other issues of the howto document.

On 19/02/13 12:13, Daniel Shahaf wrote:
> [ Sergio mentioned this on the infra IRC channel, which prompted me to
> review it. ]
>
> On Tue, Feb 19, 2013 at 10:55:43AM -0000, wikier@apache.org wrote:
>> Author: wikier
>> Date: Tue Feb 19 10:55:43 2013
>> New Revision: 1447665
>>
>> URL: http://svn.apache.org/r1447665
>> Log:
>> added marmotta's web site howto, based on the stanbol one
>>
>> Added:
>>      incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt
>>
>> Added: incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt
>> URL: http://svn.apache.org/viewvc/incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt?rev=1447665&view=auto
>> ==============================================================================
>> --- incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt (added)
>> +++ incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt Tue Feb 19 10:55:43 2013
>> @@ -0,0 +1,47 @@
>> +How to update the Marmotta website
>> +---------------------------------
>> +
>> +INTRO
>> +-----
>> +The http://incubator.apache.org/marmotta/ is managed by the ASF CMS
>
> Broken link, should be marmotta.incubator.a.o.
>
>> +(http://cms.apache.org).
>> +
>
> This link just redirects to https, so you might as well link to https directly.
>
> Since this is a public file, assume non-committers will read it, so perhaps
> mention the option of anonymous logins (and patch generation) via the CMS UI.
>
>> +All Marmotta committers have read-write access to the website content,
>> +but it's good practice to discuss big changes on the dev list in advance.
>> +
>> +Content is provided in markdown structured text format, see cms.a.o for
>> +pointers to syntax and conventions.
>> +
>> +See also http://wiki.apache.org/general/ApacheCms2010 for help and links.
>
> That page is probably out of date?  http://www.apache.org/dev/cmsref is the
> canonical one.  (as well as /cms and /cmsadoption)
>
>> +To push the changes in production, connect to
>> +  https://cms.apache.org/marmotta/publish
>> +with your LDAP credentials (as set on people.apache.org).
>> +
>
> If it's not clear: "LDAP creds" are the svn username+password.  (Some people
> use key-based logins to people.a.o)
>
>>
>
> Daniel
> (not subscribed, CC please)
>

-- 
Sergio Fernández

Re: svn commit: r1447665 - /incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt

Posted by Sergio Fernández <wi...@apache.org>.
Thanks, Daniel!

In r1447684 I tried to address those and other issues of the howto document.

On 19/02/13 12:13, Daniel Shahaf wrote:
> [ Sergio mentioned this on the infra IRC channel, which prompted me to
> review it. ]
>
> On Tue, Feb 19, 2013 at 10:55:43AM -0000, wikier@apache.org wrote:
>> Author: wikier
>> Date: Tue Feb 19 10:55:43 2013
>> New Revision: 1447665
>>
>> URL: http://svn.apache.org/r1447665
>> Log:
>> added marmotta's web site howto, based on the stanbol one
>>
>> Added:
>>      incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt
>>
>> Added: incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt
>> URL: http://svn.apache.org/viewvc/incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt?rev=1447665&view=auto
>> ==============================================================================
>> --- incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt (added)
>> +++ incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt Tue Feb 19 10:55:43 2013
>> @@ -0,0 +1,47 @@
>> +How to update the Marmotta website
>> +---------------------------------
>> +
>> +INTRO
>> +-----
>> +The http://incubator.apache.org/marmotta/ is managed by the ASF CMS
>
> Broken link, should be marmotta.incubator.a.o.
>
>> +(http://cms.apache.org).
>> +
>
> This link just redirects to https, so you might as well link to https directly.
>
> Since this is a public file, assume non-committers will read it, so perhaps
> mention the option of anonymous logins (and patch generation) via the CMS UI.
>
>> +All Marmotta committers have read-write access to the website content,
>> +but it's good practice to discuss big changes on the dev list in advance.
>> +
>> +Content is provided in markdown structured text format, see cms.a.o for
>> +pointers to syntax and conventions.
>> +
>> +See also http://wiki.apache.org/general/ApacheCms2010 for help and links.
>
> That page is probably out of date?  http://www.apache.org/dev/cmsref is the
> canonical one.  (as well as /cms and /cmsadoption)
>
>> +To push the changes in production, connect to
>> +  https://cms.apache.org/marmotta/publish
>> +with your LDAP credentials (as set on people.apache.org).
>> +
>
> If it's not clear: "LDAP creds" are the svn username+password.  (Some people
> use key-based logins to people.a.o)
>
>>
>
> Daniel
> (not subscribed, CC please)
>

-- 
Sergio Fernández

Re: svn commit: r1447665 - /incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt

Posted by Daniel Shahaf <da...@apache.org>.
[ Sergio mentioned this on the infra IRC channel, which prompted me to
review it. ]

On Tue, Feb 19, 2013 at 10:55:43AM -0000, wikier@apache.org wrote:
> Author: wikier
> Date: Tue Feb 19 10:55:43 2013
> New Revision: 1447665
> 
> URL: http://svn.apache.org/r1447665
> Log:
> added marmotta's web site howto, based on the stanbol one
> 
> Added:
>     incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt
> 
> Added: incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt
> URL: http://svn.apache.org/viewvc/incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt?rev=1447665&view=auto
> ==============================================================================
> --- incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt (added)
> +++ incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt Tue Feb 19 10:55:43 2013
> @@ -0,0 +1,47 @@
> +How to update the Marmotta website
> +---------------------------------
> +
> +INTRO
> +-----
> +The http://incubator.apache.org/marmotta/ is managed by the ASF CMS

Broken link, should be marmotta.incubator.a.o.

> +(http://cms.apache.org).
> +

This link just redirects to https, so you might as well link to https directly.

Since this is a public file, assume non-committers will read it, so perhaps
mention the option of anonymous logins (and patch generation) via the CMS UI.

> +All Marmotta committers have read-write access to the website content,
> +but it's good practice to discuss big changes on the dev list in advance.
> +
> +Content is provided in markdown structured text format, see cms.a.o for
> +pointers to syntax and conventions.
> +
> +See also http://wiki.apache.org/general/ApacheCms2010 for help and links.

That page is probably out of date?  http://www.apache.org/dev/cmsref is the
canonical one.  (as well as /cms and /cmsadoption)

> +To push the changes in production, connect to
> +  https://cms.apache.org/marmotta/publish 
> +with your LDAP credentials (as set on people.apache.org).
> +

If it's not clear: "LDAP creds" are the svn username+password.  (Some people
use key-based logins to people.a.o)

> 

Daniel
(not subscribed, CC please)


Re: svn commit: r1447665 - /incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt

Posted by Daniel Shahaf <da...@apache.org>.
[ Sergio mentioned this on the infra IRC channel, which prompted me to
review it. ]

On Tue, Feb 19, 2013 at 10:55:43AM -0000, wikier@apache.org wrote:
> Author: wikier
> Date: Tue Feb 19 10:55:43 2013
> New Revision: 1447665
> 
> URL: http://svn.apache.org/r1447665
> Log:
> added marmotta's web site howto, based on the stanbol one
> 
> Added:
>     incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt
> 
> Added: incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt
> URL: http://svn.apache.org/viewvc/incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt?rev=1447665&view=auto
> ==============================================================================
> --- incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt (added)
> +++ incubator/marmotta/site/trunk/WEBSITE-HOWTO.txt Tue Feb 19 10:55:43 2013
> @@ -0,0 +1,47 @@
> +How to update the Marmotta website
> +---------------------------------
> +
> +INTRO
> +-----
> +The http://incubator.apache.org/marmotta/ is managed by the ASF CMS

Broken link, should be marmotta.incubator.a.o.

> +(http://cms.apache.org).
> +

This link just redirects to https, so you might as well link to https directly.

Since this is a public file, assume non-committers will read it, so perhaps
mention the option of anonymous logins (and patch generation) via the CMS UI.

> +All Marmotta committers have read-write access to the website content,
> +but it's good practice to discuss big changes on the dev list in advance.
> +
> +Content is provided in markdown structured text format, see cms.a.o for
> +pointers to syntax and conventions.
> +
> +See also http://wiki.apache.org/general/ApacheCms2010 for help and links.

That page is probably out of date?  http://www.apache.org/dev/cmsref is the
canonical one.  (as well as /cms and /cmsadoption)

> +To push the changes in production, connect to
> +  https://cms.apache.org/marmotta/publish 
> +with your LDAP credentials (as set on people.apache.org).
> +

If it's not clear: "LDAP creds" are the svn username+password.  (Some people
use key-based logins to people.a.o)

> 

Daniel
(not subscribed, CC please)