summaryrefslogtreecommitdiff
path: root/src/devel/4_hello.xml
blob: 125ab45f5adbae34a21321e1c178c9eee451fbc2 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<?xml version="1.0" encoding="utf-8"?>
<chapter label="4" id="hello">
    <title>Writing Your First Package</title>
    <para>Now that you have a complete development environment configured and know how to use Git, you're ready to start writing your first package recipe.
        This chapter will introduce the <command>newapkbuild</command> command and the <filename>APKBUILD</filename> structure common to all packages.</para>
    <section>
        <title>Checking Out a Package Repository</title>
        <para>As noted in chapter 1, all packages live in a <firstterm>package repository</firstterm>.  Typically, package repositories are stored in Git.  You can make your own package repository, but for now, we will use a <firstterm>private fork</firstterm> of the Adélie Linux official package repositories.</para>
        <para><ulink url="https://code.foxkit.us/users/sign_in">Sign in</ulink> to the Adélie Linux Git system.  If you have not yet created an account, you will need to sign up for one.  The sign up form can be accessed from the sign in page.</para>
        <para>Navigate to the <ulink url="https://code.foxkit.us/adelie/packages">Adélie Linux package repository</ulink> in the Git system.  Choose the <guibutton>Fork</guibutton> button in the middle of the screen; if prompted, select your name as the repository destination.</para>
        <para>The system will redirect you to your new fork.  Use the <guilabel>"SSH"</guilabel> URL to clone the repository on your local computer by running the following command:</para>
        <para><prompt>$</prompt> <command>git <parameter>clone</parameter> <userinput>git@code.foxkit.us:yourname/packages.git</userinput></command></para>
        <para>where <userinput>yourname</userinput> is your Git username.</para>
    </section>
    <section>
        <title></title>
        <para></para>
    </section>
</chapter>