From Fedora Project Wiki

(Update canonical git location)
(20 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{draft}}
{{autolang|base=yes}}
__TOC__


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


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)
== Using the card generator ==
# Install {{package|fedora-business-cards}} from yum or PackageKit <pre>yum -y install fedora-business-cards</pre>
# Open a terminal and run<pre>fedora-business-cards --help</pre>


== Fedora Business Card Specification ==
== Fedora Business Card Specification ==
Line 11: Line 14:
[[Image:Ianweller-business-card-front.png|315px]] ''(sample)''
[[Image:Ianweller-business-card-front.png|315px]] ''(sample)''


* Use generator as specified below
It is '''recommended''' that you keep your information in this format, but not required. It's your business card &mdash; put what you need on it. (This includes the title under your name; it can read "Fedora Project Contributor" or "Doer of Stuff".)
* Template available as <code>front-template.svg</code> in git repository below


=== Optional back of card ===
=== Optional back of card ===
Line 18: Line 20:
[[Image:Business-card-back.png|315px]]
[[Image:Business-card-back.png|315px]]


* Template available as <code>back.svg</code> in git repository below
== Frequently Questioned Answers ==
How do I export a PDF in CMYK format?


== Get the card generator ==
: With the <code>--cmyk-pdf</code> option. Make sure your installation is updated.


First, you need some packages from yum.
Are there specific settings to use for certain printers?
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 <code>-t</code> is used for specifying settings for specific printers.  The following are recommended settings available in the tool:


The generator is a Python script stored in a git repository on fedorapeople.org. Clone it.
<pre>
git clone git://fedorapeople.org/~ianweller/fedora-business-cards.git
## For overnightprints.com
--cmyk-pdf -t overnightprints
</pre>


== Generate the card ==
Can I change the DPI of my cards?
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]].
: Use the <code>-d</code> option.


=== Passing options to the generator ===
What if I find a bug, or I want a new feature?
Get potential options by running
python generate.py -h


and pass options like this:
: File it in the [http://bugzilla.redhat.com/ Red Hat Bugzilla] — product Fedora, component fedora-business-cards.
make GENERATE_OPTIONS="''OPTIONS''"


The default for the <code>--info</code> option is <code>email,phone,irc,url,blank,gpgid</code>.
What if I want to contribute?


=== Using a GPG fingerprint instead of the key ID ===
: Clone Ian Weller's git repo: '''git clone http://git.fedorahosted.org/cgit/fedora-business-cards.git/'''. You can then [https://fedoraproject.org/wiki/Infrastructure/fedorapeople.org#BETA_git_hosting_support create your own git repository] with the changes. Finally, don't forget to tell somebody about it!
{{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:
[[Category:Marketing]] [[Category:Events]]
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 17:11, 3 August 2012

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

Using the card generator

  1. Install Package-x-generic-16.pngfedora-business-cards from yum or PackageKit
    yum -y install fedora-business-cards
  2. Open a terminal and run
    fedora-business-cards --help

Fedora Business Card Specification

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

Front of card

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

It is recommended that you keep your information in this format, but not required. It's your business card — put what you need on it. (This includes the title under your name; it can read "Fedora Project Contributor" or "Doer of Stuff".)

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

Frequently Questioned Answers

How do I export a PDF in CMYK format?

With the --cmyk-pdf option. Make sure your installation is updated.

Are there specific settings to use for certain printers?

The -t is used for specifying settings for specific printers. The following are recommended settings available in the tool:
## For overnightprints.com
--cmyk-pdf -t overnightprints

Can I change the DPI of my cards?

Use the -d option.

What if I find a bug, or I want a new feature?

File it in the Red Hat Bugzilla — product Fedora, component fedora-business-cards.

What if I want to contribute?

Clone Ian Weller's git repo: git clone http://git.fedorahosted.org/cgit/fedora-business-cards.git/. You can then create your own git repository with the changes. Finally, don't forget to tell somebody about it!