Initial commit for market-research-reports

2026-01-29 22:15:14 +08:00
commit a78a21d339
8 changed files with 6429 additions and 0 deletions
--- a/assets/FORMATTING_GUIDE.md
+++ b/assets/FORMATTING_GUIDE.md
@@ -0,0 +1,428 @@
+# Market Research Report Formatting Guide
+
+Quick reference for using the `market_research.sty` style package.
+
+## Color Palette
+
+### Primary Colors
+| Color Name | RGB | Hex | Usage |
+|------------|-----|-----|-------|
+| `primaryblue` | (0, 51, 102) | `#003366` | Headers, titles, links |
+| `secondaryblue` | (51, 102, 153) | `#336699` | Subsections, secondary elements |
+| `lightblue` | (173, 216, 230) | `#ADD8E6` | Key insight box backgrounds |
+| `accentblue` | (0, 120, 215) | `#0078D7` | Accent highlights, opportunity boxes |
+
+### Secondary Colors
+| Color Name | RGB | Hex | Usage |
+|------------|-----|-----|-------|
+| `accentgreen` | (0, 128, 96) | `#008060` | Market data boxes, positive indicators |
+| `lightgreen` | (200, 230, 201) | `#C8E6C9` | Market data box backgrounds |
+| `warningorange` | (255, 140, 0) | `#FF8C00` | Risk boxes, warnings |
+| `alertred` | (198, 40, 40) | `#C62828` | Critical risks |
+| `recommendpurple` | (103, 58, 183) | `#673AB7` | Recommendation boxes |
+
+### Neutral Colors
+| Color Name | RGB | Hex | Usage |
+|------------|-----|-----|-------|
+| `darkgray` | (66, 66, 66) | `#424242` | Body text |
+| `mediumgray` | (117, 117, 117) | `#757575` | Secondary text |
+| `lightgray` | (240, 240, 240) | `#F0F0F0` | Backgrounds, callout boxes |
+| `tablealt` | (245, 247, 250) | `#F5F7FA` | Alternating table rows |
+
+---
+
+## Box Environments
+
+### Key Insight Box (Blue)
+For major findings, insights, and important discoveries.
+
+```latex
+\begin{keyinsightbox}[Custom Title]
+The market is projected to grow at 15.3% CAGR through 2030, driven by
+increasing enterprise adoption and favorable regulatory conditions.
+\end{keyinsightbox}
+```
+
+### Market Data Box (Green)
+For market statistics, metrics, and data highlights.
+
+```latex
+\begin{marketdatabox}[Market Snapshot]
+\begin{itemize}
+    \item \textbf{Market Size (2024):} \marketsize{45.2 billion}
+    \item \textbf{Projected Size (2030):} \marketsize{98.7 billion}
+    \item \textbf{CAGR:} \growthrate{15.3}
+\end{itemize}
+\end{marketdatabox}
+```
+
+### Risk Box (Orange/Warning)
+For risk factors, warnings, and cautions.
+
+```latex
+\begin{riskbox}[Market Risk]
+Regulatory changes in the European Union could impact 40% of market
+participants within the next 18 months.
+\end{riskbox}
+```
+
+### Critical Risk Box (Red)
+For high-severity or critical risks.
+
+```latex
+\begin{criticalriskbox}[Critical: Supply Chain Disruption]
+A major supply chain disruption could result in 6-12 month delays
+and 30% cost increases.
+\end{criticalriskbox}
+```
+
+### Recommendation Box (Purple)
+For strategic recommendations and action items.
+
+```latex
+\begin{recommendationbox}[Strategic Recommendation]
+\begin{enumerate}
+    \item Prioritize market entry in Asia-Pacific region
+    \item Develop strategic partnerships with local distributors
+    \item Invest in localization of product offerings
+\end{enumerate}
+\end{recommendationbox}
+```
+
+### Callout Box (Gray)
+For definitions, notes, and supplementary information.
+
+```latex
+\begin{calloutbox}[Definition: TAM]
+Total Addressable Market (TAM) represents the total revenue opportunity
+available if 100% market share was achieved.
+\end{calloutbox}
+```
+
+### Executive Summary Box
+Special styling for executive summary highlights.
+
+```latex
+\begin{executivesummarybox}[Executive Summary]
+Key findings and highlights of the report...
+\end{executivesummarybox}
+```
+
+### Opportunity Box (Teal/Accent Blue)
+For opportunities and positive findings.
+
+```latex
+\begin{opportunitybox}[Growth Opportunity]
+The Asia-Pacific market represents a \$15 billion opportunity
+growing at 22% CAGR.
+\end{opportunitybox}
+```
+
+### Framework Boxes
+For strategic analysis frameworks.
+
+```latex
+% SWOT Analysis
+\begin{swotbox}[SWOT Analysis Summary]
+Content...
+\end{swotbox}
+
+% Porter's Five Forces
+\begin{porterbox}[Porter's Five Forces Analysis]
+Content...
+\end{porterbox}
+```
+
+---
+
+## Pull Quotes
+
+For highlighting important statistics or quotes.
+
+```latex
+\begin{pullquote}
+"The convergence of AI and healthcare represents a \$199 billion
+opportunity by 2034."
+\end{pullquote}
+```
+
+---
+
+## Stat Boxes
+
+For highlighting key statistics (use in rows of 3).
+
+```latex
+\begin{center}
+\statbox{\$45.2B}{Market Size 2024}
+\statbox{15.3\%}{CAGR 2024-2030}
+\statbox{23\%}{Market Leader Share}
+\end{center}
+```
+
+---
+
+## Custom Commands
+
+### Highlighting Text
+```latex
+\highlight{Important text}  % Blue bold
+```
+
+### Market Size Formatting
+```latex
+\marketsize{45.2 billion}   % Outputs: $45.2 billion in green
+```
+
+### Growth Rate Formatting
+```latex
+\growthrate{15.3}           % Outputs: 15.3% in green
+```
+
+### Risk Indicators
+```latex
+\riskhigh{}     % Outputs: HIGH in red
+\riskmedium{}   % Outputs: MEDIUM in orange
+\risklow{}      % Outputs: LOW in green
+```
+
+### Rating Stars (1-5)
+```latex
+\rating{4}      % Outputs: ★★★★☆
+```
+
+### Trend Indicators
+```latex
+\trendup{}      % Green up triangle
+\trenddown{}    % Red down triangle
+\trendflat{}    % Gray right arrow
+```
+
+---
+
+## Table Formatting
+
+### Standard Table with Alternating Rows
+```latex
+\begin{table}[htbp]
+\centering
+\caption{Market Size by Region}
+\begin{tabular}{@{}lrrr@{}}
+\toprule
+\textbf{Region} & \textbf{Size} & \textbf{Share} & \textbf{CAGR} \\
+\midrule
+North America & \$18.2B & 40.3\% & 12.5\% \\
+\rowcolor{tablealt} Europe & \$12.1B & 26.8\% & 14.2\% \\
+Asia-Pacific & \$10.5B & 23.2\% & 18.7\% \\
+\rowcolor{tablealt} Rest of World & \$4.4B & 9.7\% & 11.3\% \\
+\midrule
+\textbf{Total} & \textbf{\$45.2B} & \textbf{100\%} & \textbf{15.3\%} \\
+\bottomrule
+\end{tabular}
+\label{tab:regional}
+\end{table}
+```
+
+### Table with Trend Indicators
+```latex
+\begin{tabular}{@{}lrrl@{}}
+\toprule
+\textbf{Company} & \textbf{Revenue} & \textbf{Share} & \textbf{Trend} \\
+\midrule
+Company A & \$5.2B & 15.3\% & \trendup{} +12\% \\
+Company B & \$4.8B & 14.1\% & \trenddown{} -3\% \\
+Company C & \$4.2B & 12.4\% & \trendflat{} +1\% \\
+\bottomrule
+\end{tabular}
+```
+
+---
+
+## Figure Formatting
+
+### Standard Figure
+```latex
+\begin{figure}[htbp]
+\centering
+\includegraphics[width=0.9\textwidth]{../figures/market_growth.png}
+\caption{Market Growth Trajectory (2020-2030)}
+\label{fig:growth}
+\end{figure}
+```
+
+### Figure with Source Attribution
+```latex
+\begin{figure}[htbp]
+\centering
+\includegraphics[width=0.85\textwidth]{../figures/market_share.png}
+\caption{Market Share Distribution (2024)}
+\figuresource{Company annual reports, industry analysis}
+\label{fig:market_share}
+\end{figure}
+```
+
+---
+
+## List Formatting
+
+### Bullet Lists
+```latex
+\begin{itemize}
+    \item First item with automatic blue bullet
+    \item Second item
+    \item Third item
+\end{itemize}
+```
+
+### Numbered Lists
+```latex
+\begin{enumerate}
+    \item First item with blue number
+    \item Second item
+    \item Third item
+\end{enumerate}
+```
+
+### Nested Lists
+```latex
+\begin{itemize}
+    \item Main point
+    \begin{itemize}
+        \item Sub-point A
+        \item Sub-point B
+    \end{itemize}
+    \item Another main point
+\end{itemize}
+```
+
+---
+
+## Title Page
+
+### Using the Custom Title Command
+```latex
+\makemarketreporttitle
+    {Market Title}              % Report title
+    {Subtitle Here}             % Subtitle
+    {../figures/cover.png}      % Hero image (leave empty for no image)
+    {January 2025}              % Date
+    {Market Intelligence Team}  % Author/prepared by
+```
+
+### Manual Title Page
+See the template for full manual title page code.
+
+---
+
+## Appendix Sections
+
+```latex
+\appendix
+
+\chapter{Methodology}
+
+\appendixsection{Data Sources}
+Content that appears in table of contents...
+```
+
+---
+
+## Common Patterns
+
+### Market Snapshot Section
+```latex
+\begin{marketdatabox}[Market Snapshot]
+\begin{itemize}
+    \item \textbf{Current Market Size:} \marketsize{45.2 billion}
+    \item \textbf{Projected Size (2030):} \marketsize{98.7 billion}
+    \item \textbf{CAGR:} \growthrate{15.3}
+    \item \textbf{Largest Segment:} Enterprise (42\% share)
+    \item \textbf{Fastest Growing Region:} APAC (\growthrate{22.1} CAGR)
+\end{itemize}
+\end{marketdatabox}
+```
+
+### Risk Register Summary
+```latex
+\begin{table}[htbp]
+\centering
+\caption{Risk Assessment Summary}
+\begin{tabular}{@{}llccl@{}}
+\toprule
+\textbf{Risk} & \textbf{Category} & \textbf{Prob.} & \textbf{Impact} & \textbf{Rating} \\
+\midrule
+Market disruption & Market & High & High & \riskhigh{} \\
+\rowcolor{tablealt} Regulatory change & Regulatory & Med & High & \riskhigh{} \\
+New entrant & Competitive & Med & Med & \riskmedium{} \\
+\rowcolor{tablealt} Tech obsolescence & Technology & Low & High & \riskmedium{} \\
+Currency fluctuation & Financial & Med & Low & \risklow{} \\
+\bottomrule
+\end{tabular}
+\end{table}
+```
+
+### Competitive Comparison Table
+```latex
+\begin{table}[htbp]
+\centering
+\caption{Competitive Comparison}
+\begin{tabular}{@{}lccccc@{}}
+\toprule
+\textbf{Factor} & \textbf{Co. A} & \textbf{Co. B} & \textbf{Co. C} & \textbf{Co. D} \\
+\midrule
+Market Share & \rating{5} & \rating{4} & \rating{3} & \rating{2} \\
+\rowcolor{tablealt} Product Quality & \rating{4} & \rating{5} & \rating{3} & \rating{4} \\
+Price Competitiveness & \rating{3} & \rating{3} & \rating{5} & \rating{4} \\
+\rowcolor{tablealt} Innovation & \rating{5} & \rating{4} & \rating{2} & \rating{3} \\
+Customer Service & \rating{4} & \rating{4} & \rating{4} & \rating{5} \\
+\bottomrule
+\end{tabular}
+\end{table}
+```
+
+---
+
+## Troubleshooting
+
+### Box Overflow
+If box content overflows the page, break into multiple boxes or use page breaks:
+```latex
+\newpage
+\begin{keyinsightbox}[Continued...]
+```
+
+### Figure Placement
+Use `[htbp]` for flexible placement, or `[H]` (requires `float` package) for exact placement:
+```latex
+\begin{figure}[H]  % Requires \usepackage{float}
+```
+
+### Table Too Wide
+Use `\resizebox` or `adjustbox`:
+```latex
+\resizebox{\textwidth}{!}{
+\begin{tabular}{...}
+...
+\end{tabular}
+}
+```
+
+### Color Not Appearing
+Ensure `xcolor` package is loaded with `[table]` option (already included in style file).
+
+---
+
+## Compilation
+
+Compile with XeLaTeX for best results:
+```bash
+xelatex report.tex
+bibtex report
+xelatex report.tex
+xelatex report.tex
+```
+
+Or use latexmk:
+```bash
+latexmk -xelatex report.tex
+```