From Fedora Project Wiki

(start. this probably sucks.)
 
(needs updating to new logo)
 
(40 intermediate revisions by 13 users not shown)
Line 1: Line 1:
{{draft}}
{{old}}


The '''Fedora contributor business card''' is a [[Board]]-sanctioned business card that represents contributors of Fedora.
{{autolang|base=yes}}
__TOC__


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 '''Fedora contributor business card''' is a business card for contributors of Fedora.


== Get the card generator ==
== Using the card generator ==
# Install {{package|fedora-business-cards}} from dnf or PackageKit <pre>dnf -y install fedora-business-cards</pre>
# Open a terminal and run<pre>fedora-business-cards fedora</pre>


First, you need some packages from yum.
== Fedora Business Card Specification ==
sudo yum install mgopen-fonts python-fedora pygpgme
This is the specification to be used for Fedora business cards.


The generator is a Python script stored in a git repository on fedorapeople.org. Clone it.
=== Front of card ===
git clone git://fedorapeople.org/~ianweller/fedora-business-cards.git
[[Image:Ianweller-business-card-front.png|315px]] ''(sample)''


== Generate the card ==
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".)
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]].
=== Optional back of card ===
{{admon/note|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''.}}
[[Image:Business-card-back.png|315px]]


=== Passing options to the generator ===
== Frequently Questioned Answers ==
Get potential options by running
How do I export a PDF in CMYK format?
python generate.py -h


and pass options like this:
: With the <code>--cmyk-pdf</code> option.
make GENERATE_OPTIONS="''OPTIONS''"


The default for the <code>--info</code> option is <code>email,phone,irc,url,blank,gpgid</code>.
Can I change the DPI of my cards?


=== Using a GPG fingerprint instead of the key ID ===
: Use the <code>-d</code> option.
{{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:
What if I find a bug, or I want a new feature?
make GENERATE_OPTIONS="--info=email,phone,irc,url,blank,gpgfingerprint"


=== Overriding information ===
: File it in the issue queue at [https://pagure.io/fedora-business-cards/issues/ code repository]. If you find a packaging issues, please file it at [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=rawhide&component=fedora-business-cards Red Hat Bugzilla] — product Fedora, component fedora-business-cards.
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.
What if I want to contribute?


* Generating a card for someone else? <code>--override-username=''USERNAME''</code>
: Clone the git repo: '''git clone https://pagure.io/fedora-business-cards.git'''. Pull Request Welcome!
* 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"


== Errors ==
[[Category:Marketing]] [[Category:Events]]
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.
 
%s 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, unless they are and I don't know about it.}}
 
(No businesses yet. Add yours!)

Latest revision as of 21:13, 5 December 2024

Old page
This page has been marked as "old", and likely contains content that is irrelevant or incorrect. If you can, please update this page. This page will be deleted if action is not taken.

The Fedora contributor business card is a business card for contributors of Fedora.

Using the card generator

  1. Install fedora-business-cards from dnf or PackageKit
    dnf -y install fedora-business-cards
  2. Open a terminal and run
    fedora-business-cards fedora

Fedora Business Card Specification

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

Front of card

(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

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.

Frequently Questioned Answers

How do I export a PDF in CMYK format?

With the --cmyk-pdf option.

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 issue queue at code repository. If you find a packaging issues, please file it at Red Hat Bugzilla — product Fedora, component fedora-business-cards.

What if I want to contribute?

Clone the git repo: git clone https://pagure.io/fedora-business-cards.git. Pull Request Welcome!