29
29
For other platforms and to install from source code, see the Download_
30
30
and Installation_ pages.
32
.. _installation instructions for Windows: http://bazaar-vcs.org/WindowsDownloads
33
.. _installation instructions for Mac OS X: http://bazaar-vcs.org/MacOSXBundle
34
.. _Download: http://bazaar-vcs.org/Download
35
.. _Installation: http://bazaar-vcs.org/InstallationFaq
32
.. _installation instructions for Windows: http://wiki.bazaar.canonical.com/WindowsDownloads
33
.. _installation instructions for Mac OS X: http://wiki.bazaar.canonical.com/MacOSXBundle
34
.. _Download: http://wiki.bazaar.canonical.com/Download
35
.. _Installation: http://wiki.bazaar.canonical.com/InstallationFaq
38
38
Introducing yourself
64
64
$ mkdir subdirectory
65
65
$ touch test1.txt test2.txt test3.txt subdirectory/test4.txt
67
**Note for Windows users:** use Windows Explorer to create your
67
**Note for Windows users**: use Windows Explorer to create your
68
68
directories, then right-click in those directories and select
69
69
``New file`` to create your files.
75
75
If it looks like nothing happened, don't worry. Bazaar has created a
76
76
branch_ where it will store your files and their revision histories.
78
.. _branch: http://bazaar-vcs.org/Branch
78
.. _branch: http://wiki.bazaar.canonical.com/Branch
80
80
The next step is to tell Bazaar which files you want to track. Running
81
81
``bzr add`` will recursively add everything in the project::
143
Publishing your branch with sftp
144
================================
146
There are a couple of ways to publish your branch. If you already have
147
an SFTP server or are comfortable setting one up, you can publish your
150
Otherwise, skip to the next section to publish with Launchpad_, a free
151
hosting service for Bazaar.
153
.. _Launchpad: https://launchpad.net/
155
Let's assume you want to publish your branch at ``www.example.com/myproject``::
157
$ bzr push --create-prefix sftp://your.name@example.com/~/public_html/myproject
158
2 revision(s) pushed.
160
Bazaar will create a ``myproject`` directory on the remote server and
161
push your branch to it.
163
Now anyone can create their own copy of your branch by typing::
165
$ bzr branch http://www.example.com/myproject
167
**Note:** to use sftp, you may need to install ``paramiko`` and
168
``pyCrypto``. See http://bazaar-vcs.org/InstallationFaq for details.
171
Publishing your branch with Launchpad
172
=====================================
174
Launchpad is a suite of development and hosting tools for free
175
software projects. You can use it to publish your branch.
143
Publishing your branch on Launchpad
144
===================================
146
Launchpad is a suite of development and hosting tools for
147
software projects. You can use it to publish your branch. (You can
148
also publish branches onto your own server or other hosting services.)
177
150
If you don't have a Launchpad account, follow the `account signup guide`_
178
151
and `register an SSH key`_ in your new Launchpad account.
187
160
.. [#] Use of the ``lp:`` URL scheme requires bzr 0.92 or later.
189
**Note:** ``+junk`` means that this branch isn't associated with any particular
162
**Note**: ``+junk`` means that this branch isn't associated with any particular
190
163
project in Launchpad.
192
165
Now, anyone can create their own copy of your branch by typing::