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 Wed, 25 Sep 2013 14:21: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>
        <div id="versionComment">
        <b>Comment:</b>
        Added overall concepts<br />
    </div>
        <br/>
                         <h4>Changes (1)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >There is no official release yet,
but I ( [~rombert] ) am maintaining unnoficial preview builds at http://people.apache.org/~rombert/sling/ide/preview/
. Feel tree to give them a try. <br> <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h2.
Overall concepts <br> <br>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. <br>
<br>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. <br> <br></td></tr>
            <tr><td class="diff-unchanged" >h2. Server definition <br> <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <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=5&originalVersion=4">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