What happens, if you give your visitin card to someone? Either he manually types the text into his computer or mobilefone, or it will end up in a box and be forgotten. Nowadays data is required electronically, not on paper. Here is the solution: A visiting card with QR-Code that contains a full [vcard], so that it can be scanned with an [app] on the mobilefone and therefore automatically imported into the electronic contacts. This also works well, when you are offline and bluetooth transfer fails. So here is the highly configurable businescard or visitingcards with full [vcard] as QR-Code, ready to send to online printers.
What happens, if you give your visiting card to someone? Either he manually types the text into his computer or mobilefone, or it will end up in a box and be forgotten. Nowadays data is required electronically, not on paper. Here is the solution: A visiting card with QR-Code that contains a full [vcard], so that it can be scanned with an [app] on the mobilefone and therefore automatically imported into the electronic contacts. This also works well, when you are offline and bluetooth transfer fails. So here is the highly configurable businescard or visitingcards with full [vcard] as QR-Code, ready to send to online printers. You can specify the exact size of the paper and the content within the paper, inluding generation of crop marks.
Other available visitingcard templates, such as [mschlenker] distribute the cards on an A4 paper. But if you want a professional printer, such as [onlineprinters], then you need to be able to generate a PDF with exactly one card, an exactly defined border and crop marks. That's why I wrote this template: You can specify the exact size of the paper and the content within the paper, inluding generation of crop marks.
Other available visitingcard templates, such as [mschlenker] distribute the cards on an A4 paper. But if you want a professional printer, such as [onlineprinters], then you need to be able to generate a PDF with exactly one card, an exactly defined border and crop marks.
[](examples/john-doe-hongkong.tex)
[](examples/john-doe-hongkong.tex)
[](examples/peter-muster-example-company-zuerich.tex)
[](examples/peter-muster-example-company-zuerich.tex)
@ -11,7 +11,7 @@ Other available visitingcard templates, such as [mschlenker] distribute the card
Features
Features
--------
========
- all information is in the QR-Code
- all information is in the QR-Code
- full privacy control: input is optional, specify only what you need, you decide what information to share, e.g. I print three cards, with phone and address, without address and only with electronical contacts, no phone nor address
- full privacy control: input is optional, specify only what you need, you decide what information to share, e.g. I print three cards, with phone and address, without address and only with electronical contacts, no phone nor address
@ -27,61 +27,62 @@ Features
- supports [nextcloud federation id]
- supports [nextcloud federation id]
Usage Example
Usage
-------------
=====
Installation
------------
Copy `businesscard-qrcode/businesscard-qrcode.cls` to your LaTeX class path. Simplest way for installation on Linux:
**Important:** You must use **`xelatex`** for compilation, because `xelatex` properly supports UTF-8 (e.g. needed for german umlauts or chinese characters). The package `inputenc` messes up with package `qrcode`.
**Important:** You must use **`xelatex`** for compilation, because `xelatex` properly supports UTF-8 (e.g. needed for german umlauts or chinese characters). The package `inputenc` messes up with package `qrcode`.
Include the documentclass, define your date and add the document part:
- `paperwidth`: width of the physical paper where the card is printed on (incl. border), default: `89mm`
- `paperheight`: height of the physical paper where the card is printed on (incl. border), default: `59mm`
- `paperwidth=`: width of the physical paper where the card is printed on (incl. border), default: `89mm`
- `contentwidth`: width of the card's content without the border that is cut, default: `85mm`
- `paperheight=`: height of the physical paper where the card is printed on (incl. border), default: `59mm`
- `contentheight`: height of the card's content without the border that is cut, default: `55mm`
- `contentwidth=`: width of the card's content without the border that is cut, default: `85mm`
- `fontsize`: any fontsize allowed in `extarticle`, that are `8pt`, `9pt`, `10pt`, `11pt`, `12pt`, `14pt`, `17pt` and `20pt`, default: `8pt`
- `contentheight=`: height of the card's content without the border that is cut, default: `55mm`
- `padding`: padding within the card's content, default: `2mm`
- `fontsize=`: any fontsize allowed in `extarticle`, that are `8pt`, `9pt`, `10pt`, `11pt`, `12pt`, `14pt`, `17pt` and `20pt`, default: `8pt`
- `cutdist`: distance in `mm` where the cut marks are set, default: `2`
- `padding=`: padding within the card's content, default: `2mm`
- `cutlen`: length of the cut marks in `mm`, default: `1`
- `cutdist=`: distance in `mm` where the cut marks are set, default: `2`
- `textwidth`: relative width of the text block `1` means full width, so `qrwidth` plus `textwidth` should be smaller than `1` the remainig space is left empty between the text and QR-Code, default: `0.55` (that's 55% of the available space)
- `cutlen=`: length of the cut marks in `mm`, default: `1`
- `qrwidth`: relative width of the QR-Code `1` means full width, so `qrwidth` plus `textwidth` should be smaller than `1` the remainig space is left empty between the text and QR-Code, default: `0.40` (that's 40% of the available space)
- `textwidth=`: relative width of the text block `1` means full width, so `qrwidth` plus `textwidth` should be smaller than `1` the remainig space is left empty between the text and QR-Code, default: `0.55` (that's 55% of the available space)
- `lang`: language of the wikipedia page, will be prepended before `wikipedia.org`, e.g. `de.wikipedia.org`, default: `de`
- `qrwidth=`: relative width of the QR-Code `1` means full width, so `qrwidth` plus `textwidth` should be smaller than `1` the remainig space is left empty between the text and QR-Code, default: `0.40` (that's 40% of the available space)
- `lang=`: language of the wikipedia page, will be prepended before `wikipedia.org`, e.g. `de.wikipedia.org`, default: `de`
- `address`or `noaddress`: disable rendering of the address in text and QR-Code, default: address
- `address`or `noaddress`: disable rendering of the address in text and QR-Code, default: address
- `hint` or `nohint`: show the little text hints, default: `hint`
- `hint` or `nohint`: show the little text hints, default: `hint`
- `icon` or `noicon`: show the icons, default: `icon`
- `icon` or `noicon`: show the icons, default: `icon`
@ -95,58 +96,112 @@ Available options:
Data Definitions
Data Definitions
----------------
----------------
Your data is entered as definitions in the document, e.g.:
Your data is entered with commands in the document, e.g.:
\def\email{name@example.com}
\email{name@example.com}
Please note, that spaces must be escaped, otherwise they do not appear in the QR-Code. You may not escape the spaces in your phone number, if you want them in the text, but not in the QR-Code, e.g.:
**Important:**: Spaces *must* be escaped by a backslash `\` in all data definitions, if they should be kept in the QR-Code. This is a limitation of the `qrcode`-package- Without escaping `\`, spaces are show in the text block, but not in the QR-Code. You may make use of this feature, if you do not escape the spaces in `\phone` and `\pgpfingerprint`, but everywhere else. This way, phone number and pgp fingerprint are condensed in the QR-Code.
\def\givennames{Juan\ Pablo}
See this example_
\def\familynames{Martínez\ Escudero}
\def\phone{+41 52 123 45 67}
\givennames{Juan\ Pablo}
\familynames{Martínez\ Escudero}
Recognized definitions:
\additionalnames{Example\ Company\ Ltd.}
- `type`: either `home` or `work` for personal or business cards
\street{Im\ Stutz\ 123}
- `givennames`: your first name and eventual middle names
\pobox{Postfach\ 4567}
- `familynames`: your family names
\phone{+41 52 123 45 67}
- `honoricprefix`: honorix name prefixes, e.g. academic titles
- `additionalnames`: additionl names — I use it for the company name in business cards
### Recognized Commands:
- `pobox`: post office box
- `extaddr`: address extension, e.g. name of a building or floor number
- `\type`: either `home` or `work` for personal or business cards
- `street`: street and number of the address
- `\givennames`: your first name and eventual middle names
- `city`: name of the address location
- `\familynames`: your family names
- `region`: region of the address
- `\honoricprefix`: honorix name prefixes, e.g. academic titles
- `zip`: zip code of the address
- `\honoricsuffix`: honoric name suffixes
- `country`: full name of country of the address in the language of the card
- `\additionalnames`: additionl names — I use it for the company name in business cards
- `phone`: your phone number, the phone is marked as mobile, so to be used for voice and text (SMS)
- `\pobox`: post office box
- `email`: your email address
- `\extaddr`: address extension, e.g. name of a building or floor number
- `jabber`: your [jabber] or xmpp chat address
- `\street`: street and number of the address
- `matrixorg`: your [matrix] chat addres, hint: use [riot] messenger for [matrix]
- `\city`: name of the address location
- `cloud`: your [nextcloud federation id] — the url is prepended automatically
- `\region`: region of the address
- `homepage`: url to a web site with «home» icon — without `https://` not `www` (unless it is required), this is prepended automatically
- `\zip`: zip code of the address
- `world`: url to a web site with «world» icon — without `https://` not `www` (unless it is required), this is prepended automatically
- `\country`: full name of country of the address in the language of the card
- `link`: url to a web site with «link» icon — without `https://` not `www` (unless it is required), this is prepended automatically
- `\phone`: your phone number, the phone is marked as mobile, so to be used for voice and text (SMS)
- `wordpress`: url to a web site with «wordpress» icon — without `https://` not `www` (unless it is required), this is prepended automatically
- `\email`: your email address
- `drupal`: url to a web site with «» icon — without `https://` not `www` (unless it is required), this is prepended automatically
- `\jabber`: your [jabber] or xmpp chat address
- `joomla`: url to a web site with «joomla» icon — without `https://` not `www` (unless it is required), this is prepended automatically
- `\matrixorg`: your [matrix] chat addres, hint: use [riot] messenger for [matrix]
- `wikipedia`: if you or your company have a [wikipedia] entry, specify documentclass option `lang` for the language of you entry and use this definition for the name of your page — the url is prepended automatically
- `\cloud`: your [nextcloud federation id] — the url is prepended automatically
- `git`: the url of your [git] repository — without `https://` not `www` (unless it is required), this is prepended automatically
- `\homepage`: url to a web site with «home» icon — without `https://` not `www` (unless it is required), this is prepended automatically
- `gitea`: the url of your [gitea] project page, you can use this tag also for other project management sites, such as [gogs] — without `https://` not `www` (unless it is required), this is prepended automatically
- `\world`: url to a web site with «world» icon — without `https://` not `www` (unless it is required), this is prepended automatically
- `github`: your account name on [github] — only the name of the account, the url is prepended automatically
- `\link`: url to a web site with «link» icon — without `https://` not `www` (unless it is required), this is prepended automatically
- `facebook`: your account name on [facebook] or the name of your page — only the name of the account or page, the url is prepended automatically
- `\wordpress`: url to a web site with «wordpress» icon — without `https://` not `www` (unless it is required), this is prepended automatically
- `twitter`: your account name on [twitter] — only the name of the account, the url is prepended automatically
- `\drupal`: url to a web site with «» icon — without `https://` not `www` (unless it is required), this is prepended automatically
- `youtube`: your account name on [youtube] — only the name of the account, the url is prepended automatically
- `\joomla`: url to a web site with «joomla» icon — without `https://` not `www` (unless it is required), this is prepended automatically
- `google`: your account name on [google+] — only the name of the account, the url is prepended automatically
- `\wikipedia`: if you or your company have a [wikipedia] entry, specify documentclass option `lang` for the language of you entry and use this definition for the name of your page — the url is prepended automatically
- `pgpurl`: the full url to your pgp public key (only added to the QR-Code, not shown in the text)
- `\git`: the url of your [git] repository — without `https://` not `www` (unless it is required), this is prepended automatically
- `pgpfingerprint`: the fingerprint of your pgp public key
- `\gitea`: the url of your [gitea] project page, you can use this tag also for other project management sites, such as [gogs] — without `https://` not `www` (unless it is required), this is prepended automatically
- `\github`: your account name on [github] — only the name of the account, the url is prepended automatically
- `\facebook`: your account name on [facebook] or the name of your page — only the name of the account or page, the url is prepended automatically
- `\twitter`: your account name on [twitter] — only the name of the account, the url is prepended automatically
- `\youtube`: your account name on [youtube] — only the name of the account, the url is prepended automatically
- `\google`: your account name on [google+] — only the name of the account, the url is prepended automatically
- `\pgpurl`: the full url to your pgp public key (only added to the QR-Code, not shown in the text)
- `\pgpfingerprint`: the fingerprint of your pgp public key
Print the Card
==============
The card is designed for professional printing service, such as [onlineprinters]. Please *check* the card and the *QR-Code* well before you pay money for printing! Choose a format, default is `89mm×59mm` with 2mm boder, so the card content is `85mm×55mm`. But the card can be adapted to any other printing format. To print cards of size `10cm×5cm` with `2mm` cut, you specify, [e.g.](examples/special-papersize.tex):
Marc Wäckerlin
6 years ago
