Contributing

Tak for din interesse i at bidrage til BentoPDF! Denne vejledning hjælper dig i gang.

Kom i gang

Forudsætninger

• Node.js 18+
• npm 9+
• Git

Opsætning

# Fork and clone the repository
git clone https://github.com/YOUR_USERNAME/bentopdf.git
cd bentopdf

# Install dependencies
npm install

# Start development server
npm run dev

Projektstruktur

bentopdf/
├── src/
│   ├── js/
│   │   ├── config/       # Tool definitions
│   │   ├── logic/        # Tool page logic
│   │   ├── utils/        # Shared utilities
│   │   └── ui.ts         # UI helpers
│   ├── pages/            # Tool HTML pages
│   └── css/              # Styles
├── public/
│   ├── locales/          # Translations
│   └── pymupdf-wasm/     # WASM modules
├── docs/                 # Documentation (VitePress)
└── scripts/              # Build scripts

Tilføj et nyt værktøj

Trin 1: Opret logikfilen

Opret src/js/logic/your-tool-page.ts:

import { showLoader, hideLoader, showAlert } from '../ui.js';
import { state } from '../state.js';

document.addEventListener('DOMContentLoaded', () => {
  // Your tool logic here
});

Trin 2: Opret HTML-siden

Opret src/pages/your-tool.html efter de eksisterende værktøjsskabeloner.

Trin 3: Registrer værktøjet

Tilføj til src/js/config/tools.ts:

{
  href: import.meta.env.BASE_URL + 'your-tool.html',
  name: 'Your Tool',
  icon: 'ph-icon-name',
  subtitle: 'Description of your tool.',
}

Trin 4: Tilføj til build-konfigurationen

Tilføj siden til vite.config.ts:

'your-tool': resolve(__dirname, 'src/pages/your-tool.html'),

Trin 5: Tilføj oversættelser

Tilføj poster til alle sprogfiler i public/locales/:

{
  "yourTool": {
    "name": "Your Tool",
    "subtitle": "Description"
  }
}

Kodestil

• Brug TypeScript til al ny kode
• Følg eksisterende mønstre for at holde det ensartet
• Kør npm run format før du committer
• Ingen kommentarer i produktionskode (kommentarer fjernes under build)

Pull request-processen

1. Opret en feature-branch: git checkout -b feature/your-feature
2. Foretag dine ændringer
3. Test grundigt: npm run build
4. Send en PR med en tydelig beskrivelse

Oversættelse

Se TRANSLATION.md for at tilføje nye sprog.

Contributor License Agreement

Før din PR kan flettes, skal du underskrive vores CLA:

• Individuel CLA (ICLA)
• Virksomheds-CLA (CCLA)

Få hjælp

• GitHub Issues
• Discord-fællesskab

Licens

BentoPDF er dobbeltlicenseret:

• AGPL-3.0 til open source-projekter, hvor du deler hele din kildekode offentligt
• Kommerciel licens til proprietære applikationer med lukket kildekode: Få en livstidslicens for $79

Når du bidrager, accepterer du, at dine bidrag licenseres på disse vilkår.