Package: boilerplate 1.4.0

boilerplate: Managing and Compiling Manuscript Templates

Managing and generating standardised text for methods and results sections of scientific reports. It handles template variable substitution and supports hierarchical organisation of text through dot-separated paths. Databases are stored as JSON by default for version control and cross-language compatibility; trusted legacy RDS databases remain readable through import and migration utilities.

Authors:Joseph Bulbulia [aut, cre]

boilerplate_1.4.0.tar.gz
boilerplate_1.4.0.zip(r-4.7)boilerplate_1.4.0.zip(r-4.6)boilerplate_1.4.0.zip(r-4.5)
boilerplate_1.4.0.tgz(r-4.6-any)boilerplate_1.4.0.tgz(r-4.5-any)
boilerplate_1.4.0.tar.gz(r-4.7-any)boilerplate_1.4.0.tar.gz(r-4.6-any)
boilerplate_1.4.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html
DESCRIPTION |NEWS
card.svg |card.png
boilerplate/json (API)

# Install 'boilerplate' in R:
install.packages('boilerplate', repos = c('https://go-bayes.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/go-bayes/boilerplate/issues

Pkgdown/docs site:https://go-bayes.github.io

On CRAN:

Conda:

6.44 score 2 stars 57 scripts 275 downloads 38 exports 8 dependencies

Last updated from:fa66b3ed85. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-x86_64OK135
source / vignettesOK234
linux-release-x86_64OK148
macos-release-arm64OK80
macos-oldrel-arm64OK93
windows-develOK103
windows-releaseOK81
windows-oldrelOK89
wasm-releaseOK107

Exports:boilerplate_add_bibliographyboilerplate_add_entryboilerplate_appendixboilerplate_batch_cleanboilerplate_batch_editboilerplate_batch_edit_multiboilerplate_check_healthboilerplate_copy_bibliographyboilerplate_copy_from_projectboilerplate_discussionboilerplate_exportboilerplate_find_charsboilerplate_generate_measuresboilerplate_generate_textboilerplate_get_entryboilerplate_importboilerplate_initboilerplate_list_filesboilerplate_list_pathsboilerplate_list_projectsboilerplate_measuresboilerplate_measures_reportboilerplate_methodsboilerplate_migrate_to_jsonboilerplate_path_existsboilerplate_rds_to_jsonboilerplate_remove_entryboilerplate_restore_backupboilerplate_resultsboilerplate_saveboilerplate_sort_dbboilerplate_standardise_measuresboilerplate_templateboilerplate_update_bibliographyboilerplate_update_entryboilerplate_validate_referencescompare_rds_jsonvalidate_json_database

Dependencies:clicurldigestjsonlitejsonvalidateR6RcppV8

Bibliography Management with boilerplate
Introduction | Overview: Why Centralised Bibliography Management? | Setting Up Bibliography Management | Step 1: Configure Your Bibliography Source | Step 2: Download and Cache the Bibliography | Step 3: Copy Bibliography to Your Project | Validating References | Verify All Citations Exist | Handle Missing References | Integration with Document Generation | Automatic Bibliography Distribution | Quarto/R Markdown Integration | Advanced Workflows | Project-Specific Bibliography Subsets | Multi-Author Collaboration | Automated Reference Verification | Best Practices | 1. Maintain a Central Bibliography | 2. Cache Management | 3. Citation Key Conventions | Troubleshooting | Common Issues and Solutions | Bibliography Not Downloading | Cache Issues | Validation Errors | Complete Example Workflow | Summary

Last update: 2026-07-09
Started: 2025-06-05

boilerplate Package Architecture
Overview | Core Architecture Components | 1. Unified Database System | Key Design Principles | 2. Path System | Path Operations | 3. Template Variable System | Variable Scoping | 4. File Organisation | Data Flow Architecture | 1. Initialisation Flow | 2. Import Flow | 3. Text Generation Flow | Key Design Patterns | 1. Function Naming Convention | 2. Error Handling Strategy | 3. Extensibility Points | Adding New Categories | Adding New Formats | 4. Performance Considerations | Database Schema | Unified Database Structure | Entry Types | Text Entries (methods, results, discussion) | Measure Entries | Testing Architecture | Test Organisation | Testing Strategy | Security Considerations | Future Architecture Considerations | Planned Enhancements | Backwards Compatibility

Last update: 2026-07-09
Started: 2025-06-05

Getting Started with boilerplate: A Complete Workflow
Introduction | Scenario: Writing a Psychology Manuscript | Step 1: Initial Project Setup | Install and Load the Package | Create Project Structure | Step 2: Explore the Default Content | View Available Methods | View Available Measures | Step 3: Customise for Your Study | Add Study-Specific Methods | Add Study-Specific Measures | Step 4: Set Up Bibliography Management | Step 5: Generate Your Methods Section | Define Study Parameters | Generate Complete Methods Section | Step 6: Generate Measures Section | Generate output for political orientation if we added it | Step 7: Validate Your Work | Verify Database Structure | Verify References | Export for Version Control | Step 8: Create Your Manuscript | Quarto Document Example | Measures | Results | Discussion | 2. Multiple Manuscripts from Same Dataset | 3. Batch Updates | 4. Quality Control | Summary | Next Steps

Last update: 2026-07-09
Started: 2025-06-05

Internal Functions Guide for Developers
Introduction | Core Database Operations | Database Structure Navigation | get_nested_folder() | modify_nested_entry() | Database Utilities | sort_db_recursive() | merge_recursive_lists() | Template System | apply_template_vars() | File I/O Operations | get_db_file_path() | read_boilerplate_db() | write_boilerplate_db() | Default Databases | get_default_db() | Category-specific getters | JSON Support Functions | standardise_json_structure() | clean_for_json() | Bibliography Support | parse_bibtex_keys() | extract_citation_keys() | Migration Utilities | detect_database_type() | migrate_to_unified_json() | Measures-Specific Functions | transform_label() | Best Practices for Using Internal Functions | Contributing New Internal Functions

Last update: 2026-07-09
Started: 2025-06-05

Introduction to boilerplate
Overview | Key Features | Quick Start | 1. Initialise Databases | 2. Import Databases | 3. Generate Text | 4. Generate Measure Descriptions | Working with Databases | Viewing Database Content | Adding and Updating Content | Batch Operations | Template System | Best Practices | Advanced Features | Measure Standardisation | Cross-Project Workflows | Managing Database Versions | Listing Available Versions | Working with Timestamped Versions | Backup and Restore | Getting Help

Last update: 2026-07-09
Started: 2025-06-05

Introduction to boilerplate: Practical Examples
Why Boilerplate? | Real-World Example: A Multi-Study Project | Setting Up the Project | Creating Reusable Methods Components | Study 1: Pilot Study | Study 2: Main Study | Managing Measures Across Studies | Creating a Measure Library | Generating Consistent Measure Descriptions | Collaborative Features | Sharing Across Team Members | Batch Updates | Advanced Workflows | Dynamic Report Generation | Quality Control | Integration with R Markdown/Quarto | Document Generation | Best Practices | 1. Organize Your Content Hierarchically | 2. Use Meaningful Variable Names | 3. Version Control Your Boilerplate | 4. Create Project-Specific Templates | Summary

Last update: 2026-07-09
Started: 2025-06-05

JSON Schema Documentation
Overview | Unified Database Schema | Methods Database Schema | Basic Structure | Entry Variants | Fields | Measures Database Schema | Complete Example | Required Fields | Optional Fields | For All Types | For Categorical/Ordinal | For Continuous | For Scales | Results Database Schema | Template Database Schema | Variable Scoping | Schema Validation | JSON Schema Files | Validation in R | Common Validation Errors | Migration from RDS | Converting RDS to JSON | Format Differences | JSON Format (default) | RDS Format (not written by package APIs) | Handling Special Cases | Best Practices | File Organisation | Naming Conventions | Version Control | Performance Considerations | Examples | Creating a New Measures Entry | Adding a Methods Entry with Variants | Template Variables with Overrides

Last update: 2026-07-09
Started: 2025-06-05

Managing Multiple Projects with boilerplate
Introduction | Project Basics | Default Project | Creating a New Project | Working with Projects | Project Organization | Cross-Project Operations | Listing Projects | Copying Between Projects | Conflict Handling | Practical Workflow Example | Best Practices | Migration from Pre-1.1.0 | Summary

Last update: 2026-07-09
Started: 2025-06-12

Using boilerplate with Quarto for Scientific Writing
Introduction | Why Use boilerplate with Quarto? | Setting Up a Quarto Project | Recommended Project Structure | Initialise boilerplate | Configure .gitignore | Building Your Text Database | Methods Templates | Measures Database | Using Templates in Quarto | Example Quarto Document Structure | Best Practices | Bibliography Management | Automatic Bibliography Copying | Validating Citations | Advanced Features | Batch Updates | Quarto Parameters | Conclusion

Last update: 2026-07-09
Started: 2025-06-05

Version Management and Backup Recovery
Overview | Managing Multiple Versions | Working with Timestamped Versions | Backup and Recovery | Version Management Workflow | Best Practices | Integration with Version Control | Troubleshooting | Finding Lost Work | Recovering from Corruption | Summary

Last update: 2026-07-09
Started: 2025-06-06

Working with JSON Databases in boilerplate
Introduction | Basic JSON Operations | Importing and Saving JSON Databases | Working with Category-Specific JSON Files | Migrating from RDS to JSON | Batch Editing JSON Databases | Standardising Measures in JSON Format | Validating JSON Structure and Health | Schema Validation | Database Validation | Integration with Existing Workflow | Best Practices | Conclusion

Last update: 2026-07-09
Started: 2025-06-05

Working with Measures in boilerplate
Overview | Quick Start: Adding and Using Measures | Basic Workflow | Understanding Measure Structure | Required Fields | Optional Fields | Common Mistakes to Avoid | ❌ Incorrect: Nesting measures under categories | ✅ Correct: Top-level measure entries | Managing Multiple Measures | Adding Multiple Measures at Once | Interactive Management | Standardising Measures | What Standardisation Does | Running Standardisation | Example: Before and After Standardisation | Before: | After standardisation: | Generating Quality Reports | Basic Quality Assessment | Detailed Quality Analysis | Batch Operations on Measures | Finding Entries to Clean | Batch Cleaning | Batch Editing | Generating Formatted Output | Basic Measure Text | Multiple Measures with Categories | Advanced Formatting Options | Complete Workflow Example | Best Practices | 1. Measure Organisation | 2. Quality Control | 3. Workflow Tips | 4. Integration with Text Generation | Troubleshooting | Common Issues | Measure not found | Standardisation warnings | Missing required fields | Getting Help | Summary

Last update: 2026-07-09
Started: 2025-06-05

Readme and manuals

Help Manual

Help pageTopics
Add Bibliography to Databaseboilerplate_add_bibliography
Access Appendix Contentboilerplate_appendix
Batch Clean Fields in boilerplate Databaseboilerplate_batch_clean
Batch Edit Fields in boilerplate Databaseboilerplate_batch_edit
Batch Edit Multiple Fields at Onceboilerplate_batch_edit_multi
Check Database Healthboilerplate_check_health
Copy Bibliography to Project Directoryboilerplate_copy_bibliography
Copy Elements from One Project to Anotherboilerplate_copy_from_project
Access Discussion Contentboilerplate_discussion
Export boilerplate Databaseboilerplate_export
Find Entries with Specific Characters in Fieldsboilerplate_find_chars
Generate Formatted Text for Measuresboilerplate_generate_measures
Generate Text from boilerplateboilerplate_generate_text
Import boilerplate Database(s)boilerplate_import
Initialise boilerplate Databaseboilerplate_init
List Available boilerplate Database Filesboilerplate_list_files
List Available Projectsboilerplate_list_projects
Access Measures from Unified Databaseboilerplate_measures
Report on Measure Database Qualityboilerplate_measures_report
Access Methods from Unified Databaseboilerplate_methods
Migration Utilities for RDS to JSON Conversionboilerplate_migrate_to_json
Path-Based Database Operationsboilerplate_add_entry boilerplate_get_entry boilerplate_list_paths boilerplate_path_exists boilerplate_path_ops boilerplate_remove_entry boilerplate_sort_db boilerplate_update_entry
Convert RDS Database to JSONboilerplate_rds_to_json
Restore Database from Backupboilerplate_restore_backup
Access Results from Unified Databaseboilerplate_results
Save boilerplate Databaseboilerplate_save
Standardise Measure Entries in Databaseboilerplate_standardise_measures
Access Template Contentboilerplate_template
Update Bibliography from Remote Sourceboilerplate_update_bibliography
Validate References in boilerplate Databaseboilerplate_validate_references
Compare RDS and JSON Databasescompare_rds_json
Print Method for boilerplate_filesprint.boilerplate_files
Validate JSON Database Against Schemavalidate_json_database