From Fedora Project Wiki

No edit summary
 
(36 intermediate revisions by 12 users not shown)
Line 1: Line 1:
{{draft}}
{{autolang|base=yes}}
__TOC__


The '''Fedora contributor business card''' is a [[Board]]-sanctioned business card that represents contributors of Fedora.
The '''Fedora contributor business card''' is a business card for 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 dnf or PackageKit <pre>dnf -y install fedora-business-cards</pre>
# Open a terminal and run<pre>fedora-business-cards fedora</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 ===
{{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]]
[[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.


First, you need some packages from yum.
Can I change the DPI of my cards?
sudo yum install mgopen-fonts python-fedora pygpgme


The generator is a Python script stored in a git repository on fedorapeople.org. Clone it.
: Use the <code>-d</code> option.
git clone git://fedorapeople.org/~ianweller/fedora-business-cards.git


== Generate the card ==
What if I find a bug, or I want a new feature?
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]].
: 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.


=== Passing options to the generator ===
What if I want to contribute?
Get potential options by running
python generate.py -h


and pass options like this:
: Clone the git repo: '''git clone https://pagure.io/fedora-business-cards.git'''. Pull Request Welcome!
make GENERATE_OPTIONS="''OPTIONS''"


The default for the <code>--info</code> option is <code>email,phone,irc,url,blank,gpgid</code>.
[[Category:Marketing]] [[Category:Events]]
 
=== 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"
 
== 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!)

Latest revision as of 19:22, 2 September 2019

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

Using the card generator

  1. Install Package-x-generic-16.pngfedora-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

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.

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!