The use of this template is preferred to direct linking to book resources, as purchases made through the generated link earn Rosetta Code a bit of money through the Amazon Associates program. This will help.
When and When Not to Use
- Use when a link to a specific book resource is helpful in understanding the language or domain problem at hand.
- Use when citing such a resource.
- Do Not Use when a link to a specific book resource would be decidedly inappropriate or unhelpful.
- Do Not Use when there are already a large number of links in a context not dedicated to such a listing.
- Do Not Use when the matter is already covered by references to other, more appropriate resources.
Are you published?
If you're a published author of books directly relating to programming, computer science, computer engineering and/or any of the tasks on Rosetta Code, here are some guidelines that will be of interest to you.
- If you sell through Amazon, you are encouraged to use this template on your user page to build a listing of your published works. Outside of your user page, please limit such links to places and quantities that are useful and relevant.
- A mundane link, of course, is fine if your works aren't sold through Amazon.
- Links to other sales portals may be changed to using this template.
- If you prefer a mundane link to your works' official page over a referral link through Amazon, that is also fine; the Rosetta Code community respect the desires of any author who expresses this preference.
- Links to your works will not be rejected solely due to conflict of interest on your part. By having a published work, you are likely to be more knowledgeable than most. Links to your work may be removed or adjusted for other reasons relating to maintaining and/or improving Rosetta Code's content and layout.
Obviously, if you fall under "Wrote It" or "Wrote the Book", it's very probable your book is appropriate on the page dedicated to It. (i.e. if you wrote It or The Book regarding a language, then a link on that language's page is appropriate. If you wrote It or The Book regarding one of the tasks, then a link may be appropriate there, for those interested in learning more about the task's domain.
Also note that A Book is not the same as The Book. No disrespect intended, but not all works are equal. If you wrote A Book, by all means, list it in your user page! Ideally, another active community member or two will have the opportunity to read it and, possibly, recommend it.
How to use
By correct selection of the template parameter (the ISBN number, dashes removed, is ideal, followed by ASIN or ESIN.), a referral link will be provided to the desired resource, hyperlinked as the title and author's name.
For example, Donald Knuth's The Art of Computer Programming: Volume 1 (3rd Edition) has the ISBN-10 of 0201896834. To create a referral link to this resource, you may use this syntax:
This will appear as: <amazon keywords="0201896834"></amazon>
The box set, volumes 1-4A has the ISBN-10 of 0321751043. To create a referral link to this resource, you may use this syntax:
This will appear as: <amazon keywords="0321751043"></amazon>
Colloquial names are supported, too. For example, <amazon keywords="9780596000271"></amazon> is colloquially known as the "camel book". To represent this, we take the ISBN (978-0-596-00027-1), remove all dashes (to get 9780596000271), and use this syntax:
This will appear as: <amazon keywords="9780596000271"></amazon>