# Projects in &quanta;

## New Projects

The &quanta; project wizard ( Project New Project ) makes project creation a breeze.

The fields are pretty straight forward and are best filled in from top to bottom as filling in the project name will relieve you of some effort of typing in all the directory structure for the rest of the project. However, we're open source and will not limit your uses of this program. All of these paths and author information fields are configurable at this point and later from the F7 Project Project Options menu tree on the General Tab.

Project Name

  This is the name of your project. Whatever you wish to call it. For means of example, we'll call ours foo. As you type into this field you'll notice that the Project destination, source file, templates and toolbars fields all fill in with default values. All paths in this project will be set relative to the current users home directory where the destination directory will be set to $HOME/<Lower-Case-Project-Name-Without-Spaces> (e.g. $HOME/foo/ is the destination directory).

Project destination

  This is the directory where all of the project files will be stored. By default, this is $HOME/foo where foo is the name of your project in all lower case letters.

Project source file

  This is the name of the &quanta; project file. By default it is the name of your project in lower case letters without whitespace with the webprj extension (e.g. foo.webprj). This file is stored in the root of the Project destination directory.

Project templates

  This is where the templates for this project will be stored. By default it is <Project destination>/templates. If you have a common set of files that you use for several projects, it may be useful to point this there instead of the default.

Project toolbars

  This is where the toolbars for this project will be stored. By default it is <Project destination>/toolbars. If you have a common set of toolbars that you use for several projects, it may be useful to point this there instead of the default.

Author

  Insert your name (or alias) here.

Email

  Email where you'd like things regarding this project to go. Hopefully, it belongs to you.

Project Sources

  Add local files

    This allows you to get files from the local filesystem. You can choose multiple files or entire directories. Use of kio slaves is not allowed.

  Use wget to download files from site

    This option is great if you have static web content that you wish to download and modify. For server side scripting (a la PHP, Python, etc.) you'll have to get the files another way.

The last screen of the new project wizard has 3 settings that can make your life easier. These settings are avialable for change from the F7 Project Project Options menu tree on the Network Tab.

Use preview prefix

  This allows you to set the path prefix to something other than your local filesystem. This is most useful for pages that contain dynamic content and are dependent on server processing (like PHP, JSS, Python, etc.). Simply type in the first portion of the address as it exists on that server and the filepath at the end will be complete by quanta. For example, if you have the domain bar.com and you're editng the index.html page, you could edit it on your remote machine (foo.bar.com), upload it to the server and press F6 to see the results from www.bar.com instead of your local filesystem.

Insert global templates

  This makes a copy of the global templates in your projects directory tree.

Insert local templates

  This makes a copy of the local templates in your projects directory tree.

## Using projects

Robert
Nickel

### Project files

By default &quanta; will open the last project accessed when launched. This behavior is not currently configurable.

To open another project, select Open from the Project menu or the Open Project icon on the toolbar. The open project dialog will pop up and allow you to choose the project you wish. Projects have a webprj extension.

When closing &quanta;, your project file will be saved automatically. You will be asked to save any changes before exiting if &quanta; detects any changed files. This same behavior occurs if you load a new project.

Robert
Nickel

### The Project Tree View

The project tree view gives you uncluttered access to the files in your project. This is where you manage the files in the current project.

For files, a right mouse button (RMB) click brings up the following menu:

These items are fairly self-explanatory and will be left to the reader for exploration.

Directories are similar and are just missing the Open with and Open in &quanta; RMB menu items:

These items are left to the reader for exploration as well.

Robert
Nickel

### Uploading Projects

The upload projects dialog:

Host

  This is the hostname of the server your copying the files to. Either fully qualified domain name, or an ip address will work.

Protocol

  Transfer protocol to use for this upload. Depending on your version of KDE and whether you've downloaded extra kio slaves, this list will vary. At the very least you should be able to choose from ftp, file and nfs.

Path

  This is the base path on the remote host that you will be copying files to.

Port

  Port for the transfer. Usually this won't need to be bothered unless your network administrator is hosting a service on a port other than it's well known port.

User/Password

  User name to use for authentication. If you're using Linux and I need to explain this to you, send me an email for your slap! ;-)

Keep Password

  Depending on your level of paranoia, this is a good or bad feature. Use it at your discretion. FYI, the password is kept ??? and is clear text.

All button

  Select all files in your project for upload.

Modified button

  Select all modified files for upload.

Clear button

  Unselects all files in the list.

Upload button

  Duh! Beam 'em up Scotty.

Cancel button

  This will abort your transfer in progress or just exit out of the dialog if you change your mind before starting the upload.