adding readme
This commit is contained in:
83
README.md
Normal file
83
README.md
Normal file
@@ -0,0 +1,83 @@
|
||||
# Resume Generator
|
||||
|
||||
Generates professional Word documents (.docx) from JSON Resume format using the `docx` npm package.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- Node.js (v14 or higher recommended)
|
||||
- npm
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
npm install
|
||||
```
|
||||
|
||||
## Updating Your Resume
|
||||
|
||||
Edit `resume.json` to update your resume content. The file follows the [JSON Resume schema](https://jsonresume.org/schema/).
|
||||
|
||||
### Sections
|
||||
|
||||
**basics** - Personal information and contact details
|
||||
- `name` - Your full name
|
||||
- `label` - Professional title/headline
|
||||
- `email`, `phone`, `url` - Contact information
|
||||
- `summary` - Professional summary paragraph
|
||||
- `location` - City, region, country
|
||||
- `profiles` - Social/professional network links (LinkedIn, GitHub, etc.)
|
||||
|
||||
**work** - Employment history (array)
|
||||
- `name` - Company name
|
||||
- `position` - Job title
|
||||
- `location` - Work location
|
||||
- `startDate`, `endDate` - Dates in YYYY-MM format (omit endDate for current position)
|
||||
- `summary` - Role description
|
||||
- `highlights` - Array of accomplishments/responsibilities
|
||||
|
||||
**education** - Academic background (array)
|
||||
- `institution` - School name
|
||||
- `area` - Field of study
|
||||
- `studyType` - Degree type (e.g., "Bachelor", "Master")
|
||||
- `startDate`, `endDate` - Dates in YYYY-MM format
|
||||
- `score` - GPA or honors (optional)
|
||||
|
||||
**certificates** - Professional certifications (array)
|
||||
- `name` - Certification name
|
||||
- `issuer` - Issuing organization
|
||||
- `date` - Date obtained (YYYY-MM format)
|
||||
|
||||
**awards** - Recognition and awards (array)
|
||||
- `title` - Award name
|
||||
- `awarder` - Granting organization
|
||||
- `date` - Date received
|
||||
- `summary` - Description (optional)
|
||||
|
||||
**skills** - Technical and professional skills (array)
|
||||
- `name` - Skill category (e.g., "Security Tools", "Programming")
|
||||
- `level` - Proficiency level (optional)
|
||||
- `keywords` - Array of specific skills in this category
|
||||
|
||||
## Running the Generator
|
||||
|
||||
```bash
|
||||
node generate_resume.js
|
||||
```
|
||||
|
||||
**Output:** `Phillip_Tarrant_Resume_{YEAR}.docx` in the project directory.
|
||||
|
||||
## Customization
|
||||
|
||||
To modify the document formatting, edit `generate_resume.js`:
|
||||
|
||||
- **Output filename:** Change `OUTPUT_FILE` on line 11
|
||||
|
||||
- **Fonts:** Change the `font` property in `TextRun` objects (default: Arial)
|
||||
- **Margins:** Adjust values in `sections[0].properties.page.margin` (units are DXA, 1440 = 1 inch)
|
||||
- **Text sizes:** Modify `size` in `TextRun` objects (units are half-points, e.g., 22 = 11pt)
|
||||
- **Spacing:** Adjust `spacing: { before: X, after: Y }` on Paragraph elements
|
||||
|
||||
## Resources
|
||||
|
||||
- [JSON Resume Schema](https://jsonresume.org/schema/) - Full schema documentation
|
||||
- [docx npm package](https://docx.js.org/) - Document generation library docs
|
||||
Reference in New Issue
Block a user