This revision made November 21, 2009 02:13, by pfussell

» Netbeans.org Site Tools Help - Home Page

Working With Your Project's Website

As 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.


Using Finder with Macintosh OSX

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:

  1. In the Finder, choose Go > Connect to Server.
  2. In the Server Address field, enter https://netbeans.org/website/your-project-name.
  3. If you want to add the server permanently, click the + button.
  4. To connect to the server, click Connect.
  5. When prompted for authentication, enter your netbeans.org username and password.
  6. 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.

Using WebDAV With a Linux System

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.

Using Kubuntu 9.04 With the KDE Desktop

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:

  1. Start Dolphin and enter the following URL in the address bar:
    webdavs://netbeans.org/website/your-project-name/
  2. 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.
  3. 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."

Using the davfs2 File System

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:

  1. Install davfs2 on your machine.

  2. 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.

  3. 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.

Setting Up and Using Sitecopy

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:

  1. Make sure you have enabled the Website feature for your project on kenai.com, as described at Managing a Project: Website.
  2. 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.
  3. Create a directory named .sitecopy in your user_dir and give it 0700 permissions. For example:
      cd /home/myusername
      mkdir .sitecopy
      chmod 0700 .sitecopy
  4. Create a file named .sitecopyrc in your user_dir directory and give it 0600 permissions.
  5. 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

Notes:

  • 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

    sitecopy --help

Using BitKinex with Microsoft Windows XP and Vista

A free WebDAV client, BitKinex, is available for Microsoft Windows XP and Vista. You can download it from http://www.bitkinex.com/download.php.

Setting Up BitKinex for Your Project

  1. After installing BitKinex, click its icon to run it.
  2. Select the Http/WebDAV node.

  3. Choose Data Source > New > Http/WebDAV.

  4. Enter a name for the new data source and click it.

  5. Make sure Server is selected in the tree on the left.

  6. For Server address, enter netbeans.org.
  7. For Security, choose SSL.
  8. Enter your netbeans.org username and password.
  9. Click Site Map under the Server node on the left.

  10. 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/.
  11. Make sure that The location specifies: is set to Directory (WebDAV-compliant).
  12. Click Update.
  13. 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.

Using BitKinex With Your Project's Website Directory

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:

  1. Double-dlick the node for your project under the Http/WebDAV node.

  2. You see the connection window open.

  3. 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.
  4. 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.

  5. 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.

Difference compared to previous revision
<span>[[Home| &raquo; Netbeans.org Site Tools Help - Home Page]] <h1>Working With Your Project's Website</h1> As described at [[ManageProject#Website|Managing a Project: Website]], <span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">a</span>f<span style="text-decoration:underline;color:green">ter</span>f you <span style="text-decoration:line-through;color:red">wa</span> you <span style="text-decoration:underline;color:green">e</span>n<span style="text-decoration:line-through;color:red">t</span><span style="text-decoration:underline;color:green">able</span> your own web site for a project on netbeans.org, you use a [http://en.wikipedia.org/wiki/WebDAV WebDAV] client to upload the files to <tt><nowiki>https://</nowiki>netbeans.org/website/''your-project-name''</tt>. 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 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 [[#Using_BitKinex_with_Microsoft_Windows_XP_and_Vista|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 [http://savannah.nongnu.org/projects/davfs2 davfs2] file system instead of WebDAV clients.<span style="text-decoration:underline;color:green">* Another client to consider is [http://www.manyfish.co.uk/sitecopy/ 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 [http://www.manyfish.co.uk/sitecopy/why.html Should I Use Sitecopy?] for more information on choosing it.</span> <span style="text-decoration:underline;color:green"> For a list of WebDAV clients, see [http://www.webdav.org/projects/]. </span>Before installing a separate client, try using your operating system's WebDAV to see if it works.<br/><br/> __TOC__ ==Using Finder with Macintosh OSX== <span style="text-decoration:underline;color:green">'''Note''': Before you can use WebDAV with your project's web site, you must first enable the web site as described at [[ManageProject#Website|Managing a Project: Website]]. You can also use sitecopy on a Macintosh system, as described below at [[#Setting_Up_and_Using_Sitecopy|Setting Up and Using Sitecopy]]. </span>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 <tt><nowiki>https://netbeans.org/website/</nowiki>''your-project-name''</tt>. # If you want to add the server permanently, click the <tt>+ </tt>button. ... '''To use davfs2:''' # Install davfs2 on your machine.<br/><br/> # Mount your website directory. For example, <br/><br/><tt>sudo mount -t davfs <nowiki>https://netbeans.org/website/project_name /where_to_mount</nowiki></tt><br/><br/>'''Note:''' Write access to the mounted directory requires that you use <tt>sudo</tt>.<br/><br/> # After finishing your work, just <tt>umount</tt> the directory. All changes should be synchronized and updated. If the data is not synchronized, use the <tt>sync</tt> command before you unmount.<span style="text-decoration:underline;color:green"> ===Setting Up and Using Sitecopy=== [http://www.manyfish.co.uk/sitecopy/ 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 [[ManageProject#Website|Managing a Project: Website]]. # Download and install sitecopy from [http://www.manyfish.co.uk/sitecopy/].<br/>'''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 <tt>.sitecopy</tt> in your <tt>user_dir</tt> and give it 0700 permissions. For example:<br/><tt> &nbsp;&nbsp;cd /home/myusername</tt><br/><tt> &nbsp;&nbsp;mkdir .sitecopy</tt><br/><tt> &nbsp;&nbsp;chmod 0700 .sitecopy</tt> # Create a file named <tt>.sitecopyrc</tt> in your <tt>user_dir</tt> directory and give it 0600 permissions. # Edit <tt>.sitecopyrc</tt> 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'' '''Notes:''' * <tt>'''site-name'''</tt> is just a name you use to distinguish this site's settings from other site settings in the <tt>.sitecopyrc</tt> file. You use it in the <tt>sitecopy -f </tt> command to initiate a transfer of files for this site to the corresponding website on kenai.com. * <tt>'''remote'''</tt> requires a slash (<tt>/</tt>) before the first directory name. For example, for the help project, whose project home page URL is <tt><nowiki>http://netbeans.org/projects/help</nowiki></tt>, you would enter <tt>/website/help</tt>. * <tt>'''local'''</tt> 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 sitecopy --help</span> ==Using BitKinex with Microsoft Windows XP and Vista== A free WebDAV client, BitKinex, is available for Microsoft Windows XP and Vista. You can download it from [http://www.bitkinex.com/download.php].<span>

Project Features

Wiki Controls

About this Project

Help for netbeans.org Site Tools was started in November 2009, is owned by kenaiadmin, and has 17 members.
By use of this website, you agree to the NetBeans Policies and Terms of Use (revision 20140418.2d69abc). © 2013, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo
 
 
Close
loading
Please Confirm
Close