summaryrefslogtreecommitdiffstats
path: root/quanta/data/doc/faq.html
blob: 2f5fb651e6b7260d2fe86e3c669b1cdb7c409536 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
 <head>
  <title>Konquer the Web with Quanta Plus!</title>
  <link rel="stylesheet" href="konq.css" type="text/css" />
  <link rel="stylesheet" href="quanta.css" type="text/css" />
 </head>
 <body>
  <div style="position:absolute; left: 0px; top: 5px; right: 0px; bottom: 500px;">
   <a name="top" />
   <table width="100%" cellpadding="0" cellspacing="0">
    <colgroup>
     <col width="170" />
     <col width="20" />
     <col width="309" />
     <col width="*" />
    </colgroup>
    <tr>
     <td align="right" class="bla"><img width="77" height="22" src="aniquanta.gif" alt="Quanta Plus" /></td>
     <td class="deco" colspan="3">Konquer the Web with Quanta Plus!</td>
    </tr>
    <tr>
     <td colspan="2" rowspan="2"> &nbsp;</td>
     <td><img width="309" height="77" src="quantahdr.png" alt="Quanta Plus" /></td>
     <td class="blah"><img src="webdev.png" width="135" height="77" alt="Web Develop Environment" /></td>
    </tr>
    <tr>
     <td colspan="2" align="right" class="bla">
      <table cellpadding="0" cellspacing="0">
       <tr>
        <td height="20" class="menu">&nbsp; <a class="menu" href="intro.html">Introduction</a> &nbsp;</td><!-- Introduction -->
        <td height="20" class="menu">|</td>
        <td height="20" class="menuactive">&nbsp; FAQ &nbsp;</td><!-- FAQ -->
        <td height="20" class="menu">|</td>
        <td height="20" class="menu">&nbsp; <a class="menu" href="tips.html">Tips</a> &nbsp;</td><!-- Tips -->
        <td height="20" class="menu">|</td>
        <td height="20" class="menu">&nbsp; <a class="menu" href="focus.html">Where we're going</a> &nbsp;</td>
        <td height="20" class="menu">|</td>
        <td height="20" class="menu">&nbsp;  <a class="menu" href="developer.html">Developer Info</a> &nbsp;</td><!-- Specifications -->
        <td height="20" class="menu">&nbsp;</td>
       </tr>
      </table>
     </td>
    </tr>
    <tr>
     <td colspan="2" width="190"></td>
     <td colspan="2" class="shadow1" height="9"></td>
    </tr>
    <tr>
     <td colspan="2" width="190"></td>
     <td colspan="2" height="41"></td>
    </tr>
   </table>
   <!-- end of header -->
   <table width="100%" cellpadding="0" cellspacing="0">
    <tr>
     <td width="190"></td>
     <td class="trans">
      <table width="100%" cellpadding="0" cellspacing="0">
       <tr>
        <td height="20" width="20">&nbsp;</td>
        <td>&nbsp;</td>
       </tr>
       <tr>
        <td width="20">&nbsp;</td>
        <td valign="top">
         <!-- here comes the content -->
         <h2><span class="firstchar">Q</span>uanta Plus FAQ</h2>
          <ul>
           <li><a href="#1" class="olhead">1.&nbsp;&nbsp;What is Quanta Plus?</a></li>
           <li><a href="#2" class="olhead">2.&nbsp;&nbsp;How do I install Quanta Plus?</a>
            <ul>
             <li><a href="#2.1" class="olhead">2.1&nbsp;&nbsp;Quanta Plus binary packages?</a></li>
             <li><a href="#2.2" class="olhead">2.2&nbsp;&nbsp;Quanta Plus source code.</a></li>
             <li><a href="#2.3" class="olhead">2.3&nbsp;&nbsp;Compiling Quanta Plus</a></li>
             <li><a href="#2.4" class="olhead">2.4&nbsp;&nbsp;I get error X when running configure</a></li>
             <li><a href="#2.5" class="olhead">2.5&nbsp;&nbsp;I get error X when compiling</a></li>
            </ul>
           </li>
           <li><a href="#3" class="olhead">3.&nbsp;&nbsp;How do I do X? or Can Quanta Plus do X?</a>
            <ul>
             <li><a href="#3.1" class="olhead">3.1&nbsp;&nbsp;How can I open/edit a file on a remote server?</a></li>
             <li><a href="#3.2" class="olhead">3.2&nbsp;&nbsp;Can I run program X from Quanta Plus?</a></li>
            </ul>
           </li>
           <li><a href="#4" class="olhead">4.&nbsp;&nbsp;Is there any documentation for Quanta Plus?</a></li>
           <li><a href="#5" class="olhead">5.&nbsp;&nbsp;How can I help Quanta Plus development?</a></li>
           <li><a href="#6" class="olhead">6.&nbsp;&nbsp;Where is Quanta Plus going from here?</a></li>
          </ul>
          <hr align="left" size="3" width="100%" noshade="noshade" />
          <a name="1" />
          <div class="fltop"><a href="#top">Top</a></div>
          <h2><span class="firstchar">1.  W</span>hat is Quanta Plus?</h2>
          <div class="indent">
           <p>From http://quanta.sourceforge.net/:<br />
            <i>Quanta Plus is a web development tool for the K Desktop Environment (KDE). Quanta Plus is designed for rapid web development and is quickly becoming a mature editor with a number of great features.</i></p>
           <p><i>Our objective remains to create the very best web development tool anywhere. We realize that we will need many more people active to accomplish this so we are in the process of developing enhancements geared toward making it easy for web developers to customize, extend and enhance Quanta Plus. Then we will be asking you, the web developers, to contribute your feature enhancements. We will organize these so that Quanta Plus web developers can find just the resources, extensions and custom plug-ins they need to be the most kick butt developers ever!</i></p>
          </div>
          <a name="2" />
          <div class="fltop"><a href="#top">Top</a></div>
          <h2><span class="firstchar">2. H</span>ow do I install Quanta Plus?</h2>
          <div class="indent">
           <a name="2.1" />
           <div class="minihdr">2.1 Quanta Plus binary packages?</div>
            <div class="indent">
             <p>Most Linux vendors ship with Quanta Plus packages.  Simply use your vendor's installation software to install it. If your vendor does not provide Quanta Plus, then search <a href="http://www.google.com">Goggle.com</a>.</p>
            </div>
            <a name="2.2" />
            <div class="fltop"><a href="#top">Top</a></div>
            <div class="minihdr">2.2 Quanta Plus source code</div>
            <div class="indent">
             <p>There are two versions of the Quanta Plus source code:</p>
             <ol>
              <li>The 3.x formal releases are available from http://sourceforge.net/projects/quanta/ and</li>
              <li>The CVS tree, which is available from anoncvs.kde.org.</li>
             </ol>
             <p>For formal releases, it is just a download, et cetera.  For CVS tree:</p>
             <ul>
              <li>cvs -d:pserver:anonymous@anoncvs.kde.org:/home/kde login</li>
              <li>cvs -d:pserver:anonymous@anoncvs.kde.org:/home/kde co quanta</li>
             </ul>
             <p>When prompted for a password, just press Enter.  This will create a directory called "quanta" as a subdirectory of the directory you ran the above commands in.</p>
            </div>
            <a name="2.3" />
            <div class="fltop"><a href="#top">Top</a></div>
            <div class="minihdr">2.3 Compiling Quanta Plus</div>
            <div class="indent">
             <p>An assumption is made that you have the knowledge and ability to find and install any missing libraries that you may encounter.  Basically, you need the headers from KDE, TQt, and GCC.  If you don't know what was just said, then try the steps below and, if it doesn't work for you, then find yourself a Linux geek that can help.</p>
             <p>Type the following in a shell and see what you get:</p>
             <ul>
              <li>test `echo $KDEDIR` &amp;&amp; echo "yes" || echo "noKDE"</li>
              <li>test `echo $TQTDIR` &amp;&amp; echo "yes" || echo "noQT"</li>
             </ul>
             <p>If you don't get two yes answers, then you need to find the location of the one that failed and export it to your current shell environment.</p>
             <p>Then it is as simple as:</p>
             <pre>
              make -f Makefile.cvs  (Only necessary if you're doing from CVS, but it is a good idea to do so anyway.)
              ./configure
              make
              make install (Run this command as root.)
             </pre>
            </div>
            <a name="2.4" />
            <div class="fltop"><a href="#top">Top</a></div>
            <div class="minihdr">2.4 I get error <i>X</i> when running ./configure</div>
            <div class="indent">
              <p>Please read 2.3 carefully again and make certain that you have exported the $KDEDIR and $TQTDIR environment variables.  This is the most likely cause.  Aside from that, if you are missing something very important, then configure will tell you what it needs.</p>
            </div>
            <a name="2.5" />
            <div class="fltop"><a href="#top">Top</a></div>
            <div class="minihdr">2.5 I get error <i>X</i> when compiling</div>
            <div class="indent">
             <p>Please read 2.3 and make certain that whatever libraries make is looking for are installed on your machine.  How and where to get these libraries is beyond the scope of this FAQ.</p>
            </div>
           </div>
           <a name="3" />
           <div class="fltop"><a href="#top">Top</a></div>
           <h2><span class="firstchar">3.  H</span>ow do I do <i>X</i>? Can Quanta Plus do <i>X</i>?</h2>
           <a name="3.1" />
           <div class="minihdr">3.1.  How can I open/edit a file on a remote server?</div>
           <div class="indent">
            <p>Quanta Plus uses KIO for its file operations. To whit, an e-mail from our benefactor:</p>
            <p><i>Try this. Open the file open dialog... you can do this in the file name, but it's even cooler if you use the directory drop-down up top on the dialog. Enter this: ftp://user@mydomain.com and hit enter. It will prompt you for a password after which it will fill the file dialog with the available files and folders on the site location. You and now navigate your site like you were looking at your local directory, open and save files on line.</i></p>
            <p><i>Two additional facts here. First if you are using projects you can set your project preview option to directly preview from the site and then see PHP files with data live as they would behave on site. Second, this is made possible by KDE's KIO slaves. So any functional KIO slave you have installed brings this same functionality. Try kio_fish for secure file access as well as other slaves for Samba, scp and other protocols.</i></p>
            <p><i>--<br />Eric Laffoon</i></p>
            <p>That should about cover it.</p>
           </div>
           <a name="3.2" />
           <div class="fltop"><a href="#top">Top</a></div>
           <div class="minihdr">3.2.  Can I run program <i>X</i> from Quanta Plus?</div>
           <div class="indent">
            <p>Yes!  Quanta Plus will run almost anything you want as an action. More from our benefactor:</p>
            <p><i>Does Quanta Plus Shell? Hey, we're open source! Quanta Plus has shelled since around version 1.0.1. You can run virtually any program you can run from the command line with Quanta Plus with a wide variety of options.</i></p>
            <p><i>To run HTMLtidy do the following:</i></p>
            <ol>
             <li><i>On the menu go to Settings>Configure Actions. </i></li>
             <li><i>In the dialog click New button and give it a name and icon </i> </li>
             <li><i>Select the script tab and put tidy -i in the script line </i></li>
             <li><i>Select either selected text or current document for input </i></li>
             <li><i>Select your output such as "Replace current document"</i> </li>
             <li><i>On the error tab select "Message window"    </i></li>
             <li><i>Close the dialog and select Settings>Configure Toolbars  </i></li>
             <li><i>Place the new action on the toolbar of your choice </i></li>
            </ol>
            <p><i>Now you can run tidy and if there are errors and you have the message window open it will give you errors. If you have kaptain installed (http://kaptain.sourceforge.net) you can even set parameters for each run.  </i></p>
            <p><i>Enjoy!<br />--<br />Eric Laffoon</i></p>
           </div>
           <a name="4" />
           <div class="fltop"><a href="#top">Top</a></div>
           <h2><span class="firstchar">4.  I</span>s there any documentation for Quanta Plus?</h2>
           <div class="indent">
            <p>Yes, however most are slightly outdated.  They are being worked on currently.  Would you like to help?</p>
           </div>
           <a name="5" />
           <div class="fltop"><a href="#top">Top</a></div>
           <h2><span class="firstchar">5.  H</span>ow can I help Quanta Plus development?</h2>
           <div class="indent">
            <p>I thought you'd never ask!  ;-)</p>
            <p>From Eric:</p>
            <p><i>We would be remiss not to point out that Quanta Plus is being built with volunteer effort. Many people feel they cannot contribute to the open source cause for one reason or another. Probably the greatest being a feeling they do not have the skills. This documentation is writing in HTML... so if you can do that you can help. What is the open source cause? It is giving back to the community to grow something bigger than we could on our own, but it is also a shining hope for those people around the world where getting software for free is not an option, it is the option.</i></p>
            <p><i>We believe in the cause!</i></p>
            <p>If you would like to help out contact Eric Laffoon (<a href="mailto:sequitur@kde.org">sequitur@kde.org</a>).</p>
           </div>
           <a name="6" />
           <div class="fltop"><a href="#top">Top</a></div>
           <h2><span class="firstchar">6.  W</span>here is Quanta Plus going from here?</h2>
           <div class="indent">
            <p><i>We have released Quanta Plus 3.1.3 and are now in preparation for 3.2.  Our objective remains to create the very best web development tool anywhere. We realize that we will need many more people actively developing Quanta Plus to accomplish this, so we are in the process of developing enhancements geared toward making it easy for web developers to customize, extend, and enhance Quanta Plus. Then we will be asking you, the web developers, to contribute your feature enhancements. We will organize these so that Quanta Plus web developers can find just the resources, extensions, and custom plug-ins they need to be the most kick butt developers ever!</i></p>
          </div>
          <img width="16" height="16" src="more.png" alt="&gt;" />&nbsp;<a href="tips.html">Continue</a>
          <!-- End of text -->
        </td>
        <td width="20">&nbsp;</td>
       </tr>
       <tr>
        <td height="20" width="20">&nbsp;</td>
        <td>&nbsp;</td>
       </tr>
      </table>
     </td>
     <td width="20">&nbsp;</td>
    </tr>
    <tr>
     <td height="91" colspan="3">&nbsp;</td>
    </tr>
   </table>
   <table width="100%" cellpadding="0" cellspacing="0">
    <tr>
     <td class="end" width="100%">&nbsp;</td>
     <td align="right"><a href="http://www.kde.org"><img width="204" height="57" src="kdelogo2.png" alt="KDE" /></a></td>
    </tr>
    <tr>
     <td height="50" colspan="2">&nbsp;</td>
    </tr>
   </table>
  </div>
 </body>
</html>