|
|
| Line 1: |
Line 1: |
| {{draft}}
| | The '''Fedora contributor business card''' is a business card that represents contributors of Fedora. |
|
| |
|
| {{admon/warning|Information quickly growing out of date|I'm working on refactoring the generator's end-user setup, so I really wouldn't trust half the stuff on this page, yet, other than where you can see the code. --[[User:Ianweller|Ian Weller]] 02:34, 28 September 2008 (UTC)}}
| | == Using the card generator == |
| | | su -c "yum install mgopen-fonts inkscape PyXML python-iniparse pygpgme python-fedora git" |
| The '''Fedora contributor business card''' is a business card that represents contributors of Fedora.
| | git clone git://fedorapeople.org/~ianweller/fedora-business-cards.git |
| | cd fedora-business-cards/ |
| | ./fedora-business-cards |
|
| |
|
| For right now, consider this documentation as a draft as people discuss it. I'm sure there will be an announcement of sorts when we call it good. --[[User:Ianweller|Ian Weller]] 08:23, 9 August 2008 (UTC)
| | The instructions are quite easy to follow. If you need any help, [[User:Ianweller/instacontact|ping me on IRC]]. |
|
| |
|
| == Fedora Business Card Specification == | | == Fedora Business Card Specification == |
| Line 21: |
Line 23: |
|
| |
|
| * Template available as <code>back.svg</code> in git repository below | | * Template available as <code>back.svg</code> in git repository below |
|
| |
| == Get the card generator ==
| |
|
| |
| First, you need some packages from yum.
| |
| sudo yum install mgopen-fonts python-fedora pygpgme inkscape
| |
|
| |
| Soon, you won't need Inkscape; we're working on a way to do it with Cairo's Python bindings and the like.
| |
|
| |
| The generator is a Python script stored in a git repository on fedorapeople.org. Clone it.
| |
| git clone git://fedorapeople.org/~ianweller/fedora-business-cards.git
| |
|
| |
| == Generate the card ==
| |
| In the fedora-business-cards repo, run
| |
| make
| |
| This will ask you to login to FAS, download the default information, and create the [[#Default layout|default business card]], which is what we highly recommend you use.
| |
|
| |
| If you get an error, see [[#Overriding information]] and [[#Errors]].
| |
|
| |
| === Passing options to the generator ===
| |
| Get potential options by running
| |
| python generate.py -h
| |
|
| |
| and pass options like this:
| |
| make GENERATE_OPTIONS="''OPTIONS''"
| |
|
| |
| The default for the <code>--info</code> option is <code>email,phone,irc,url,blank,gpgid</code>.
| |
|
| |
| === Using a GPG fingerprint instead of the key ID ===
| |
| {{admon/note|We prefer the key ID|Key fingerprints can be confusing and can also fall off the card due to length. We advise against using a key fingerprint.}}
| |
|
| |
| Simply replace the <code>gpgid</code> option in <code>--info</code> with <code>gpgfingerprint</code>. Like so:
| |
| make GENERATE_OPTIONS="--info=email,phone,irc,url,blank,gpgfingerprint"
| |
|
| |
| === Overriding information ===
| |
| Let's say you don't want to use your @fedoraproject.org email, or your talk.fedoraproject.org extension. Use the <code>--override-*</code> options.
| |
|
| |
| Before overriding information, we recommend adding useful information to FAS.
| |
|
| |
| * Generating a card for someone else? <code>--override-username=''USERNAME''</code>
| |
| * Don't have a GPG key ID in FAS, but want to use it on your card? <code>--override-gpgid=''A1B2C3D4''</code>
| |
| * Want to become Inigo Montoya? <code>--override-name="Inigo Montoya"</code>
| |
|
| |
| == Errors ==
| |
| Errors come in the form of a <s>delicious birthday cake</s> Python traceback. Generally the last string in the traceback is what we'll use here.
| |
|
| |
| <code>%s</code> is a wildcard in these cases.
| |
|
| |
| *<code>--info count can't be greater than 6</code>
| |
| ::You can't have more than 6 things in <code>--info</code>. Deal with it.
| |
|
| |
| *<code>%s not valid for --info</code>
| |
| ::You used an invalid option for <code>--info</code>. Maybe your code base is old and it needs a <code>git pull</code>.
| |
|
| |
| *<code>Couldn't get PGP fingerprint for key %s</code>
| |
| ::The generator script will attempt to get your GPG key and get the fingerprint, if you don't have the key handy. If it can't, it throws this.
| |
|
| |
| *<code>No IRC nick for %s, use override</code> and <code>No GPG key ID for %s, use override</code>
| |
| ::This data isn't available in FAS, either due to privacy restrictions or nonexistance. Either add the information to FAS, use <code>--override-irc</code> or <code>--override-gpgid</code>, or remove <code>irc</code> or <code>gpgid</code> and <code>gpgfingerprint</code> from <code>--info</code>.
| |
|
| |
| == Successful printers ==
| |
| For those that don't want to print cards themselves and go with an online distributor, these printers have been used by other Fedora Project members and are happy with them.
| |
|
| |
| {{admon/warning|Disclaimer|These businesses are not sanctioned or related to the Fedora Project in any way.}}
| |
|
| |
| (No businesses yet. Add yours!)
| |
(sample)
