Last updated November 07, 2012 19:15, by nvause
[[Home| &raquo; Project Kenai Documentation and Training]] &nbsp; &nbsp; [[Howdoi| &raquo; How Do I ...]] <h1>Working With Your Project's Website </h1> As described at [[ManageProject#Website|Managing a Project: Website]], after you enable your own web site for a project on Project Kenai, you can use either a [[SCMWebsiteHooks|SCM Website Hook]] to update website site content or use a [ WebDAV] client to upload the files to <tt><nowiki>https://</nowiki>''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 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 [ 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 []. 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== '''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]]. 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></nowiki>''your-project-name''</tt>/. # If you want to add the server permanently, click the <tt>+ </tt>button. # To connect to the server, click ''Connect''. # When prompted for authentication, enter your Kenai username and password. # Use either drag and drop or the command line to copy files to the Kenai 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:<br/><tt>cp ''local_files'' /Volumes/''project_name''</tt>. ==Using WebDAV With a Linux System== '''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]]. At present, our Linux documentation covers Kubuntu 9.04 with the KDE 4 desktop, using the [ davfs2] file system, and using sitecopy. We plan to add documentation for more Linux systems as we get more information on them. Some addtional options reported to be available are direct support through Gnome and support through the Cadaver client. If you use a Linux system to work with your website on Project Kenai, you could help us out by sending instructions to <a href=""></a>. ===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:''' # Start Dolphin and enter the following URL in the address bar:<br/><tt><nowiki>webdavs://</nowiki>''your-project-name''/</tt> # 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 Project Kenai 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 <nowiki>[Bug 187970]</nowiki>: "Dolphin webdav avoids to remove folders in with code 301."] ===Using the davfs2 File System=== As described at [], 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.<br/><br/> # Mount your website directory. For example, <br/><br/><tt>sudo mount -t davfs <nowiki> /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. ===Setting Up and Using sitecopy=== The downloads area at [] 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 web site. ====Setting Up sitecopy==== # Make sure you have enabled the Website feature for your project on, as described at [[ManageProject#Website|Managing a Project: Website]]. # Download and install sitecopy from [].<br/>'''Note:''' For Macintosh OSX, download sitecopy at [] 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 remote /website/''project-name'' local ''path-to-local-directory'' http secure protocol webdav port 443 username ''kenai-username'' password ''kenai-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 * <tt>'''remote'''</tt> requires a slash (<tt>/</tt>) before the first directory name. For example, for the Bluebird project, whose project home page URL is <tt><nowiki></nowiki></tt>, you would enter <tt>/website/bluebird</tt>. * <tt>'''local'''</tt> is the path to the directory on your local file system where you maintain the website files. ====Using Sitecopy==== The first time you use sitecopy, you need to initialize the site: &nbsp;$sitecopy -i ''site-name'' Here's a typical series of steps for using Sitecopy. # Perform a fetch:<br/><tt>&nbsp;$sitecopy -f ''site-name''</tt><br/><br/> # Synchronize your local repository with your remote repository:<br/><tt>&nbsp;$sitecopy -s ''site-name''</tt><br/><br/>'''Note:''' There is a bug with sitecopy synchronization that requires you to synchronize as many times as you have subdirectories. For more information, see [].<br/><br/> # Make changes in your local repository.<br/><br/> # Update the remote repository with changes from your local repository:<br/><tt>&nbsp;$sitecopy -u ''site-name''</tt><br/><br/> You can get a list of all available sitecopy commands by entering sitecopy --help ==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 [[ManageProject#Website|Managing a Project: Website]]. A free WebDAV client, BitKinex, is available for Microsoft Windows XP and Vista. You can download it from []. ===Setting Up BitKinex for Your Project=== # After installing BitKinex, click its icon [[image:bitkinex-icon.gif]] to run it. # Select the Http/WebDAV node.<br/><br/>[[image:bitkinex-choose-type.png]] # Choose Data Source > New > Http/WebDAV.<br/><br/>[[image:bitkinex-choose-datasource.png]] # Enter a name for the new data source and right click it and choose properties .<br/><br/>[[image:bitkinex-click-newdatasource.png]] # Make sure '''Server''' is selected in the tree on the left.<br/><br/>[[image:bitkinex-server-settings.png]] # For '''Server address''', enter <tt></tt>. # For '''Security''', choose SSL. # Enter your Project Kenai username and password. # Click '''Site Map''' under the Server node on the left.<br/><br/>[[image:bitkinex-sitemap-settings.png]] # Double-click the <tt>/</tt> entry under Path and change it to <tt>/website/''your-project-name''/</tt>.<br/>For example, for the Bluebird project, whose project home page URL is <tt><nowiki></nowiki></tt>, you would enter <tt>/website/bluebird/</tt>. # Make sure that '''The location specifies:''' is set to <tt>Directory (WebDAV-compliant)</tt>. # 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 Project Kenai. ===Using BitKinex With Your Project's Website Directory=== After setting up BitKinex to work with your project on Project Kenai, 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 You can also delete files on 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.<br/><br/>[[image:bitkinex-choose-site.png]] # You see the connection window open.<br/><br/>[[image:bitkinex-connection-window.png]] # To populate your 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.<br/><br/>[[image:bitkinex-connection-window-newdir.png]] # 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.<br/><br/>[[image:bitkinex-help.png]]

Project Features

Wiki Controls

About this Project

Help for Site Tools was started in November 2009, is owned by kenaiadmin, and has 43 members.
By use of this website, you agree to the NetBeans Policies and Terms of Use (revision 20160708.bf2ac18). © 2014, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo
Please Confirm