|
Rapports Personnalisés |
  
|
|
Rapports Personnalisés |
|
With BeerSmith 2 you can create your own custom report formats in addition to those included with BeerSmith. Rapports Personnalisés can be created either in plain text format or HTML format. HTML format offers greater flexibility as you can include images, Avancées formatting, etc.
A good starting point for a custom report is to look at the Rapports that come with BeerSmith. These are typically installed to your BeerSmith templates directory under the Program Files (Application package on the Mac). On windows this is in the "Program Files/BeerSmith2/Rapports" directory. In the Mac the Rapports are located within the BeerSmith2 application under the Rubriques/Rapports section.
Text files may contain simple text formatting (spaces, tabs and newlines). To insert a piece of BeerSmith data you include the name of the BeerSmith variable with a dollar sign ('$') before it in the template. For example within a recipe $NAME will be replaced with the name of the recipe, $STYLE_NAME the name of the beer style selected, etc...
HTML templates work exactly the same way - including $NAME will display the name of the recipe within an HTML recipe template.
BeerSmith supports the names listed in the BeerXML standard - all with a dollar sign in front of them. See the BeerXML standard for an extensive listing of variables available (see below for more tags).
Once you have a template created, save it to the Documents/BeerSmith2/Rapports directory and then you can install it using the instructions below.
Installing a Custom Report
| o | Copy your report template (either in TXT or HTML) to your Documents/BeerSmith2/Rapports directory. If you have changed the directory where BeerSmith documents are stored, please install your file to that directory/Rapports instead. |
| o | Select the Options dialog from the Tools menu |
| o | Select the Rapports tab |
| o | Click on the Add Report button |
| o | Enter the display name of your report - which is the title that will be displayed in the Rapports drop-down |
| o | Select the type - either plain text or HTML (web page) |
| o | Enter the file name for your new template such as MyReport.txt or MyReport.html |
| o | Press Ok to save it, and Ok again to close the options dialog |
| o | Go to the preview pane under your My Recipes view and select your new report from the Rapports dropdown displayed on the preview pane |
Commonly Used Recipe Tags
Purpose Tag
Actual Alcohol by Vol: $ABV
Adjust Temp for Equipment: $EQUIP_ADJUST
Age beer for: $AGE
Age (In Days)r: $AGE
Asst Brewer: $ASST_BREWER
Batch Size: $DISPLAY_BATCH_SIZE
Amertume: $IBU
Amertume Ratio: $Amertume_RATIO
Boil Ingredients: $BOIL_INGREDIENTS
Boil Size: $DISPLAY_BOIL_SIZE
Boil Time: $BOIL_TIME
Boil Volume: $DISPLAY_BOIL_SIZE
Bottling Date: $BOTTLING_DATE
Brewer: $BREWER
Brewhouse Efficiency: $EFFICIENCY
Calories: $CALORIES
Carbonation Type: $CARBONATION_TYPE
Carbonation Used: $CARBONATION_USED
Color Swatch: $COLOR_SWATCH
((Added 3/28/08)) HEX Color: $RGB_COLOR
Date: $DATE
Display Age Temp: $DISPLAY_AGE_TEMP
Display Batch Size: $DISPLAY_BATCH_SIZE
Display Carbonation: $DISPLAY_CARBONATION
Display Primary Temp: $DISPLAY_PRIMARY_TEMP
Display Secondary Temp: $DISPLAY_SECONDARY_TEMP
Display Tertiary Temp: $DISPLAY_TERTIARY_TEMP
Drink and Enjoy!: $END_DATE
Equipment: $EQUIPMENT
Est Color: $EST_COLOR
Est Final Gravity: $EST_FG
Est Original Gravity: $EST_OG
Estimated Alcohol by Vol: $EST_ABV
Estimated pre-boil gravity: $PRE_BOIL_OG
Estimated Mash Efficiency: $EST_MASH_EFFICIENCY
Ferment Ingredients: $FERMENT_INGREDIENTS
Final Volume: $DISPLAY_BATCH_SIZE
For Batch Size: $BATCH_SIZE
Grain Temperature: $GRAIN_TEMP
Ingredients: $INGREDIENTS
Keg/Bottling Temperature: $DISPLAY_CARB_TEMP
Mash Ingredients : $MASH_INGREDIENTS
Mash Ingredients : $MASH_INGREDIENTS
Measured Final Gravity: $DISPLAY_FG
Measured Original Gravity: $DISPLAY_OG
Name: $NAME
Notes: $NOTES
Prepare for Bottling/Kegging: $BOTTLING_INGREDIENTS
Pressure/Weight: $CARBONATION_PRESS
Primary Age: $PRIMARY_AGE
Primary fermentation: $PRIMARY_DATE
Primary Ingredients: $PRIMARY_INGREDIENTS
Recipe Price $PRICE
Secondary Age: $SECONDARY_AGE
Secondary fermentation: $SECONDARY_DATE
Secondary Ingredients: $SECONDARY_INGREDIENTS
Sparge Steps: $SPARGE_STEPS
Sparge Temperature: $SPARGE_TEMP
Sparge Eau: $SPARGE_VOLUME
Steep Houblons: $STEEP_Houblons
Steep Ingredients: $STEEP_INGREDIENTS
Storage Temperature: $DISPLAY_AGE_TEMP
Style Category $STYLE.CATEGORY
Style Letter: $STYLE_LETTER
Style Name: $STYLE_NAME
Taste Notes: $TASTE_NOTES
Taste Rating(out of 50): $TASTE_RATING
Tertiary Age: $TERTIARY_AGE
Tertiary Fermentation: $TERTIARY_DATE
Total Grain Weight: $GRAIN_WEIGHT
Total Grain Weight: $TOTAL_GRAINS
Total Houblons added to boil: $TOTAL_Houblons
TunTemperature: $TUN_TEMP
Type: $TYPE
Volumes of CO2: $CARBONATION
Eau preperation: $Eau_PREP
Pied de Cuve: $Levure_STARTERS