Business cards

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
m
(fix docs)
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"
 +
git clone git://fedorapeople.org/~ianweller/fedora-business-cards.git
 +
cd fedora-business-cards/
 +
./fedora-business-cards
  
The '''Fedora contributor business card''' is a business card that represents contributors of Fedora.
+
The instructions are quite easy to follow. If you need any help, [[User:Ianweller/instacontact|ping me on IRC]].
 
+
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)
+
  
 
== 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!)
 

Revision as of 01:15, 31 October 2008

The Fedora contributor business card is a business card that represents contributors of Fedora.

Contents

Using the card generator

su -c "yum install mgopen-fonts inkscape PyXML python-iniparse pygpgme python-fedora git"
git clone git://fedorapeople.org/~ianweller/fedora-business-cards.git
cd fedora-business-cards/
./fedora-business-cards

The instructions are quite easy to follow. If you need any help, ping me on IRC.

Fedora Business Card Specification

This is the specification to be used for Fedora business cards.

Front of card

Ianweller-business-card-front.png (sample)

  • Use generator as specified below
  • Template available as front-template.svg in git repository below

Optional back of card

Note.png
Dark background
This background can be difficult to write on and for some people may be a reason to not put this on the back of your card. As said, it is optional.

Business-card-back.png

  • Template available as back.svg in git repository below