incubator-sling-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robert Munteanu (Confluence)" <conflue...@apache.org>
Subject [CONF] Apache Sling > Sling IDE tooling User Guide
Date Mon, 30 Sep 2013 09:13:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/en/2176/1/1/_/styles/combined.css?spaceKey=SLING&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://cwiki.apache.org/confluence/display/SLING/Sling+IDE+tooling+User+Guide">Sling
IDE tooling User Guide</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~rombert">Robert
Munteanu</a>
    </h4>
        <br/>
                         <h4>Changes (0)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-snipped" >...<br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <div class='navmenu' style='float:right; background:white; margin:3px; padding:3px'><p><b>Table
of contents</b></p>
<style type='text/css'>/*<![CDATA[*/
div.rbtoc1380532358070 {margin-left: 1.5em;padding: 0px;}
div.rbtoc1380532358070 ul {margin-left: 0px;padding-left: 10px;}
div.rbtoc1380532358070 li {margin-left: 0px;padding-left: 0px;}

/*]]>*/</style><div class='rbtoc1380532358070'>
<ul>
    <li><a href='#SlingIDEtoolingUserGuide-SlingIDEToolingUserGuide'>Sling IDE
Tooling User Guide</a></li>
<ul>
    <li><a href='#SlingIDEtoolingUserGuide-Prerequisites'>Prerequisites</a></li>
    <li><a href='#SlingIDEtoolingUserGuide-Installation'>Installation</a></li>
    <li><a href='#SlingIDEtoolingUserGuide-Overallconcepts'>Overall concepts</a></li>
    <li><a href='#SlingIDEtoolingUserGuide-Serverdefinition'>Server definition</a></li>
<ul>
    <li><a href='#SlingIDEtoolingUserGuide-Serverconfiguration'>Server configuration</a></li>
</ul>
    <li><a href='#SlingIDEtoolingUserGuide-Contentsync'>Content sync</a></li>
    <li><a href='#SlingIDEtoolingUserGuide-Bundlesync'>Bundle sync</a></li>
    <li><a href='#SlingIDEtoolingUserGuide-Troubleshooting'>Troubleshooting</a></li>
</ul>
</ul></div></div>

<h1><a name="SlingIDEtoolingUserGuide-SlingIDEToolingUserGuide"></a>Sling
IDE Tooling User Guide</h1>

<h2><a name="SlingIDEtoolingUserGuide-Prerequisites"></a>Prerequisites</h2>

<p>The Sling IDE tooling is known to work on Eclipse versions starting with Indigo.
There is a hard dependency on the faceted project framework, which is included in the 'Eclipse
IDE for Java EE Developers' package. If you're running a different package, you can always
install it from the main Eclipse update site.</p>

<p>There is an optional feature which relies on m2eclipse. For now it only provides
project creation wizards, so if you don't use Maven you don't have to install it.</p>

<h2><a name="SlingIDEtoolingUserGuide-Installation"></a>Installation</h2>

<p>There is no official release yet, but I ( <a href="/confluence/display/~rombert"
class="confluence-userlink" data-username="rombert" >Robert Munteanu</a> ) am maintaining
unnoficial preview builds at <a href="http://people.apache.org/~rombert/sling/ide/preview/"
class="external-link" rel="nofollow">http://people.apache.org/~rombert/sling/ide/preview/</a>
. Feel tree to give them a try.</p>

<h2><a name="SlingIDEtoolingUserGuide-Overallconcepts"></a>Overall concepts</h2>

<p>The Sling IDE tooling is centered around the Server and Module concepts. A Server
is an instance of a Sling launchpad - or derivatives such as Adobe CQ - on which you deploy
your content. A Module is a collection of resources grouped into a single Eclipse project
which can be deployed onto one or multiple Servers.</p>

<p>The tooling supports content and bundle modules. Content modules typically hold Sling
scripts - like JSP and ESP files, client-side resources like CSS and JSS file, but also arbitrary
repository content. Bundle modules represent a single OSGi bundle.</p>

<h2><a name="SlingIDEtoolingUserGuide-Serverdefinition"></a>Server definition</h2>

<p>To create a new Sling launchpad server you will need to start a Sling launchpad outside
of Eclipse. We do not yet support starting Sling Launchpad instances from Eclipse.</p>

<p>To kick off, create a new Sling Launchpad Server using the File -&gt; New -&gt;
Other... menu entry.</p>

<p><span class="image-wrap" style=""><img src="http://i.imgur.com/3fiv3wY.png"
style="border: 1px solid black" /></span></p>

<p>In the resulting wizard, select the External Sling Launchpad category and enter the
host name.</p>

<p><span class="image-wrap" style=""><img src="http://i.imgur.com/UFDeNbC.png"
style="border: 1px solid black" /></span></p>

<p>Once that is done, press finish.</p>

<h3><a name="SlingIDEtoolingUserGuide-Serverconfiguration"></a>Server configuration</h3>

<p>The server will appear in the servers view. You can double-click on it to review
the settings which were automatically provided.</p>

<p><span class="image-wrap" style=""><img src="http://i.imgur.com/uYbE808.png"
style="border: 1px solid black" /></span></p>

<p>There are a couple of important settings in the server definition page:</p>

<ul>
	<li>port: used for connecting to the server</li>
	<li>publishing interval: controls how fast the resources will be published after a
change. We recommend setting the interval to 0, for fast deploy times</li>
	<li>username, password, context path: controls the connection details to the CQ instance.</li>
	<li>debug port: used for connecting in debug mode</li>
</ul>


<p><span class="image-wrap" style=""><img src="http://i.imgur.com/1HJqjOv.png"
style="border: 1px solid black" /></span></p>

<p>You can now connect to the server</p>

<h2><a name="SlingIDEtoolingUserGuide-Contentsync"></a>Content sync</h2>

<h2><a name="SlingIDEtoolingUserGuide-Bundlesync"></a>Bundle sync</h2>

<h2><a name="SlingIDEtoolingUserGuide-Troubleshooting"></a>Troubleshooting</h2>
    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;" class="grey">
                        <a href="https://cwiki.apache.org/confluence/users/removespacenotification.action?spaceKey=SLING">Stop
watching space</a>
            <span style="padding: 0px 5px;">|</span>
                <a href="https://cwiki.apache.org/confluence/users/editmyemailsettings.action">Change
email notification preferences</a>
</div>
        <a href="https://cwiki.apache.org/confluence/display/SLING/Sling+IDE+tooling+User+Guide">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=34024323&revisedVersion=7&originalVersion=6">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/SLING/Sling+IDE+tooling+User+Guide?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message