From Fedora Project Wiki

(start. this probably sucks.)
 
(34 intermediate revisions by 9 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 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>


== Get the card generator ==
== Fedora Business Card Specification ==
This is the specification to be used for Fedora business cards.


First, you need some packages from yum.
=== Front of card ===
sudo yum install mgopen-fonts python-fedora pygpgme
[[Image:Ianweller-business-card-front.png|315px]] ''(sample)''


The generator is a Python script stored in a git repository on fedorapeople.org. Clone it.
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".)
git clone git://fedorapeople.org/~ianweller/fedora-business-cards.git


== Generate the card ==
=== Optional back of card ===
In the fedora-business-cards repo, run
{{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''.}}
make
[[Image:Business-card-back.png|315px]]
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]].
== Frequently Questioned Answers ==
How do I export a PDF in CMYK format?


=== Passing options to the generator ===
: With the <code>--cmyk-pdf</code> option. Make sure your installation is updated.
Get potential options by running
python generate.py -h


and pass options like this:
Are there specific settings to use for certain printers?
make GENERATE_OPTIONS="''OPTIONS''"


The default for the <code>--info</code> option is <code>email,phone,irc,url,blank,gpgid</code>.
: The <code>-t</code> is used for specifying settings for specific printers. The following are recommended settings available in the tool:


=== Using a GPG fingerprint instead of the key ID ===
<pre>
{{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.}}
## For overnightprints.com
--cmyk-pdf -t overnightprints
</pre>


Simply replace the <code>gpgid</code> option in <code>--info</code> with <code>gpgfingerprint</code>. Like so:
Can I change the DPI of my cards?
make GENERATE_OPTIONS="--info=email,phone,irc,url,blank,gpgfingerprint"


=== Overriding information ===
: Use the <code>-d</code> option.
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 find a bug, or I want a new feature?


* Generating a card for someone else? <code>--override-username=''USERNAME''</code>
: File it in the [http://bugzilla.redhat.com/ Red Hat Bugzilla] — product Fedora, component fedora-business-cards.
* 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 ==
What if I want to contribute?
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.
: 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!


<code>--info count can't be greater than 6</code>
==Example of how to create==
:You can't have more than 6 things in <code>--info</code>. Deal with it.
To create business card go to Consola and type


<code>%s not valid for --info</code>
<pre>#fedora-business-cards --help</pre>
: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>
and tells us this:
: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>
<pre> #fedora-business-cards [options] GENERATOR </pre>
: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 ==
to create a PNG image do this:
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.}}
<pre> #fedora-business-cards --png fedora </pre>


(No businesses yet. Add yours!)
We will ask ourselves authenticate with FAS
 
[[Category:Marketing]] [[Category:Events]]

Revision as of 04:05, 4 February 2014

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!

Example of how to create

To create business card go to Consola and type

#fedora-business-cards --help

and tells us this:

 #fedora-business-cards [options] GENERATOR 

to create a PNG image do this:

 #fedora-business-cards --png fedora 

We will ask ourselves authenticate with FAS