Working With Your Project's WebsiteAs described at Managing a Project: Website, if you want your own web site for a project on netbeans.org, you use a WebDAV client to upload the files to https://netbeans.org/website/your-project-name.
Some operating systems have WebDAV built in, and some require that you install a WebDAV client.
- The OSX Finder's WebDAV works well on Apple Macintosh OSX machines.
- The WebDAV client for the File Explorer in Microsoft Windows XP does not work well, so you'll need to install a WebDAV client, as described below.
- Linux OS's have various ways of supporting WebDAV, for example, through KDE and Gnome, with the Cadaver client, or with Konqueror.
- Linux OS's can also use the davfs2 file system instead of WebDAV clients.
Before installing a separate client, try using your operating system's WebDAV to see if it works.
On Macintosh OSX systems, you can use the Finder to connect to a WebDAV server. Here's how you do that:
- In the Finder, choose Go > Connect to Server.
- In the Server Address field, enter https://netbeans.org/website/your-project-name.
- If you want to add the server permanently, click the + button.
- To connect to the server, click Connect.
- When prompted for authentication, enter your netbeans.org username and password.
- Use either drag and drop or the command line to copy files to the netbeans.org directory.
- Drag and Drop: Drag local files or directories to the remote website directory
- Command Line: Copy files or subdirectories from your local machine to the website directory. For example:
cp local_files /Volumes/project_name.
At present, our Linux documentation covers Kubuntu 9.04 with the KDE 4 desktop and using the davfs2 file system. We plan to add documentation for more Linux systems as we get more information on them. Some options reported to be available are direct support through Gnome and support through the Cadaver client.
These instructions, supplied by a Project Kenai member, are for Kubuntu 9.04 with the KDE 4 desktop.
In KDE 4, you can use the KDE default file explorer, Dolphin, to access the website with WebDAV. With KDE 3.5, you can use Konqueror for WebDAV access.
To use Dolphin for WebDAV access:
- Start Dolphin and enter the following URL in the address bar:
- You see your website in Dolphin. The first time you create or modify something, you will be asked for a username and password. Use your netbeans.org username and password.
- You can work in Dolphin the same way as on a local drive. You can create folders and files, upload and copy files with drag and drop, overwrite files, and so on.
Note: Trying to delete a folder can return Error Code 301. This might be due to the following KDE bug: KDE [Bug 187970]: "Dolphin webdav avoids to remove folders in mydisk.se with code 301."
As described at http://savannah.nongnu.org/projects/davfs2, davfs2 enables you to access WebDAV resources as though they were a typical filesystem, which means that standard applications that have no built-in support for WebDAV can use these resources.
To use davfs2:
- Install davfs2 on your machine.
- Mount your website directory. For example,
sudo mount -t davfs https://kenai.com/website/project_name/where_to_mount
Note: Write access to the mounted directory requires that you use sudo.
- After finishing your work, just umount the directory. All changes should be synchronized and updated. If the data is not synchronized, use the sync command before you unmount.
A free WebDAV client, BitKinex, is available for Microsoft Windows XP and Vista. You can download it from http://www.bitkinex.com/download.php.
- After installing BitKinex, click its icon to run it.
- Select the Http/WebDAV node.
- Choose Data Source > New > Http/WebDAV.
- Enter a name for the new data source and click it.
- Make sure Server is selected in the tree on the left.
- For Server address, enter netbeans.org.
- For Security, choose SSL.
- Enter your netbeans.org username and password.
- Click Site Map under the Server node on the left.
- Double-click the / entry under Path and change it to /website/your-project-name/.
For example, for the help project, whose project home page URL is http://netbeans.org/projects/help, you would enter /website/help/.
- Make sure that The location specifies: is set to Directory (WebDAV-compliant).
- Click Update.
- Click OK at the bottom of the dialog.
BitKinex should now be set up to work with your project's web site location on netbeans.org.
After setting up BitKinex to work with your project, you have a node for your project under the Http/WebDAV node when BitKinex first opens. Basically, you click that node, establish a connection, and transfer files to netbeans.org. You can also delete files on netbeans.org with BitKinex, and you can replace files by uploading new versions.
To use BitKinex with your project's Website directory:
- Double-dlick the node for your project under the Http/WebDAV node.
- You see the connection window open.
- To populate your netbeans.org web site, click and drag files from your local machine on the right to the server directory on the left.
- You can work directly with files and directories on the server. For example, if you right-click a server directory, you see a menu with choices like New > Directory or File.
- BitKinex comes with a set of help files for when you get stuck. Most of the operations are similar to using a file browser on Windows.