Working With Your Project's WebsiteAs described at Managing a Project: Website, after you enable 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.
- Another client to consider is sitecopy, which has binary packages for several versions of Linux, UNIX, OS/2, and Macintosh OSX. It's useful if you want to maintain the website on a local machine and send file updates to the web. See Should I Use Sitecopy? for more information on choosing it.
For a list of WebDAV clients, see http://www.webdav.org/projects/.
Before installing a separate client, try using your operating system's WebDAV to see if it works.
- 1 Using Finder with Macintosh OSX
- 2 Using WebDAV With a Linux System
- 2.1 Using Kubuntu 9.04 With the KDE Desktop
- 2.2 Using the davfs2 File System
- 2.3 Setting Up and Using Sitecopy
- 3 Using BitKinex with Microsoft Windows XP and Vista
Note: Before you can use WebDAV with your project's web site, you must first enable the web site as described at Managing a Project: Website. You can also use sitecopy on a Macintosh system, as described below at Setting Up and Using Sitecopy.
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://netbeans.org/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.
Sitecopy has binary packages for several versions of Linux as well as UNIX, OS/2, and Macintosh OSX. You might want to use it instead of a WebDAV client if you maintain your web site on a local machine and want to use something similar to FTP to work with your kenai.com web site.
To use sitecopy:
- Make sure you have enabled the Website feature for your project on kenai.com, as described at Managing a Project: Website.
- Download and install sitecopy from http://www.manyfish.co.uk/sitecopy/.
Note: For Macintosh OSX, download sitecopy at http://pdb.finkproject.org/pdb/package.php/sitecopyuse and use Fink to install it.
- Create a directory named .sitecopy in your user_dir and give it 0700 permissions. For example:
chmod 0700 .sitecopy
- Create a file named .sitecopyrc in your user_dir directory and give it 0600 permissions.
- Edit .sitecopyrc and enter the following settings:
site site-name server netbeans.org remote /website/project-name local path-to-local-directory http secure protocol webdav port 443 username netbeans.org-username password netbeans.org-password
- site-name is just a name you use to distinguish this site's settings from other site settings in the .sitecopyrc file. You use it in the sitecopy -f command to initiate a transfer of files for this site to the corresponding website on kenai.com.
- remote requires a slash (/) before the first directory name. For example, for the help project, whose project home page URL is http://netbeans.org/projects/help, you would enter /website/help.
- local is the path to the directory on your local file system where you maintain the website files.
You can upload files from your local directory to your project on kenai.com by using the following command:
sitecopy -f site-name
You can get a list of all available sitecopy commands by entering
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.