pax_global_header 0000666 0000000 0000000 00000000064 15201735340 0014512 g ustar 00root root 0000000 0000000 52 comment=e688c051e6d05c20730c9f482216bfb40024585a
untra-polyglot-e688c05/ 0000775 0000000 0000000 00000000000 15201735340 0015056 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/.bundle/ 0000775 0000000 0000000 00000000000 15201735340 0016405 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/.bundle/config 0000664 0000000 0000000 00000000041 15201735340 0017570 0 ustar 00root root 0000000 0000000 ---
BUNDLE_PATH: "vendor/bundle"
untra-polyglot-e688c05/.circleci/ 0000775 0000000 0000000 00000000000 15201735340 0016711 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/.circleci/config.yml 0000664 0000000 0000000 00000002223 15201735340 0020700 0 ustar 00root root 0000000 0000000 version: 2.1
orbs:
ruby: circleci/ruby@1.0
codecov: codecov/codecov@5.3.0
jobs:
lint:
docker:
- image: cimg/ruby:3.1
steps:
- checkout
- ruby/install-deps
- run:
name: RuboCop
command: bundle exec rubocop --format progress
test:
docker:
- image: cimg/ruby:3.1
environment:
CI: 'true'
CODECOV_TOKEN: ${CODECOV_TOKEN}
steps:
- checkout
- ruby/install-deps
- run:
name: Run tests and generate coverage
command: ./test.sh
- store_test_results:
path: rspec.xml
- store_artifacts:
path: coverage
destination: coverage
htmlproofer:
docker:
- image: cimg/ruby:3.1
steps:
- checkout
- ruby/install-deps
- run:
name: Build example site and run html-proofer
command: bundle exec rake htmlproofer
- store_artifacts:
path: site/_site
destination: site
workflows:
version: 2
build_and_test:
jobs:
- lint
- test:
requires:
- lint
- htmlproofer:
requires:
- lint
untra-polyglot-e688c05/.gemini/ 0000775 0000000 0000000 00000000000 15201735340 0016404 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/.gemini/settings.json 0000664 0000000 0000000 00000000127 15201735340 0021137 0 ustar 00root root 0000000 0000000 {
"context": {
"fileName": [
"AGENTS.md",
"ai_docs/*.md"
]
}
}
untra-polyglot-e688c05/.github/ 0000775 0000000 0000000 00000000000 15201735340 0016416 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/.github/PULL_REQUEST_TEMPLATE.md 0000664 0000000 0000000 00000001401 15201735340 0022213 0 ustar 00root root 0000000 0000000 ## π€ Polyglot PR
> Description here
## Type of change
- [ ] Docs update (changes to the readme or a site page, no code changes)
- [ ] Ops wrangling (automation or test improvements)
- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [ ] Sweet release (needs a lot of work and effort)
- [ ] Something else (explain please)
### Checklists
- [ ] If modifying code, at least one test has been added to the suite
untra-polyglot-e688c05/.github/agents/ 0000775 0000000 0000000 00000000000 15201735340 0017677 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/.github/agents/code-quality.agent.md 0000664 0000000 0000000 00000021044 15201735340 0023717 0 ustar 00root root 0000000 0000000 ---
name: ruby-code-quality-agent
description: Expert Ruby code quality and standards reviewer for jekyll-polyglot
target: github-copilot
---
You are an expert Ruby code quality specialist for jekyll-polyglot, a Jekyll i18n plugin. Your role is to analyze code for adherence to Ruby best practices, project-specific conventions, and the exact RuboCop configuration used by this project.
## Your Expertise
- **Ruby standards knowledge:** You understand Ruby 3.1+ conventions and idioms
- **RuboCop enforcement:** You can identify code that violates the project's specific `.rubocop.yml` rules
- **Jekyll plugin architecture:** You understand hooks, patches, and Liquid filters in the context of Jekyll plugins
- **Code smell detection:** You recognize anti-patterns and suggest idiomatic Ruby solutions
- **Test quality:** You evaluate RSpec test structure and effectiveness
## Project Knowledge
- **Tech Stack:** Ruby 3.1.0+, Jekyll >= 4.0, RSpec for testing, RuboCop for linting
- **File Structure:**
- `lib/jekyll/polyglot/` β Core plugin code (hooks, patches, liquid filters)
- `lib/jekyll/polyglot/hooks/` β Jekyll hook integrations
- `lib/jekyll/polyglot/patches/` β Extensions to Jekyll core classes
- `lib/jekyll/polyglot/liquid/` β Liquid filters and custom tags
- `spec/` β RSpec test suite
- **Key Config:** `.rubocop.yml` (TargetRubyVersion: 3.1, LineLength disabled, specific indentation rules)
## Commands You Can Run
```bash
# Check code against RuboCop rules
bundle exec rubocop lib/jekyll/polyglot/
# Check a specific file
bundle exec rubocop lib/jekyll/polyglot/hooks.rb
# Auto-fix RuboCop violations
bundle exec rubocop -A lib/jekyll/polyglot/
# Run tests to verify code works
COVERAGE=true bundle exec rspec
# Run linting and tests (full validation)
bash test.sh
```
## Code Style Standards for jekyll-polyglot
### Naming Conventions
- **Methods and variables:** `snake_case` (e.g., `hook_coordinate`, `active_lang`)
- **Classes and modules:** `PascalCase` (e.g., `Jekyll::Polyglot::Liquid`)
- **Constants:** `UPPER_SNAKE_CASE` (e.g., `DEFAULT_LANG`)
- **Private methods:** Prefix with underscore if needed (e.g., `_merge_data`)
### Indentation and Formatting
- **Indentation:** 2 spaces (never tabs)
- **Line length:** No enforced limit (disabled in `.rubocop.yml`)
- **Hash indentation:** Use fixed indentation for method parameters
- **Method call chains:** Use indented style for multiline calls
### Correct Code Examples
**Good: Clean hook with proper structure**
```ruby
Jekyll::Hooks.register :site, :post_read do |site|
hook_coordinate(site)
end
def hook_coordinate(site)
# Merge language data with proper recursion
merger = proc { |_key, v1, v2| v1.is_a?(Hash) && v2.is_a?(Hash) ? v1.merge(v2, &merger) : v2 }
if site.data.include?(site.default_lang)
site.data = site.data.merge(site.data[site.default_lang], &merger)
end
site.collections.each_value do |collection|
collection.docs = site.coordinate_documents(collection.docs)
end
end
```
**Good: Module structure with clear requires**
```ruby
module Jekyll
module Polyglot
module Liquid
require_relative 'liquid/tags/i18n_headers'
require_relative 'liquid/tags/static_href'
end
end
end
```
**Bad: Inconsistent indentation and unclear logic**
```ruby
def hook_coordinate(site)
# Inconsistent spacing and unclear variable names
m = proc { |_key, v1, v2| v1.is_a?(Hash) && v2.is_a?(Hash) ? v1.merge(v2, &m) : v2 }
if site.data.include?(site.default_lang)
site.data = site.data.merge(site.data[site.default_lang], &m) # Bad: wrong indentation
end
end
```
**Bad: Patch that overrides instead of extends**
```ruby
# β WRONG - Overrides existing Jekyll method completely
class Jekyll::Site
def each_site_file
# This breaks Jekyll's original behavior
end
end
# β
CORRECT - Adds new method or carefully patches
module Jekyll
class Site
def polyglot_lang_from_path(path)
# New method that extends functionality
end
end
end
```
### Performance Patterns
- **Avoid N+1 queries:** Group documents by language first, then iterate
- **Cache computations:** Store language mappings to avoid recalculating
- **Lazy evaluation:** Use `.each` over `.map` when not collecting results
### Testing Standards
- **Test location:** `spec/jekyll/polyglot/` mirrors `lib/jekyll/polyglot/` structure
- **Test naming:** Descriptive names like `coordinate_spec.rb` for testing `coordinate.rb`
- **Coverage target:** Aim for >90% on new code
- **RSpec conventions:** Use `describe`, `context`, and `it` blocks
**Good test structure:**
```ruby
describe 'document coordination' do
context 'when multiple documents share a permalink' do
it 'groups them by language' do
# Test implementation
end
end
context 'when documents have different permalinks' do
it 'keeps them separate' do
# Test implementation
end
end
end
```
## Key Rules to Enforce
### Patches and Core Extensions
- β
Only add new methods to Jekyll core classes; never override existing methods
- β
Document why the patch is needed with clear comments
- β
Test patches against multiple Jekyll versions if applicable
- β Never modify Jekyll's internal state without testing side effects
### Hooks
- β
Keep hooks focused on a single responsibility
- β
Test with both `parallel_localization: true` and `false`
- β
Handle edge cases (empty collections, missing languages, etc.)
- β Never assume Jekyll's internal structure is stable
### Liquid Filters
- β
Filters must be pure functions (no side effects)
- β
Handle special characters, unicode, and missing translations
- β
Test with realistic URL patterns and language variations
- β Never modify global state or site configuration from a filter
## Boundaries
- β
**Always:**
- Run `bundle exec rubocop` on all code changes
- Follow 2-space indentation consistently
- Write tests for new features
- Use snake_case for methods, PascalCase for classes
- Comment complex logic, especially in hooks and patches
- β οΈ **Ask First:**
- Changing public method signatures (affects users)
- Adding new dependencies to the gemspec
- Modifying configuration handling in `_config.yml`
- Performance optimizations that change algorithm complexity
- π« **Never:**
- Hard-code API keys, secrets, or configuration values
- Override existing Jekyll methods without thorough testing
- Disable RuboCop rules without clear justification
- Modify files in `vendor/`, `node_modules/`, or `spec/fixture/` (except to add new fixtures)
- Commit code that fails `bash test.sh`
- Add methods to Jekyll core classes that don't extend i18n functionality
## Code Review Checklist
When evaluating code, check these items:
- [ ] Code passes `bundle exec rubocop` with no violations
- [ ] Method and variable names are descriptive and follow `snake_case`
- [ ] Indentation is consistent (2 spaces)
- [ ] Patches only add methods, never override existing ones
- [ ] Hooks handle edge cases (empty collections, missing languages)
- [ ] Liquid filters are pure functions with no side effects
- [ ] Tests exist for new functionality (aim for >90% coverage)
- [ ] Complex logic has explanatory comments
- [ ] No hardcoded secrets, API keys, or configuration values
- [ ] Performance considerations documented for large sites
## Common Issues and Fixes
**Issue:** Method names are too short or unclear (e.g., `merge_data` instead of `merge_language_data`)
**Fix:** Use descriptive names that explain the purpose. For jekyll-polyglot, prefer explicit names like `coordinate_documents`, `merge_lang_data`.
**Issue:** Patch overrides existing Jekyll method
**Fix:** Create a new method instead. Prefix with the plugin name if needed (e.g., `polyglot_process_doc` instead of `process_doc`).
**Issue:** Liquid filter has side effects
**Fix:** Refactor to return only the transformed value. Move state changes to hooks instead.
**Issue:** Hook runs but doesn't handle missing languages
**Fix:** Use `site.languages.include?(lang)` or similar checks before accessing language-specific data.
## RuboCop Configuration Reference
Key rules enforced in this project:
- `Layout/ParameterAlignment: with_fixed_indentation` β Method parameters use fixed indentation
- `Layout/LineLength: disabled` β No line length limit
- `Style/Documentation: disabled` β Documentation comments are optional
- `Style/GuardClause: disabled` β Guard clauses are not required
- `Metrics/CyclomaticComplexity: Max 30` β Keep methods under 30 cyclomatic complexity
- `rubocop-rspec` β RSpec tests follow specific conventions
Run `bundle exec rubocop --show-cops` to see all active rules.
untra-polyglot-e688c05/.github/agents/docs.agent.md 0000664 0000000 0000000 00000007321 15201735340 0022251 0 ustar 00root root 0000000 0000000 ---
name: docs-agent
description: Maintains and updates jekyll-polyglot documentation
---
You are a technical writer responsible for keeping jekyll-polyglot documentation clear, accurate, and current.
## Your role
- You read Ruby source code and update documentation to reflect current behavior
- You keep docs concise and straight-to-the-point, avoiding unnecessary examples
- You link to existing code and library documentation instead of duplicating content
- You write for developers who are familiar with Jekyll and Ruby
## Project knowledge
**Tech Stack:** Ruby 3.1.0+, Jekyll >= 4.0, RSpec, RuboCop
**Main Documentation Files** (root directory):
- `README.md` β Plugin overview, installation, basic configuration
- `CONTRIBUTING.md` β Contributor guidelines
- `AGENTS.md` β Contributor personas and workflows
- `ai_docs/` β Detailed architecture and testing guides
**Source Code Structure:**
- `lib/jekyll/polyglot/` β Core plugin code
- `lib/jekyll/polyglot/hooks.rb` β Jekyll hook integration
- `lib/jekyll/polyglot/patches.rb` β Jekyll core class extensions
- `lib/jekyll/polyglot/liquid.rb` β Custom Liquid filters and tags
- `spec/` β RSpec test suite (mirrors `lib/` structure)
- `site/` β Example multi-language Jekyll site
**Instruction Files** (source of truth):
- `.github/instructions/hooks.instructions.md`
- `.github/instructions/liquid.instructions.md`
- `.github/instructions/patches.instructions.md`
- `.github/instructions/spec.instructions.md`
## Commands you can use
```bash
# Check syntax of all markdown files
npx markdownlint "*.md" "ai_docs/*.md" --config .markdownlint.json
# Verify links in documentation
# (use grep or manual verification for internal links)
grep -r "\[.*\](.*)" *.md ai_docs/
# Run tests to verify code examples still work
bundle install
COVERAGE=true bundle exec rspec
# Check linting for code examples in docs
bundle exec rubocop
```
## Documentation standards
**Be concise and direct:**
- Start with the essential information
- Avoid lengthy introductions or unnecessary context
- One clear example beats three variations
**Link instead of duplicate:**
- Link to source files when explaining implementation details (e.g., link to `lib/jekyll/polyglot/hooks.rb` instead of reproducing its code)
- Link to [Jekyll documentation](https://jekyllrb.com/docs/) for Jekyll-specific features
- Link to [Ruby documentation](https://ruby-doc.org/) for Ruby standard library features
- Link to [I18n language codes](https://developer.chrome.com/docs/extensions/reference/api/i18n#locales) for language code reference
**Documentation structure example:**
````markdown
## Document Coordination
Documents are grouped by their permalink across languages. Each document declares its language via `lang` frontmatter:
```yaml
lang: de
```
See [hooks/coordinate.rb](../../lib/jekyll/polyglot/hooks/coordinate.rb) for the coordination implementation.
````
**Don't draw UI elements:**
- Avoid ASCII diagrams, box drawings, or visual representations that change easily
- Use text descriptions or links to code instead
## Boundaries
β
**Always do:**
- Update documentation when source code changes
- Link to code files and library documentation
- Keep examples minimal and focused
- Run markdownlint and verify no broken links
- Update `ai_docs/` instruction files when architecture changes
β οΈ **Ask first:**
- Before restructuring major documentation sections
- Before adding new markdown files to root or `ai_docs/`
- Before significant rewrites of existing docs
π« **Never do:**
- Modify source code in `lib/` or `spec/`
- Commit secrets or API keys
- Repeat code content that's already documented in source files
- Create UI mockups or visual diagrams
- Commit outdated examples or broken links
untra-polyglot-e688c05/.github/copilot-instructions.md 0000664 0000000 0000000 00000015757 15201735340 0023172 0 ustar 00root root 0000000 0000000 # Copilot Coding Agent Instructions for jekyll-polyglot
## Repository Overview
**jekyll-polyglot** is a fast, open-source internationalization (i18n) plugin for Jekyll static site generator blogs. It enables multi-language Jekyll sites with fallback support, automatic URL relativization, and SEO tools.
- **Type**: Ruby gem / Jekyll plugin
- **Size**: ~516 lines of source code across 11 files
- **Primary Language**: Ruby 3.1.0+
- **Framework Dependencies**: Jekyll >= 4.0
- **Testing Framework**: RSpec with SimpleCov coverage
- **Linting**: RuboCop with performance and RSpec plugins
- **CI/CD**: CircleCI with Codecov for coverage tracking
## Essential Commands
Always run these commands in this order:
```bash
# 1. Install dependencies (REQUIRED - always run first)
bundle install
# 2. Run linting only (quick check, ~10 seconds)
bundle exec rubocop
# 3. Run tests with coverage (full validation, ~30 seconds)
COVERAGE=true bundle exec rspec
# 4. Build gem and test example site (optional, for integration testing)
bash make.sh
```
**Do not skip step 1.** Always run `bundle install` before running any other commands, even if you think dependencies are already installed.
## Build and Validation Checklist
Before opening a pull request, **always verify**:
- [ ] Run `bundle install` (dependencies)
- [ ] Run `bundle exec rubocop` (linting passes)
- [ ] Run `COVERAGE=true bundle exec rspec` (all tests pass)
- [ ] New code includes tests (aim for >90% coverage)
- [ ] No test files added/modified unless code changes require it
- [ ] Changes follow conventional commit format: `type(scope): description`
Failing any of these will cause the PR to be rejected by CircleCI.
## Project Structure
```
lib/
jekyll-polyglot.rb # Gem entry point
jekyll/polyglot.rb # Main plugin loader
jekyll/polyglot/
hooks.rb # Jekyll hook integration (post_init, etc.)
patches.rb # Jekyll core class patches
liquid.rb # Custom Liquid filters/tags
version.rb # Version constant (update for releases)
hooks/
coordinate.rb # Document grouping by language
process.rb # Main hook orchestration
assets-toggle.rb # Asset filtering per language
liquid/tags/
i18n_headers.rb # SEO hreflang generation
static_href.rb # URL relativization filter
patches/jekyll/
site.rb # Site class extensions
[other patch files]
spec/
jekyll/polyglot/ # RSpec test suite (mirrors lib/ structure)
fixture/ # Sample Jekyll sites for integration tests
spec_helper.rb # RSpec configuration
site/ # Example polyglot blog (multi-language demo)
Configuration & Build:
.rubocop.yml # RuboCop linting rules (TargetRubyVersion: 3.1)
.rspec # RSpec configuration (outputs rspec.xml, rspec.json)
.circleci/config.yml # CircleCI pipeline (Ruby 3.1 Docker image)
codecov.yml # Codecov coverage threshold (80% target)
jekyll-polyglot.gemspec # Gem specification (version, dependencies, metadata)
Gemfile # Development dependencies
```
## CI/CD Pipeline Validation
CircleCI automatically runs these steps on every PR:
1. **Build job**: Runs on Ruby 3.1 Docker image, installs dependencies via `ruby/install-deps` orb
2. **Test job**: Runs `./test.sh` which:
- Executes `bundle exec rubocop` (linting)
- Executes `COVERAGE=true bundle exec rspec` (tests + coverage)
- Generates `rspec.xml` and `rspec.json` for test reporting
- Uploads coverage to Codecov (requires `CODECOV_TOKEN` in CI environment)
**If tests fail locally, they will fail in CircleCI.** Always validate locally before pushing.
## Key Architecture Patterns
### Document Coordination
The plugin groups Jekyll documents by their permalink across languages:
- Documents declare language via `lang` frontmatter property
- Documents with identical permalinks are "coordinated" as translations
- Optional `page_id` frontmatter (v1.7.0+) allows different URLs per language
### Three Integration Points
1. **Hooks** (`hooks.rb`): Intercept Jekyll build process at key points
- `post_init` hook: Sets up language mappings after Jekyll initializes
- Runs serially or parallel based on `parallel_localization` config
2. **Patches** (`patches.rb`): Extend Jekyll core classes with i18n methods
- Add language detection, document grouping, URL relativization
- Only add methods; never override existing behavior
3. **Liquid Filters and Tags** (`liquid.rb`): Template-level internationalization
- `static_href` tag: Relativizes URLs for multi-language sites
- `i18n_headers` tag: Generates SEO hreflang links
## Coding Standards
**RuboCop enforces all style rules.** Configuration in `.rubocop.yml` requires:
- Ruby 3.1+ syntax
- 2-space indentation
- No line length limit (disabled in config)
- Specific method indentation rules (see config file)
Run `bundle exec rubocop` to check. The CI pipeline will fail if RuboCop finds issues.
## Testing Requirements
**All code changes must include tests.** Test structure mirrors `lib/`:
- New code in `lib/jekyll/polyglot/hooks.rb` β add tests to `spec/jekyll/polyglot/hooks_spec.rb`
- Tests use RSpec `describe`, `context`, and `it` blocks
- Use fixture sites in `spec/fixture/` for integration testing against real Jekyll builds
Coverage is tracked by Codecov. Target >90% for new code.
## Common Pitfalls
- **Don't skip `bundle install`**: Even if you think dependencies are installed, run it. Bundler manages the exact versions.
- **Don't modify version.rb casually**: Only update `lib/jekyll/polyglot/version.rb` during releases.
- **Don't patch Jekyll classes without testing**: Changes to `patches.rb` must be thoroughly tested across Jekyll versions.
- **Don't hard-code secrets**: All configuration comes from `_config.yml`; never embed API keys.
- **Don't assume RuboCop won't complain**: Run locally before committing; CircleCI will reject non-compliant code.
## Debugging Tips
- **If tests fail**: Check that you ran `bundle install` first. Then run `COVERAGE=true bundle exec rspec` with verbose output: `bundle exec rspec --format documentation`
- **If RuboCop complains**: Run `bundle exec rubocop -A` to auto-fix fixable issues (but review changes)
- **If build.sh fails**: Navigate to `site/` and run `jekyll build` directly to see detailed Jekyll output
- **For integration testing**: The `spec/fixture/` directory contains sample Jekyll sites; run tests against these to catch real-world issues
## Additional Resources
Refer to [AGENTS.md](../AGENTS.md) for contributor guidelines and detailed documentation:
- [ARCHITECTURE.md](../ai_docs/ARCHITECTURE.md) β In-depth plugin design and data model
- [TESTING.md](../ai_docs/TESTING.md) β Detailed test writing patterns
- [SECURITY.md](../ai_docs/SECURITY.md) β Security constraints and best practices
untra-polyglot-e688c05/.github/instructions/ 0000775 0000000 0000000 00000000000 15201735340 0021162 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/.github/instructions/hooks.instructions.md 0000664 0000000 0000000 00000007640 15201735340 0025401 0 ustar 00root root 0000000 0000000 ---
applyTo: "lib/jekyll/polyglot/hooks.rb,lib/jekyll/polyglot/hooks/**/*.rb"
---
# Hooks and Hook Implementation Instructions
## Overview
The `hooks.rb` and `hooks/` directory contain Jekyll hook integrations that intercept the Jekyll build process to add i18n capabilities.
## Hook Execution Model
- The `post_init` hook runs in `lib/jekyll/polyglot/hooks.rb` and sets up configuration after Jekyll initializes
- Individual hooks in `hooks/` directory are called during the build process
- Hooks run **serially by default** but can run in parallel based on `parallel_localization` config
- Always test with both serial and parallel execution enabled
## Jekyll Hook Lifecycle
Polyglot uses hooks from Jekyll's hook system. Key hook points in the Jekyll build process:
- **`:site, :after_init`** β Just after the site initializes; good for modifying site configuration
- **`:documents, :post_init`** β Whenever any document is initialized
- **`:documents, :pre_render`** β Just before rendering a document (receives document + payload hash)
- **`:documents, :post_convert`** β After converting document content, before rendering layout
- **`:documents, :post_render`** β After rendering a document, before writing to disk
- **`:documents, :post_write`** β After writing a document to disk
Note: Individual collection hooks like `:posts` also work (documents in `_posts` collection).
## When Adding/Modifying Hooks
1. **Understand Jekyll's hook lifecycle**: Hooks intercept at specific points (post_init, post_write, etc.)
2. **Test with sample sites**: Use `spec/fixture/` sites with various language configurations
3. **Document the hook purpose**: Add comments explaining when/why the hook runs
4. **Test parallel behavior**: If modifying process flow, verify behavior with `parallel_localization: true` and `false`
5. **Run full test suite**: `COVERAGE=true bundle exec rspec spec/jekyll/polyglot/hooks/`
## Common Hook Tasks
- **Document coordination**: Grouping documents by language happens in `hooks/coordinate.rb`
- **Asset filtering**: Per-language asset processing in `hooks/assets-toggle.rb`
- **Build orchestration**: Main hook logic in `hooks/process.rb`
## Hook Parameters
When registering hooks, understand the parameters passed to each hook:
- **`:post_init` hooks** receive the object being initialized (site, document, page, etc.)
- **`:pre_render` hooks** receive the object AND a `payload` hash containing Liquid template variablesβmodifying the payload controls what variables are available during rendering
- **`:post_convert` hooks** receive the object (available in Jekyll >= 4.2.0)
- **`:post_render` hooks** receive the object and rendered output
- **`:post_write` hooks** receive the object after writing to disk
For `:site, :post_render`, the payload contains final values after rendering the entire site (useful for sitemaps, feeds, etc.)
## Testing Hooks
Hooks are tested in `spec/jekyll/polyglot/hooks/` with integration tests against fixture Jekyll sites. When modifying a hook:
1. Add/update tests in the corresponding spec file
2. Run the specific hook tests: `bundle exec rspec spec/jekyll/polyglot/hooks/coordinate_spec.rb`
3. Run all hook tests: `bundle exec rspec spec/jekyll/polyglot/hooks/`
4. Verify RuboCop compliance: `bundle exec rubocop lib/jekyll/polyglot/hooks.rb`
## Best Practices for Hooks
- **Minimize hook scope**: Only register hooks for the specific owners/events you need
- **Avoid side effects in hooks**: Keep hooks pure; don't modify global state unless necessary
- **Log hook execution**: Use `Jekyll.logger.debug` to help with debugging hook behavior
- **Test with realistic content**: Use fixture sites with actual post/page/document structures
- **Consider performance**: Hooks run for every object; avoid expensive operations in frequently-triggered hooks like `:post_init`
- **Document hook dependencies**: If a hook depends on another hook running first, add comments explaining the execution order
untra-polyglot-e688c05/.github/instructions/liquid.instructions.md 0000664 0000000 0000000 00000007473 15201735340 0025551 0 ustar 00root root 0000000 0000000 ---
applyTo: "lib/jekyll/polyglot/liquid.rb,lib/jekyll/polyglot/liquid/**/*.rb"
---
# Liquid Filters and Custom Tags Instructions
## Overview
The `liquid.rb` and `liquid/` directory define custom Liquid filters and tags for rendering language-aware content in Jekyll templates.
## Available Filters and Tags
- **`static_href` tag**: Relativizes URLs for multi-language sites
- Used in templates: `{% static_href %}href="/path/to/page"{% endstatic_href %}`
- Must handle both absolute and relative URLs
- **`i18n_headers` tag**: Generates SEO hreflang links
- Creates alternate language links for search engines
## When Adding/Modifying Filters
1. **Keep filters pure**: They should not modify global state or have side effects
2. **Handle edge cases**: Test with special characters, unicode, missing translations
3. **Document the filter**: Add comments explaining parameters and return values
4. **Write comprehensive tests**: Filters are used in templates; test all variations
## Filter Implementation Details
**Filter Structure:**
- Filters are methods in a Ruby module (multiple filters can share a module)
- Method name becomes the filter name (no name mapping needed)
- First parameter is always the input value; additional parameters come after
- Return value is the filter's output
**Registration:**
- Use `Liquid::Template.register_filter(ModuleName)` to globally register a filter
- Filters are registered once when the plugin loads
- Multiple filters can be registered from the same module
**Accessing Context:**
- Filters can access Jekyll configuration via `@context.registers[:site]`
- Use `@context.registers[:site].config` to read `_config.yml` values
- The context object is available as the last parameter if needed (advanced usage)
**Example filter structure:**
```ruby
module Jekyll
module Polyglot
module Filters
def static_href(input)
# First parameter is always the input value
# Method name "static_href" becomes the filter name
# Return the processed value
process_url(input)
end
end
end
end
Liquid::Template.register_filter(Jekyll::Polyglot::Filters)
```
## Testing Liquid Filters
Filters are tested in `spec/jekyll/polyglot/` with unit tests for individual filters and integration tests with Jekyll builds:
1. Add tests in `spec/jekyll/polyglot/liquid_spec.rb` (or create new file for new filters)
2. Test with special characters, unicode, and edge cases
3. Run filter tests: `bundle exec rspec spec/jekyll/polyglot/liquid_spec.rb`
4. Verify RuboCop compliance: `bundle exec rubocop lib/jekyll/polyglot/liquid.rb`
5. Integrate-test with fixture sites using `bash make.sh`
## Common Tasks
- **Adding a new filter**: Create a method in `liquid.rb`, register with Liquid::Template
- **Modifying URL relativization**: Changes to `static_href` must handle all Jekyll permalink styles
- **Adding translations**: Ensure fallback to default language if translation missing
## Tags vs. Filters
**Filters** (used in output):
- Syntax: `{{ value | filter_name }}`
- Simple methods that transform a value
- Take input, return output
- Fast and stateless
**Tags** (block elements):
- Syntax: `{% tag_name args %}...{% endtag_name %}`
- Inherit from `Liquid::Tag` or `Liquid::Block`
- Can contain conditional logic or block content
- Require `initialize`, `render` methods
- Register with `Liquid::Template.register_tag`
Polyglot's `i18n_headers` is a **tag** because it generates complex SEO markup and may contain multiple blocks. If you're adding simple value transformations, use a **filter**.
## Testing URLs and Paths
When testing `static_href`:
- Test with absolute URLs (e.g., `/en/page/`)
- Test with relative URLs (e.g., `../page/`)
- Test with special characters in permalinks
- Test with different Jekyll permalink formats
- Verify output works correctly in multi-language builds
untra-polyglot-e688c05/.github/instructions/patches.instructions.md 0000664 0000000 0000000 00000004251 15201735340 0025700 0 ustar 00root root 0000000 0000000 ---
applyTo: "lib/jekyll/polyglot/patches.rb,lib/jekyll/polyglot/patches/**/*.rb"
---
# Patches and Core Class Extensions Instructions
## Overview
The `patches.rb` and `patches/` directory extend Jekyll core classes with i18n capabilities without modifying Jekyll's source.
## Design Principles for Patches
- **Only add methods**: Never override or replace existing Jekyll methods
- **Minimize changes**: Patches should be the smallest possible extension to achieve i18n
- **Test thoroughly**: Patches modify core Jekyll classes; test against multiple Jekyll versions
- **Document side effects**: Clearly note if patches change Jekyll's behavior in any way
## Patch Locations
- `lib/jekyll/polyglot/patches.rb` β Main patch file; requires and applies all patches
- `lib/jekyll/polyglot/patches/jekyll/site.rb` β Extensions to Jekyll::Site class
- Other `patches/jekyll/` files β Extensions to other Jekyll core classes
## When Modifying Patches
1. **Understand the patched class**: Read Jekyll documentation for the class you're modifying
2. **Add the method, don't override**: Methods should extend functionality, not replace it
3. **Test with sample Jekyll sites**: Use `spec/fixture/` to test against realistic Jekyll configurations
4. **Document the new method**: Add comments explaining what the method does and why it's needed
5. **Write comprehensive tests**: Patches affect core behavior; test extensively
## Testing Patches
Patches are tested in `spec/jekyll/polyglot/` with integration tests against fixture Jekyll sites. When modifying a patch:
1. Add/update tests in `spec/jekyll/polyglot/patches/` with clear names like `spec/jekyll/polyglot/patches/jekyll/site_spec.rb`
2. Run patch tests: `bundle exec rspec spec/jekyll/polyglot/`
3. Verify RuboCop compliance: `bundle exec rubocop lib/jekyll/polyglot/patches.rb`
4. Test with `bash make.sh` to ensure the example site still builds correctly
## Common Pitfalls
- **Don't override existing methods**: This breaks Jekyll's expected behavior
- **Don't assume Jekyll's internal structure**: Jekyll may change internals; test against different Jekyll versions
- **Don't add heavy dependencies**: Patches should be lightweight extensions
untra-polyglot-e688c05/.github/instructions/spec.instructions.md 0000664 0000000 0000000 00000004764 15201735340 0025214 0 ustar 00root root 0000000 0000000 ---
applyTo: "spec/**/*.rb"
---
# Test Suite Instructions
## Test Organization
The test suite is organized to mirror the source code structure:
```
spec/jekyll/polyglot/ # Tests mirror lib/jekyll/polyglot/ structure
hooks/
coordinate_spec.rb # Tests for document coordination
polyglot_hook_spec.rb # Tests for Jekyll hook registration
subprocess_spec.rb # Tests for parallel processing
patches/jekyll/
site_spec.rb # Tests for Jekyll::Site extensions
sitemap_spec.rb # Tests for sitemap generation
spec/fixture/ # Sample Jekyll sites for integration testing
[fixture site directories]
```
## Running Tests
```bash
# Run all tests with coverage
COVERAGE=true bundle exec rspec
# Run tests with verbose output
bundle exec rspec --format documentation
# Run a specific test file
bundle exec rspec spec/jekyll/polyglot/hooks/coordinate_spec.rb
# Run tests matching a pattern
bundle exec rspec --pattern "*coordinate*"
```
## Writing Tests
When adding new features:
1. **Create a test file** in `spec/jekyll/polyglot/` mirroring the source structure
2. **Use RSpec conventions**: `describe`, `context`, and `it` blocks
3. **Test edge cases**: Special characters, unicode, missing translations, empty inputs
4. **Test integration**: Use fixture Jekyll sites to test against realistic builds
5. **Aim for >90% coverage**: New code should maintain high coverage
## Fixture Sites
The `spec/fixture/` directory contains sample Jekyll sites used for integration testing:
- Use fixtures to test document coordination with multiple languages
- Test URL relativization with different permalink formats
- Test fallback behavior when translations are missing
- When adding complex features, consider adding a new fixture
## Coverage Requirements
Coverage is tracked by Codecov with a target of 80% project coverage and 1% threshold tolerance:
- Run `COVERAGE=true bundle exec rspec` to generate coverage reports
- Reports are generated in `coverage/` directory
- Coverage must not decrease; CI will reject PRs with lower coverage
- Aim for >90% on new modules
## Common Assertions in Tests
- **Document grouping**: Verify documents with same permalink are grouped by language
- **URL generation**: Ensure URLs are correctly relativized for each language variant
- **Fallback behavior**: Verify missing content falls back to default language
- **Configuration parsing**: Test with various `_config.yml` configurations
untra-polyglot-e688c05/.github/workflows/ 0000775 0000000 0000000 00000000000 15201735340 0020453 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/.github/workflows/copilot-setup-steps.yml 0000664 0000000 0000000 00000002245 15201735340 0025144 0 ustar 00root root 0000000 0000000 name: "Copilot Setup Steps"
# Automatically run the setup steps when they are changed to allow for easy validation, and
# allow manual testing through the repository's "Actions" tab
on:
workflow_dispatch:
push:
paths:
- .github/workflows/copilot-setup-steps.yml
pull_request:
paths:
- .github/workflows/copilot-setup-steps.yml
jobs:
# The job MUST be called `copilot-setup-steps` or it will not be picked up by Copilot.
copilot-setup-steps:
runs-on: ubuntu-latest
# Set the permissions to the lowest permissions possible needed for your steps.
# Copilot will be given its own token for its operations.
permissions:
# We need `contents: read` to clone the repository
contents: read
# You can define any steps you want, and they will run before the agent starts.
# If you do not check out your code, Copilot will do this for you.
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Set up Ruby
uses: ruby/setup-ruby@v1
with:
ruby-version: "3.1"
bundler-cache: true
- name: Verify setup with linting
run: bundle exec rubocop --version
untra-polyglot-e688c05/.gitignore 0000664 0000000 0000000 00000001171 15201735340 0017046 0 ustar 00root root 0000000 0000000 # Ignore docs files
_gh_pages
.ruby-version
*.gem
# Numerous always-ignore extensions
*.diff
*.err
*.orig
*.log
*.rej
*.swo
*.swp
*.zip
*.vi
*~
# OS or Editor folders
.DS_Store
._*
Thumbs.db
.cache
.project
.settings
.tmproj
*.esproj
nbproject
*.sublime-project
*.sublime-workspace
.idea
# Komodo
*.komodoproject
.komodotools
# grunt-html-validation
validation-status.json
validation-report.json
# Folders to ignore
node_modules
*.gem
Gemfile.lock
**/.jekyll-cache/
.vscode/
_site/**
site/_site
vendor/bundle
# test output
coverage/*
rspec.json
rspec.xml
# NOTE: this will need to be ungitignored to run publish
# site/_site
untra-polyglot-e688c05/.rspec 0000664 0000000 0000000 00000000113 15201735340 0016166 0 ustar 00root root 0000000 0000000 --color
--format RspecJunitFormatter
--out rspec.xml
--require spec_helper
untra-polyglot-e688c05/.rubocop.yml 0000664 0000000 0000000 00000006424 15201735340 0017336 0 ustar 00root root 0000000 0000000 require:
- rubocop-rspec
AllCops:
NewCops: enable
TargetRubyVersion: 3.1
Exclude:
- 'bin/**/*'
- 'db/**/*'
- 'config/**/*'
- 'script/**/*'
- 'vendor/**/*' # Exclude vendor directory to avoid conflicts with Jekyll's RuboCop config
SuggestExtensions: false
# Layout
Layout/ParameterAlignment:
EnforcedStyle: with_fixed_indentation
Layout/CaseIndentation:
EnforcedStyle: end
Layout/FirstHashElementIndentation:
Enabled: false
Layout/MultilineMethodCallIndentation:
EnforcedStyle: indented
Layout/MultilineOperationIndentation:
EnforcedStyle: indented
Layout/SpaceInsideHashLiteralBraces:
Enabled: false
Layout/HashAlignment:
Enabled: true
EnforcedLastArgumentHashStyle: always_ignore
Layout/EndAlignment:
EnforcedStyleAlignWith: variable
Layout/LineLength:
Enabled: false
# Style
Style/AsciiComments:
Enabled: false
Style/CollectionMethods:
Enabled: true
PreferredMethods:
inject: 'inject'
Style/Documentation:
Enabled: false
Style/BlockDelimiters:
Exclude:
- spec/**/*_spec.rb
Style/GuardClause:
Enabled: false
Style/IfUnlessModifier:
Enabled: false
Style/Lambda:
Enabled: false
Style/RaiseArgs:
Enabled: false
Style/SignalException:
Enabled: false
Style/SingleLineBlockParams:
Enabled: false
Style/FormatString:
Enabled: false
Style/WordArray:
Enabled: false
Style/RedundantSelf:
Enabled: false
Style/TrivialAccessors:
AllowPredicates: true
Style/RedundantReturn:
Description: 'Do not use return in an ensure block.'
StyleGuide: '#no-return-ensure'
Enabled: true
# Metrics
Metrics/PerceivedComplexity:
Max: 30
Metrics/CyclomaticComplexity:
Max: 30
Metrics/AbcSize:
Max: 75
Metrics/ClassLength:
Max: 300
Metrics/ModuleLength:
Max: 200
Metrics/MethodLength:
Max: 50
# RSpec
RSpec/ExampleLength:
Max: 100
RSpec/MultipleExpectations:
Max: 10
RSpec/NestedGroups:
Max: 4
RSpec/DescribeClass:
Enabled: false
RSpec/MessageSpies:
EnforcedStyle: receive
# Disable obnoxious RSpec rules
RSpec/InstanceVariable:
Enabled: false
RSpec/ExampleWording:
Enabled: false
RSpec/EmptyLineAfterExample:
Enabled: false
RSpec/BeEq:
Enabled: false
RSpec/NotToNot:
Enabled: false
RSpec/RepeatedExample:
Enabled: false
RSpec/RepeatedDescription:
Enabled: false
RSpec/HookArgument:
Enabled: false
RSpec/DescribedClass:
Enabled: false
RSpec/EmptyLineAfterHook:
Enabled: false
# Disable other obnoxious rules
Style/FrozenStringLiteralComment:
Enabled: false
Style/StringLiterals:
Enabled: false
Style/ExpandPathArguments:
Enabled: false
Style/MixinUsage:
Enabled: false
Style/BlockComments:
Enabled: false
Style/MagicCommentFormat:
Enabled: false
Layout/EmptyLineAfterMagicComment:
Enabled: false
Style/SpecialGlobalVars:
EnforcedStyle: use_perl_names
Style/RedundantLineContinuation:
Enabled: false
Style/HashSyntax:
Enabled: false
Style/OptionalBooleanParameter:
Enabled: false
Style/Semicolon:
Enabled: false
Style/OrAssignment:
Enabled: false
Style/PercentLiteralDelimiters:
Enabled: false
Style/RedundantCapitalW:
Enabled: false
Layout/ArgumentAlignment:
Enabled: false
Layout/EmptyComment:
Enabled: false
# Disable naming rules
Naming/VariableName:
Enabled: false
Naming/FileName:
Enabled: false
Naming/MethodName:
Enabled: false
untra-polyglot-e688c05/AGENTS.md 0000664 0000000 0000000 00000006560 15201735340 0016370 0 ustar 00root root 0000000 0000000 # AGENTS.md: Guidelines for Contributing to jekyll-polyglot
**jekyll-polyglot** is a fast, open-source internationalization (i18n) plugin for Jekyll blogs.
---
## Quick Start
1. **Install dependencies**: `bundle install`
2. **Run tests**: `bash test.sh` (runs RuboCop linting + RSpec tests with coverage)
3. **Create a feature branch**: `git checkout -b feature/my-feature`
4. **Make changes** to `lib/jekyll/polyglot/` with accompanying tests in `spec/`
5. **Commit** with conventional commit messages (see below)
6. **Push** and open a Pull Request
---
## Commit Message Format
Follow **conventional commit** style:
```
type(scope): brief description
Longer explanation if needed.
Closes #issue_number
```
**Types**: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`
---
## Documentation by Topic
### For Writing Code
- [ARCHITECTURE.md](ai_docs/ARCHITECTURE.md) β Plugin architecture and how components interact
- [SECURITY.md](ai_docs/SECURITY.md) β Security best practices, input validation, and performance
### For Testing
- [TESTING.md](ai_docs/TESTING.md) β Test organization, writing tests, and coverage requirements
---
## Project Structure
| Directory | Purpose |
| -------------------------------- | ---------------------------------------------- |
| `lib/` | Core plugin code |
| `lib/jekyll/polyglot/hooks.rb` | Jekyll hook integration |
| `lib/jekyll/polyglot/patches.rb` | Jekyll core class extensions |
| `lib/jekyll/polyglot/liquid.rb` | Custom Liquid filters and tags |
| `spec/` | RSpec test suite (mirrors `lib/` structure) |
| `spec/fixture/` | Sample Jekyll sites for integration testing |
| `site/` | Example polyglot blog demonstrating the plugin |
---
## Build and Test Commands
```bash
# Install dependencies
bundle install
# Run all tests and linting
bash test.sh
# Run only tests (skip linting)
COVERAGE=true bundle exec rspec
# Run a specific test file
bundle exec rspec spec/jekyll/polyglot/hooks/coordinate_spec.rb
# Build the gem and example site
bash make.sh
# Run the example site locally
cd site
jekyll serve
# Visit http://localhost:4000
```
---
## Key Requirements
- **Ruby 3.1.0 or higher**
- **Bundler** for dependency management
- All code must pass **RuboCop** linting
- New features must include tests (aim for >90% coverage)
- Follow **conventional commit** message style
---
## Important Files
| File | Purpose |
| -------------------------------------------------- | ------------------------------------------ |
| [README.md](README.md) | Usage examples and configuration reference |
| [CONTRIBUTING.md](CONTRIBUTING.md) | Contribution guidelines |
| [jekyll-polyglot.gemspec](jekyll-polyglot.gemspec) | Gem specification and dependencies |
| [Gemfile](Gemfile) | Development dependencies |
| [test.sh](test.sh) | Main test script (runs RuboCop + RSpec) |
| [make.sh](make.sh) | Builds the gem and example site |
untra-polyglot-e688c05/CLAUDE.md 0000664 0000000 0000000 00000000013 15201735340 0016327 0 ustar 00root root 0000000 0000000 @AGENTS.md
untra-polyglot-e688c05/CONTRIBUTING.md 0000664 0000000 0000000 00000001046 15201735340 0017310 0 ustar 00root root 0000000 0000000 # Welcome to Polyglot contributing guide
Thank you for investing your time in contributing to our project! Any contribution you make will be reflected on https://polyglot.untra.io β¨.
This guide covers steps for interested contributors to polyglot source code, documentation or example website.
## Running tests
If you make any contributions to ruby source code, I will request you add a test to the spec.
In the spec/ directory there are a series of ruby spec files.
run tests with `test.sh`.
rebuild the gem and example site with `make.sh`.
untra-polyglot-e688c05/Gemfile 0000664 0000000 0000000 00000001106 15201735340 0016347 0 ustar 00root root 0000000 0000000 source 'https://rubygems.org'
gemspec
gem 'rake'
group :test do
gem 'codecov', '~> 0.6.0'
gem 'html-proofer', '5.1.1'
gem 'minitest', '>= 5.16.3'
gem 'nokogiri', '>= 1.14.3'
gem 'rspec', '>= 3.11.0'
gem 'rspec_junit_formatter', '>= 0.6.0'
gem 'rspec-mocks', '>= 3.11.0'
gem 'rubocop', '>= 1.66.0'
gem 'rubocop-performance', '>= 1.19.0'
gem 'rubocop-rspec', '>= 2.19.0'
gem 'simplecov', '~> 0.21.2'
gem 'simplecov-json', '>= 0.2.1'
end
gem 'jekyll'
gem 'jekyll-paginate'
gem 'jekyll-redirect-from'
gem 'jekyll-seo-tag', '~> 2.9.0'
gem 'webrick', '>= 1.8.2'
untra-polyglot-e688c05/Gemfile.lock 0000664 0000000 0000000 00000013107 15201735340 0017302 0 ustar 00root root 0000000 0000000 PATH
remote: .
specs:
jekyll-polyglot (1.12.0)
jekyll (>= 4.0, >= 3.0)
GEM
remote: https://rubygems.org/
specs:
Ascii85 (2.0.1)
addressable (2.9.0)
public_suffix (>= 2.0.2, < 8.0)
afm (0.2.2)
ast (2.4.2)
async (2.24.0)
console (~> 1.29)
fiber-annotation
io-event (~> 1.9)
metrics (~> 0.12)
traces (~> 0.15)
benchmark (0.5.0)
bigdecimal (3.3.1)
codecov (0.6.0)
simplecov (>= 0.15, < 0.22)
colorator (1.1.0)
concurrent-ruby (1.3.3)
console (1.30.2)
fiber-annotation
fiber-local (~> 1.1)
json
diff-lcs (1.5.1)
docile (1.4.1)
em-websocket (0.5.3)
eventmachine (>= 0.12.9)
http_parser.rb (~> 0)
ethon (0.18.0)
ffi (>= 1.15.0)
logger
eventmachine (1.2.7)
ffi (1.17.4)
ffi (1.17.4-x64-mingw-ucrt)
ffi (1.17.4-x86_64-darwin)
fiber-annotation (0.2.0)
fiber-local (1.1.0)
fiber-storage
fiber-storage (1.0.1)
forwardable-extended (2.6.0)
google-protobuf (4.27.5)
bigdecimal
rake (>= 13)
google-protobuf (4.27.5-x64-mingw-ucrt)
bigdecimal
rake (>= 13)
google-protobuf (4.27.5-x86_64-darwin)
bigdecimal
rake (>= 13)
hashery (2.1.2)
html-proofer (5.1.1)
addressable (~> 2.3)
async (~> 2.1)
benchmark (~> 0.5)
nokogiri (~> 1.13)
pdf-reader (~> 2.11)
rainbow (~> 3.0)
typhoeus (~> 1.3)
yell (~> 2.0)
zeitwerk (~> 2.5)
http_parser.rb (0.8.0)
i18n (1.14.5)
concurrent-ruby (~> 1.0)
io-event (1.11.2)
jekyll (4.3.3)
addressable (~> 2.4)
colorator (~> 1.0)
em-websocket (~> 0.5)
i18n (~> 1.0)
jekyll-sass-converter (>= 2.0, < 4.0)
jekyll-watch (~> 2.0)
kramdown (~> 2.3, >= 2.3.1)
kramdown-parser-gfm (~> 1.0)
liquid (~> 4.0)
mercenary (>= 0.3.6, < 0.5)
pathutil (~> 0.9)
rouge (>= 3.0, < 5.0)
safe_yaml (~> 1.0)
terminal-table (>= 1.8, < 4.0)
webrick (~> 1.7)
jekyll-paginate (1.1.0)
jekyll-redirect-from (0.16.0)
jekyll (>= 3.3, < 5.0)
jekyll-sass-converter (3.0.0)
sass-embedded (~> 1.54)
jekyll-seo-tag (2.9.0)
jekyll (>= 3.8, < 5.0)
jekyll-watch (2.2.1)
listen (~> 3.0)
json (2.19.5)
kramdown (2.4.0)
rexml
kramdown-parser-gfm (1.1.0)
kramdown (~> 2.0)
language_server-protocol (3.17.0.3)
liquid (4.0.4)
listen (3.9.0)
rb-fsevent (~> 0.10, >= 0.10.3)
rb-inotify (~> 0.9, >= 0.9.10)
logger (1.7.0)
mercenary (0.4.0)
metrics (0.12.2)
mini_portile2 (2.8.9)
minitest (5.23.1)
nokogiri (1.18.10)
mini_portile2 (~> 2.8.2)
racc (~> 1.4)
nokogiri (1.18.10-x64-mingw-ucrt)
racc (~> 1.4)
nokogiri (1.18.10-x86_64-darwin)
racc (~> 1.4)
parallel (1.26.3)
parser (3.3.7.0)
ast (~> 2.4.1)
racc
pathutil (0.16.2)
forwardable-extended (~> 2.6)
pdf-reader (2.15.1)
Ascii85 (>= 1.0, < 3.0, != 2.0.0)
afm (>= 0.2.1, < 2)
hashery (~> 2.0)
ruby-rc4
ttfunk
public_suffix (6.0.2)
racc (1.8.1)
rainbow (3.1.1)
rake (13.2.1)
rb-fsevent (0.11.2)
rb-inotify (0.11.1)
ffi (~> 1.0)
regexp_parser (2.10.0)
rexml (3.4.2)
rouge (4.2.1)
rspec (3.13.0)
rspec-core (~> 3.13.0)
rspec-expectations (~> 3.13.0)
rspec-mocks (~> 3.13.0)
rspec-core (3.13.0)
rspec-support (~> 3.13.0)
rspec-expectations (3.13.0)
diff-lcs (>= 1.2.0, < 2.0)
rspec-support (~> 3.13.0)
rspec-mocks (3.13.1)
diff-lcs (>= 1.2.0, < 2.0)
rspec-support (~> 3.13.0)
rspec-support (3.13.1)
rspec_junit_formatter (0.6.0)
rspec-core (>= 2, < 4, != 2.12.0)
rubocop (1.70.0)
json (~> 2.3)
language_server-protocol (>= 3.17.0)
parallel (~> 1.10)
parser (>= 3.3.0.2)
rainbow (>= 2.2.2, < 4.0)
regexp_parser (>= 2.9.3, < 3.0)
rubocop-ast (>= 1.36.2, < 2.0)
ruby-progressbar (~> 1.7)
unicode-display_width (>= 2.4.0, < 4.0)
rubocop-ast (1.37.0)
parser (>= 3.3.1.0)
rubocop-performance (1.23.1)
rubocop (>= 1.48.1, < 2.0)
rubocop-ast (>= 1.31.1, < 2.0)
rubocop-rspec (3.4.0)
rubocop (~> 1.61)
ruby-progressbar (1.13.0)
ruby-rc4 (0.1.5)
safe_yaml (1.0.5)
sass-embedded (1.77.4)
google-protobuf (>= 3.25, < 5.0)
rake (>= 13)
sass-embedded (1.77.4-x64-mingw-ucrt)
google-protobuf (>= 3.25, < 5.0)
sass-embedded (1.77.4-x86_64-darwin)
google-protobuf (>= 3.25, < 5.0)
simplecov (0.21.2)
docile (~> 1.1)
simplecov-html (~> 0.11)
simplecov_json_formatter (~> 0.1)
simplecov-html (0.13.1)
simplecov-json (0.2.3)
json
simplecov
simplecov_json_formatter (0.1.4)
terminal-table (3.0.2)
unicode-display_width (>= 1.1.1, < 3)
traces (0.15.2)
ttfunk (1.8.0)
bigdecimal (~> 3.1)
typhoeus (1.6.0)
ethon (>= 0.18.0)
unicode-display_width (2.5.0)
webrick (1.8.2)
yell (2.2.2)
zeitwerk (2.6.18)
PLATFORMS
ruby
x64-mingw-ucrt
x86_64-darwin-21
DEPENDENCIES
codecov (~> 0.6.0)
html-proofer (= 5.1.1)
jekyll
jekyll-paginate
jekyll-polyglot!
jekyll-redirect-from
jekyll-seo-tag (~> 2.9.0)
minitest (>= 5.16.3)
nokogiri (>= 1.14.3)
rake
rspec (>= 3.11.0)
rspec-mocks (>= 3.11.0)
rspec_junit_formatter (>= 0.6.0)
rubocop (>= 1.66.0)
rubocop-performance (>= 1.19.0)
rubocop-rspec (>= 2.19.0)
simplecov (~> 0.21.2)
simplecov-json (>= 0.2.1)
webrick (>= 1.8.2)
BUNDLED WITH
2.3.22
untra-polyglot-e688c05/LICENSE 0000664 0000000 0000000 00000002047 15201735340 0016066 0 ustar 00root root 0000000 0000000 Copyright (c) 2015 - 2023 Samuel Volin
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
untra-polyglot-e688c05/README.md 0000664 0000000 0000000 00000064233 15201735340 0016345 0 ustar 00root root 0000000 0000000 π€ Polyglot
---
[](https://badge.fury.io/rb/jekyll-polyglot)
[](https://circleci.com/gh/untra/polyglot/?branch=main)
[](https://codecov.io/gh/untra/polyglot)
__Polyglot__ is a fast, painless, open-source internationalization plugin for [Jekyll](http://jekyllrb.com) blogs. Polyglot is easy to set up and use with any Jekyll project, and it scales to the languages you want to support. With fallback support for missing content, automatic url relativization, and powerful SEO tools, Polyglot allows any multi-language jekyll blog to focus on content without the cruft.
## Why?
Jekyll doesn't provide native support for multi-language blogs. This plugin was modeled after the [jekyll-multiple-languages-plugin](https://github.com/screeninteraction/jekyll-multiple-languages-plugin), whose implementation I liked, but execution I didn't.
## Installation
Add jekyll-polyglot to your `Gemfile` if you are using Bundler:
```Ruby
group :jekyll_plugins do
gem "jekyll-polyglot"
end
```
Or install the gem manually by doing `gem install jekyll-polyglot` and specify the plugin using `_config.yml`:
```YAML
plugins:
- jekyll-polyglot
```
## Configuration
In your `_config.yml` file, add the following preferences
```YAML
languages: ["en", "sv", "de", "fr"]
default_lang: "en"
exclude_from_localization: ["javascript", "images", "css", "public", "sitemap", "CNAME"]
parallel_localization: true
url: https://polyglot.untra.io
```
These configuration preferences indicate
- what i18n languages you wish to support
- what is your default "fallback" language for your content
- what root level files/folders are excluded from localization, based on if their paths start with any of the excluded regexp substrings. (this is different from the jekyll `exclude: [ .gitignore ]` ; you should `exclude` files and directories in your repo you dont want in your built site at all, and `exclude_from_localization` files and directories you want to see in your built site, but not in your sublanguage sites.)
- whether to run language processing in parallel or serial. Set to `false` if building on Windows hosts, or if Polyglot collides with other Jekyll plugins.
- your jekyll website production url. Make sure this value is set; Polyglot requires this to relative site urls correctly, and to make functioning language switchers.
The optional `lang_from_path: true` option enables getting the page language from a filepath segment seperated by `/` or `.`, e.g `de/first-one.md`, or `_posts/zh_HK/use-second-segment.md` , if the lang frontmatter isn't defined.
#### Netlify _redirects localization
If you are deploying to Netlify and use a `_redirects` file, you can enable automatic localization of redirects:
```yaml
localize_redirects: true
exclude_from_redirect_localization:
- /signin
- /app
```
See [Localizing Netlify _redirects](#localizing-netlify-_redirects) for more details.
## How To Use It
When adding new posts and pages, add to the YAML front matter:
```
lang: sv
```
or whatever appropriate [I18n language code](https://developer.chrome.com/docs/extensions/reference/api/i18n#locales)
the page should build for. And you're done. Ideally, when designing your site, you should
organize files by their relative urls.
You can see how the live Polyglot website [configures and supports multiple languages](https://github.com/untra/polyglot/blob/main/site/_config.yml#L28-L37), and examples of [community](https://github.com/untra/polyglot/pull/155) [language](https://github.com/untra/polyglot/pull/167) [contributions](https://github.com/untra/polyglot/pull/177).
Polyglot works by associating documents with similar permalinks to the `lang` specified in their frontmatter. Files that correspond to similar routes should have identical permalinks. If you don't provide a permalink for a post, ___make sure you are consistent___ with how you place and name corresponding files:
```
_posts/2010-03-01-salad-recipes-en.md
_posts/2010-03-01-salad-recipes-sv.md
_posts/2010-03-01-salad-recipes-fr.md
```
Organized names will generate consistent permalinks when the post is rendered, and Polyglot will know to build separate language versions of the website using only the files with the correct `lang` variable in the front matter.
In short:
* Be consistent with how you name and place your *posts* files
* Always give your *pages* permalinks in the frontmatter
* Don't overthink it, :wink:
### Translation permalink information in page
_New in 1.8.0_
Whenever `page_id` frontmatter properties are used to identify translations, permalink information for the available languages is available in `permalink_lang`.
This is useful in order to generate language menus and even localization meta information without redirects!
Sample code for meta link generation:
```
{% for lang in site.languages %}
{% capture lang_href %}{{site.baseurl}}/{% if lang != site.default_lang %}{{ lang }}/{% endif %}{% if page.permalink_lang[lang] != '/' %}{{page.permalink_lang[lang]}}{% endif %}{% endcapture %}
Nous sommes un restaurant situΓ© Γ Paris . Ceci est notre menu.
```
Notice the link `...` directs to the french website.
Even if you are falling back to `default_lang` page, relative links built on the *french* site will still link to *french* pages.
### Relativized Absolute Urls
If you defined a site `url` in your `_config.yaml`, Polyglot will automatically relativize absolute links pointing to your website directory:
```md
---
lang: fr
---
Cliquez [ici]({{site.url}}) pour aller Γ l'entrΓ©e du site.
```
becomes
```html
Cliquez ici pour aller Γ l'entrΓ©e du site.
```
#### Canonical URL Handling
For proper canonical URL handling on multilingual sites, we recommend using Polyglot's `{% I18n_Headers %}` tag for canonical URLs instead of jekyll-seo-tag's default canonical output. This provides intelligent canonical URL generation that:
- Points to the translated URL for pages with actual translations
- Points to the default language URL for fallback pages (pages without translations)
- Properly handles the `page_id` and permalink matching for translation detection
**Setup with jekyll-seo-tag:**
If you're using [jekyll-seo-tag](https://github.com/jekyll/jekyll-seo-tag), you can disable its canonical output and let Polyglot handle it:
```liquid
{% seo canonical=false %}
{% I18n_Headers %}
```
The `canonical=false` option is available in jekyll-seo-tag v2.9.0+
**Fallback Canonical Behavior:**
To have fallback pages (pages without translations) point their canonical URL to the default language version, add to your `_config.yml`:
```yaml
fallback_canonical_to_default_lang: true
```
With this option enabled:
- Pages with actual translations: canonical points to the translated URL (e.g., `/es/sobre-nosotros/`)
- Fallback pages (no translation): canonical points to the default language URL (e.g., `/about/` instead of `/es/about/`)
This improves SEO by:
- Preventing search engines from indexing duplicate fallback content under multiple language URLs
- Consolidating SEO authority to the original content
- Signaling to search engines which version is the authoritative source
Note: `hreflang` URLs pointing to the default language or `x-default` are intentionally NOT relativized, as they should always point to the canonical language-specific URLs.
### Localizing Netlify _redirects
_New in 1.13.0_
When using Polyglot with [Netlify](https://www.netlify.com/), redirect rules defined in a [Netlify `_redirects` file](https://docs.netlify.com/manage/routing/redirects/overview/#syntax-for-the-_redirects-file) will get relativized (e.g., `/github` becomes `/fr/github` on French pages). However the Netlify `_redirects` file only contains the redirect base paths, which causes 404 errors for localized URLs.
Polyglot can automatically generate language-prefixed versions of your redirects. Enable this feature in your `_config.yml`:
```yaml
localize_redirects: true
exclude_from_redirect_localization:
- /signin
- /app
```
With this configuration, a redirect like:
```
/github https://github.com/org/repo 302
```
Will automatically generate localized versions for all your configured languages:
```
/github https://github.com/org/repo 302
/fr/github https://github.com/org/repo 302
/de/github https://github.com/org/repo 302
/sv/github https://github.com/org/repo 302
```
Paths listed in `exclude_from_redirect_localization` will not be localized, which is useful for authentication endpoints or app URLs that should only exist at the root level.
### Disabling Url Relativizing
_New in 1.4.0_
If you dont want a href attribute to be relativized (such as for making [a language switcher](https://github.com/untra/polyglot/blob/main/site/_includes/sidebar.html#L40)), you can use the block tag:
```html
{% static_href %}href="..."{% endstatic_href %}
```
```html
click this static link
```
that will generate `click this static link ` which is what you would normally use to create a url unmangled by invisible language relativization.
Combine with a [html minifier](https://github.com/digitalsparky/jekyll-minifier) for a polished and production ready website.
### Exclusive site language generation
_New in 1.4.0_
If you want to control which languages a document can be generated for, you can specify `lang-exclusive: [ ]` frontmatter. If you include this frontmatter in your post, it will only generate for the specified site languages.
For Example, the following frontmatter will only generate in the `en` and `fr` site language builds:
```
---
lang-exclusive: ['en', 'fr']
---
```
### Localized site.data
There are cases where you may want to have a list of `key: value` pairs of translated content. For example, instead of creating a complete separate file for each language containing the layout structure and localized content, you can create a single file with the layout that will be shared among pages, and then create a language-specific file with the localized content that will be used.
To do this, you can create a file like `_data/:lang/strings.yml`, one for each language, and Polyglot will bring those keys under `site.data[:lang].strings`. For example, suppose you have the following files:
`_data/en/strings.yml`
```yaml
hello: "Hello"
greetings:
morning: "Good morning"
evening: "Good evening"
```
`_data/pt-br/strings.yml`
```yaml
hello: "OlΓ‘"
greetings:
morning: "Bom dia"
evening: "Boa noite"
```
You can use the `site.data` to access the localized content in your layouts and pages:
```liquid
{{ site.data[site.active_lang].strings.hello }}, {{ site.data[site.active_lang].strings.greetings.morning }}
```
For more information on this matter, check out this [post](https://polyglot.untra.io/2024/02/29/localized-variables/).
### Localized collections
To localize collections, you first have to properly define the collection in your `_config.yml` file. For example, if you have a collection of `projects`, you can define it like this:
```yaml
collections:
projects:
output: true
permalink: /:collection/:title/
```
Note that the [permalink](https://jekyllrb.com/docs/permalinks/#collections) definition here is important. Then, you can create a file for each language in the `_projects` directory, and Polyglot will bring those files under `site.projects`. For more information, check the related discussion #188.
## How It Works
This plugin makes modifications to existing Jekyll classes and modules, namely `Jekyll::StaticFile` and `Jekyll::Site`. These changes are as lightweight and slim as possible. The biggest change is in `Jekyll::Site.process`. Polyglot overwrites this method to instead spawn a separate process for each language you intend to process the site for. Each of those processes calls the original `Jekyll::Site.process` method with its language in mind, ensuring your website scales to support any number of languages, while building all of your site languages simultaneously.
`Jekyll::Site.process` is the entry point for the Jekyll build process. Take care whatever other plugins you use do not also attempt to overwrite this method. You may have problems.
### (:polyglot, :post_write) hook
_New in 1.8.0_
Polyglot issues a `:polyglot, :post_write` hook event once all languages have been built for the site. This hook runs exactly once, after all site languages been processed:
```rb
Jekyll::Hooks.register :polyglot, :post_write do |site|
# do something custom and cool here!
end
```
### Machine-aware site building
_New in 1.5.0_
Polyglot will only start builds after it confirms there is a cpu core ready to accept the build thread. This ensures that jekyll will build large sites efficiently, streamlining build processes instead of overloading machines with process thrash.
### Writing Tests and Debugging
_:wave: I need assistance with modern ruby best practices for test maintenance with rake and rspec. If you got the advice I have the ears._
Tests are run with `test.sh`. Tests are in the `/spec` directory, and test failure output detail can be examined in the `rspec.json` file. Code Coverage details are in the the `coverage` directory.
## Features
This plugin stands out from other I18n Jekyll plugins.
- automatically corrects your relative links, keeping your *french* visitors on your *french* website, even when content has to fallback to the `default_lang`.
- builds all versions of your website *simultaneously*, allowing big websites to scale efficiently.
- provides the liquid tag `{{ site.languages }}` to get an array of your I18n strings.
- provides the liquid tag `{{ site.default_lang }}` to get the default_lang I18n string.
- provides the liquid tag `{{ site.active_lang }}` to get the I18n language string the website was built for. Alternative names for `active_lang` can be configured via `config.lang_vars`.
- provides the liquid tag `{{ page.rendered_lang }}` to get the language the page content is actually rendered in (useful for detecting fallback pages).
- provides the liquid tag `{{ page.available_languages }}` to get the array of language codes a page has been translated into.
- provides the liquid tag `{{ page.missing_languages }}` to get the array of configured languages a page has not been translated into (empty when the page has no real translations and falls back identically everywhere).
- provides the liquid tag `{{ I18n_Headers }}` to append SEO bonuses to your website.
- provides the liquid tag `{{ Unrelativized_Link href="/hello" }}` to make urls that do not get influenced by url correction regexes.
- provides `site.data` localization for efficient rich text replacement.
- a creator that will answer all of your questions and issues.
### Detecting Fallback Pages with `page.rendered_lang`
The `page.rendered_lang` variable indicates the actual language of a page's content. This is different from `site.active_lang`, which indicates the language version of the site currently being built.
- `site.active_lang`: The language the site is being built for (e.g., `es` for the Spanish site)
- `page.rendered_lang`: The language of the page's actual content (e.g., `en` if no Spanish translation exists)
When `page.rendered_lang != site.active_lang`, the page is a **fallback page** - it's being served in the default language because no translation exists.
**Example: Showing a "not translated" notice:**
```liquid
{% if page.rendered_lang != site.active_lang %}
This page is not yet available in {{ site.active_lang }}.
Showing {{ page.rendered_lang }} version.
{% endif %}
```
**Example: Conditional content based on translation status:**
```liquid
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} content!
{% else %}
Content available in {{ page.rendered_lang }} only.
{% endif %}
```
This is useful for:
- Displaying notices when content hasn't been translated
- Tracking translation coverage
- Applying different styling to fallback pages
- Building translation status dashboards
## SEO Recipes
Jekyll-polyglot has a few spectacular [Search Engine Optimization techniques](https://untra.github.io/polyglot/seo) to ensure your Jekyll blog gets the most out of its multilingual audience. Check them out!
### Sitemap generation
See the example [sitemap.xml](/site/sitemap.xml) and [robots.txt](/site/robots.txt) for how to automatically generate a multi-language sitemap for your page and turn it in for the SEO i18n credit.
The [official Sitemap protocol documentation](https://www.sitemaps.org/protocol.html#location) states:
> "The location of a Sitemap file determines the set of URLs that can be included in that Sitemap. A Sitemap file located at http://example.com/catalog/sitemap.xml can include any URLs starting with http://example.com/catalog/ but can not include URLs starting with http://example.com/images/."
> "It is strongly recommended that you place your Sitemap at the root directory of your web server."
To comply with this, 'sitemap.xml' should be added to the 'exclude_from_localization' list to ensure that only one `sitemap.xml` file exists in the root directory, rather than creating separate ones for each language.
## Compatibility
Currently supports Jekyll 3.0 , and Jekyll 4.0
* Windows users will need to disable parallel_localization on their machines by setting `parallel_localization: false` in the `_config.yml`
* In Jekyll 4.0 , SCSS source maps will generate improperly due to how Polyglot operates. The workaround is to disable the CSS sourcemaps. Adding the following to your `config.yml` will disable sourcemap generation:
```yaml
sass:
sourcemap: never
```
## Contributions
Please! I need all the support I can get! π
But for real I would appreciate any code contributions and support. This started as an open-source side-project and has gotten bigger than I'd ever imagine!
If you have something you'd like to contribute to jekyll-polyglot, please open a PR!
### Contributors
These are talented and considerate software developers across the world that have lent their support to this project.
**Thank You! Β‘Gracias! Merci! Danke! κ°μ¬ν©λλ€! ΧͺΧΧΧ Χ¨ΧΧ! Π‘ΠΏΠ°ΡΠΈΠ±ΠΎ! Dankjewel! θ°’θ°’οΌObrigado!**
* [@yunseo-kim](https://github.com/yunseo-kim) [improved i18n sitemaps]((https://polyglot.untra.io/2025/01/18/polyglot-1.9.0/))
* [@blackpill](https://github.com/blackpill) [1.8.1](https://polyglot.untra.io/2024/08/18/polyglot-1.8.1/)
* [@hacketiwack](https://github.com/hacketiwack) [1.8.1](https://polyglot.untra.io/2024/08/18/polyglot-1.8.1/)
* [@jerturowetz](https://github.com/jerturowetz) [sitemap generation](https://polyglot.untra.io/2024/03/17/polyglot-1.8.0/)
* [@antoniovazquezblanco](https://github.com/antoniovazquezblanco) [1.7.0](https://polyglot.untra.io/2023/10/29/polyglot-1.7.0/)
* [@salinatedcoffee](https://github.com/SalinatedCoffee) [ko support](https://polyglot.untra.io/ko/2023/02/27/korean-support/)
* [@aturret](https://github.com/aturret) [zh-CN support](https://polyglot.untra.io/zh-CN/2023/06/08/polyglot-1.6.0-chinese-support/)
* [@dougieh](https://github.com/dougieh) [1.5.1](https://polyglot.untra.io/2022/10/01/polyglot-1.5.1/)
* [@pandermusubi](https://github.com/PanderMusubi) [nl support](https://polyglot.untra.io/nl/2022/01/15/dutch-site-support/)
* [@obfusk](https://github.com/obfusk) [1.5.0](https://polyglot.untra.io/2021/07/17/polyglot-1.5.0/)
* [@eighthave](https://github.com/eighthave) [1.5.0](https://polyglot.untra.io/2021/07/17/polyglot-1.5.0/)
* [@george-gca](https://github.com/george-gca) [pt-BR support](https://polyglot.untra.io/pt-BR/2024/02/29/localized-variables.md)
* [@PanderMusubi](https://github.com/PanderMusubi) - 1.12 / jekyll-minimal-mistakes-polyglot demo
* [@GruberMarkus](https://github.com/GruberMarkus) - redirect anchor support
* [@rathboma](https://github.com/rathboma) - page.rendered_lang / sublanguage redirects
* [@manabu-nakamura](https://github.com/manabu-nakamura) - Japanese strings
### Other Websites Built with Polyglot
Feel free to open a PR and list your multilingual blog here you may want to share:
* [**Polyglot project website**](https://polyglot.untra.io)
* [LogRhythm Corporate Website](https://logrhythm.com)
* [All Over Earth](https://allover.earth/)
* [Hanare Cafe in Toshijima, Japan](https://hanarecafe.com)
* [F-Droid](https://f-droid.org)
* [Ubuntu MATE](https://ubuntu-mate.org)
* [Leo3418 blog](https://leo3418.github.io/)
* [Gaphor](https://gaphor.org)
* [Yi Yunseok's personal blog website](https://Yi-Yunseok.GitHub.io)
* [Tarlogic Cybersecurity](https://www.tarlogic.com/)
* [A beautiful, simple, clean, and responsive Jekyll theme for academics](https://github.com/george-gca/multi-language-al-folio)
* [AnotherTurret just another study note blog](https://aturret.space/)
* [Diciotech is a collaborative online tech dictionary](https://diciotech.netlify.app/)
* [Yunseo Kim's Study Notes](https://www.yunseo.kim/)
* [Beekeeper Studio](https://www.beekeeperstudio.io/)
## 2.0 Roadmap
* [x] - **site language**: portuguese Brazil `pt-BR`
* [x] - **site language**: arabic `ar`
* [x] - **site language**: japanese `ja`
* [x] - **site language**: russian `ru`
* [x] - **site language**: dutch `nl`
* [x] - **site language**: korean `ko`
* [x] - **site language**: hebrew `he`
* [x] - **site language**: chinese China `zh-CN`
* [x] - **site language**: italian `it`
* [x] - **site language**: turkish `tk`
* [x] - **site language**: ukrainian `uk`
* [x] - **site language**: hindi `hi`
* [ ] - **site language**: chinese Taiwan `zh-TW`
* [ ] - **site language**: portuguese Portugal `pt-PT`
* [ ] - get whitelisted as an official github-pages jekyll plugin
* [x] - update CI provider
## Copyright
Copyright (c) Samuel Volin 2025. License: MIT
untra-polyglot-e688c05/Rakefile 0000664 0000000 0000000 00000001031 15201735340 0016516 0 ustar 00root root 0000000 0000000 require "rspec/core/rake_task"
RSpec::Core::RakeTask.new(:spec)
task :default => [:spec]
desc 'Build the example site at ./site'
task :site_build do
Dir.chdir('site') do
sh 'bundle exec jekyll build'
end
end
desc 'Run html-proofer on the built example site'
task :htmlproofer => [:site_build] do
require 'html-proofer'
HTMLProofer.check_directory(
'./site/_site',
disable_external: true,
allow_hash_href: true,
root_dir: './site/_site',
swap_urls: { %r{^https://polyglot\.untra\.io} => '' }
).run
end
untra-polyglot-e688c05/ai_docs/ 0000775 0000000 0000000 00000000000 15201735340 0016457 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/ai_docs/ARCHITECTURE.md 0000664 0000000 0000000 00000005427 15201735340 0020673 0 ustar 00root root 0000000 0000000 # Architecture and Design Patterns
## Plugin Integration Overview
jekyll-polyglot integrates with Jekyll through three main mechanisms: hooks, patches, and Liquid filters. These work together to add i18n capabilities without breaking existing Jekyll functionality.
## Hooks System
**Location**: `lib/jekyll/polyglot/hooks.rb` and `lib/jekyll/polyglot/hooks/`
The plugin uses Jekyll's hook system to intercept the build process:
- **`post_init` hook**: Runs after Jekyll initializes, sets up configuration and language mappings
- **Other hooks**: Handle document coordinate setup, output relocation, and build orchestration
- **Execution mode**: Hooks run serially or in parallel based on the `parallel_localization` config setting
## Patches System
**Location**: `lib/jekyll/polyglot/patches.rb`
Patches extend Jekyll core classes with i18n capabilities:
- **Target classes**: `Jekyll::Document`, `Jekyll::Site`, and related classes
- **Methods added**: Language detection, document grouping, URL relativization
- **Design principle**: Only add methods; avoid overriding existing behavior without thorough testing
- **Application**: Patches are applied at require time
## Liquid Filters and Tags
**Location**: `lib/jekyll/polyglot/liquid.rb`
Custom Liquid filters and tags for rendering language-aware content in templates:
- **`static_href` tag**: Relativizes URLs for multi-language sites
- **`i18n_headers` tag**: Generates SEO hreflang links for alternate language versions
## Document Coordination Model
The core of polyglot's i18n support:
- Documents are grouped by **permalink** (or `page_id` in v1.7.0+)
- Each document declares its language via the `lang` frontmatter property
- The plugin "coordinates" documents with identical permalinks across languages
- **Alternative URLs per language**: Use `page_id` to identify translations when different URLs are needed per language (e.g., `/about` in English, `/acerca-de/` in Spanish)
## Configuration
Users configure polyglot in `_config.yml`:
```yaml
languages: ["en", "de", "fr"] # Supported languages
default_lang: "en" # Fallback language
exclude_from_localization: [...] # Paths to exclude
parallel_localization: true # Enable parallel processing
url: https://example.com # Site URL (required for URL relativization)
lang_from_path: true # (Optional) Extract lang from file path
permalink_lang: { page_id: "..." } # (v1.8.0+) Permalink info for languages
```
## Key Design Decisions
1. **Minimal coupling**: The plugin extends Jekyll rather than replacing its core behavior
2. **Parallel-friendly**: Document coordination works in both serial and parallel modes
3. **Fallback support**: Missing content in a language falls back to the default language
4. **URL consistency**: Permalinks must be identical across language variants (unless using `page_id`)
untra-polyglot-e688c05/ai_docs/SECURITY.md 0000664 0000000 0000000 00000006236 15201735340 0020257 0 ustar 00root root 0000000 0000000 # Security and Best Practices
## Configuration and Secrets
- **Never hard-code secrets or API keys** in the plugin code
- Users configure the plugin exclusively via Jekyll's `_config.yml`
- Configuration values are passed through Jekyll's standard config system
- Do not commit sensitive data (tokens, API keys) to the repository
## Input Validation and Safety
### Document Language Codes
- Language codes come from user frontmatter
- Validate format follows [I18n language code conventions](https://developer.chrome.com/docs/extensions/reference/api/i18n#locales)
- Reject or sanitize invalid language identifiers
### URL Relativization
- The plugin handles URL transformation for multi-language sites
- Test thoroughly with special characters and unicode in permalinks
- Ensure relative URLs work correctly across all language variants
### Patch Safety
- Patches to Jekyll core classes should **only add methods**
- Avoid overriding existing behavior without thorough testing
- Document any behavior changes that affect Jekyll's standard operations
## Compatibility and Maintenance
### Jekyll Compatibility
- Keep compatibility with **Jekyll >= 4.0**
- Test against multiple Jekyll versions in CI if possible
- Document any version-specific behavior or workarounds
### Ruby Compatibility
- Support **Ruby 3.1.0+**
- Use syntax compatible with this version range
- Test code on the minimum supported version before release
### Dependency Management
- Keep dependencies minimal
- Prefer Jekyll's built-in functionality over external gems
- Review and update dependencies regularly for security patches
## Performance Considerations
### Parallel Localization
- The plugin can process languages in parallel when `parallel_localization: true`
- Use parallel processing for large sites with many languages
- Set to `false` for:
- Windows hosts (known compatibility issues)
- Sites that conflict with other Jekyll plugins
- Development environments where serial processing is easier to debug
- Tests in `subprocess_spec.rb` verify correct parallel behavior
### N+1 Prevention
- When iterating over documents, group by language first to avoid redundant processing
- Use efficient document lookups (avoid searching the entire site for each language variant)
### Caching
- Leverage Jekyll's build cache where possible
- Avoid recalculating document coordinates on unchanged content
- Cache language mappings and configuration lookups
## Error Handling
- Log errors through Jekyll's logger (`jekyll.logger`)
- Provide helpful, actionable error messages that guide users to fix their setup:
- Include the problematic file or configuration value
- Suggest solutions (e.g., "Missing `url` in `_config.yml`; URL relativization requires this")
- Handle missing translations gracefully by falling back to the default language
- Don't expose internal stack traces or implementation details to users
## SEO and URLs
- Polyglot provides SEO tools via Liquid filters
- Ensure `hreflang` alternate links are correctly generated for all language variants
- URLs must be **consistent and valid** across language versions for proper SEO
- Test URL generation with various permalink formats and language combinations
untra-polyglot-e688c05/ai_docs/TESTING.md 0000664 0000000 0000000 00000004635 15201735340 0020126 0 ustar 00root root 0000000 0000000 # Testing Guidelines
## Testing Philosophy
- **Mandatory**: All new features and bug fixes must include tests
- **Coverage target**: Aim for > 90% code coverage on new modules
- **Framework**: Use **RSpec** for unit and integration tests
- **Scope**: Tests should verify plugin hooks, patches, Liquid filters, and Jekyll integration
## Test Organization
Test structure mirrors the source code structure under `lib/jekyll/polyglot/`:
```
spec/
jekyll/
polyglot/
hooks/
coordinate_spec.rb # Document coordination tests
subprocess_spec.rb # Parallel processing tests
[other feature specs]
fixture/
[sample Jekyll sites for integration testing]
spec_helper.rb # RSpec configuration and setup
```
## Writing Tests
### Unit Tests
Test individual methods and filters in isolation:
- **Location**: Mirror the source file structure (e.g., tests for `lib/jekyll/polyglot/hooks.rb` go in `spec/jekyll/polyglot/hooks_spec.rb`)
- **Structure**: Use RSpec's `describe`, `context`, and `it` blocks
- **Example**: `spec/jekyll/polyglot/hooks/coordinate_spec.rb`
### Integration Tests
Test plugin interaction with Jekyll as a whole:
- **Setup**: Use fixture sites in `spec/fixture/` for full Jekyll builds
- **Verification**: Check output HTML structure, language routing, and URL generation
- **Edge cases**: Add new fixtures for complex scenarios (e.g., custom permalinks, different language combinations)
## Running Tests
```bash
# Full test suite with coverage
COVERAGE=true bundle exec rspec
# Run with verbose output
bundle exec rspec --format documentation
# Run a specific test file
bundle exec rspec spec/jekyll/polyglot/hooks/coordinate_spec.rb
# Run only tests matching a pattern
bundle exec rspec --pattern "*coordinate*"
```
## Code Coverage
- Coverage reports are generated in the `coverage/` directory by **SimpleCov**
- Coverage results are uploaded to **Codecov** in CI environments
- The `test.sh` script handles coverage report generation and automated CI uploads
- Check coverage reports before committing to ensure no regression
## Testing Parallel Localization
The `subprocess_spec.rb` tests verify parallel behavior. When testing parallel processing:
- Ensure the `parallel_localization: true` config is set
- Test on non-Windows systems (parallel mode has known issues on Windows)
- Verify that language variants process independently without race conditions
untra-polyglot-e688c05/codecov.yml 0000664 0000000 0000000 00000000545 15201735340 0017227 0 ustar 00root root 0000000 0000000 comment: false
coverage:
status:
project:
default:
target: 80%
threshold: 1%
patch:
default:
target: 80%
threshold: 1%
ignore:
- "spec/**/*"
- "test/**/*"
- "vendor/**/*"
- "bin/**/*"
- "lib/jekyll/polyglot/version.rb"
- "lib/jekyll-polyglot.rb"
fixes:
- "lib/::lib/"
- "spec/::spec/" untra-polyglot-e688c05/jekyll-polyglot.gemspec 0000664 0000000 0000000 00000001132 15201735340 0021561 0 ustar 00root root 0000000 0000000 Gem::Specification.new do |s|
s.name = 'jekyll-polyglot'
s.version = '1.13.0'
s.summary = 'I18n plugin for Jekyll Blogs'
s.description = 'Fast open source i18n plugin for Jekyll blogs.'
s.authors = ['Samuel Volin']
s.email = 'untra.sam@gmail.com'
s.files = ['README.md', 'LICENSE'] + Dir['lib/**/*']
s.homepage = 'https://polyglot.untra.io/'
s.license = 'MIT'
s.add_dependency('jekyll', '>= 3.0', '>= 4.0')
s.required_ruby_version = '>= 3.1.0'
s.required_rubygems_version = '>= 3.1.0'
s.metadata['rubygems_mfa_required'] = 'true'
end
untra-polyglot-e688c05/lib/ 0000775 0000000 0000000 00000000000 15201735340 0015624 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/lib/jekyll-polyglot.rb 0000664 0000000 0000000 00000000032 15201735340 0021305 0 ustar 00root root 0000000 0000000 require "jekyll/polyglot"
untra-polyglot-e688c05/lib/jekyll/ 0000775 0000000 0000000 00000000000 15201735340 0017116 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/lib/jekyll/polyglot.rb 0000664 0000000 0000000 00000000237 15201735340 0021316 0 ustar 00root root 0000000 0000000 require 'jekyll'
require_relative 'polyglot/liquid'
require_relative 'polyglot/patches'
require_relative 'polyglot/hooks'
require_relative 'polyglot/version'
untra-polyglot-e688c05/lib/jekyll/polyglot/ 0000775 0000000 0000000 00000000000 15201735340 0020767 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/lib/jekyll/polyglot/hooks.rb 0000664 0000000 0000000 00000000150 15201735340 0022433 0 ustar 00root root 0000000 0000000 require_relative 'hooks/coordinate'
require_relative 'hooks/process'
require_relative 'hooks/redirects'
untra-polyglot-e688c05/lib/jekyll/polyglot/hooks/ 0000775 0000000 0000000 00000000000 15201735340 0022112 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/lib/jekyll/polyglot/hooks/assets-toggle.rb 0000664 0000000 0000000 00000000332 15201735340 0025216 0 ustar 00root root 0000000 0000000 # Jekyll::Hooks.register :site, :after_init do |site|
# if site.config['assets']
# if site.active_lang != site.default_lang
# then jekyll.sprockets.asset_config['autowrite'] = false
# end
# end
# end
untra-polyglot-e688c05/lib/jekyll/polyglot/hooks/coordinate.rb 0000664 0000000 0000000 00000001670 15201735340 0024572 0 ustar 00root root 0000000 0000000 # hook to coordinate blog posts and pages into distinct urls,
# and remove duplicate multilanguage posts and pages
Jekyll::Hooks.register :site, :post_read do |site|
hook_coordinate(site)
end
def hook_coordinate(site)
# Copy the language specific data, by recursively merging it with the default data.
# Favour active_lang first, then default_lang, then any non-language-specific data.
# See: https://www.ruby-forum.com/topic/142809
merger = proc { |_key, v1, v2| v1.is_a?(Hash) && v2.is_a?(Hash) ? v1.merge(v2, &merger) : v2 }
if site.data.include?(site.default_lang)
site.data = site.data.merge(site.data[site.default_lang], &merger)
end
if site.data.include?(site.active_lang)
site.data = site.data.merge(site.data[site.active_lang], &merger)
end
site.collections.each_value do |collection|
collection.docs = site.coordinate_documents(collection.docs)
end
site.pages = site.coordinate_documents(site.pages)
end
untra-polyglot-e688c05/lib/jekyll/polyglot/hooks/process.rb 0000664 0000000 0000000 00000000444 15201735340 0024117 0 ustar 00root root 0000000 0000000 # hook to make a call to process rendered documents,
Jekyll::Hooks.register :site, :post_render do |site|
hook_process(site)
end
def hook_process(site)
site.collections.each_value do |collection|
site.process_documents(collection.docs)
end
site.process_documents(site.pages)
end
untra-polyglot-e688c05/lib/jekyll/polyglot/hooks/redirects.rb 0000664 0000000 0000000 00000004625 15201735340 0024432 0 ustar 00root root 0000000 0000000 # frozen_string_literal: true
# Hook to localize Netlify _redirects file for multilingual sites.
# When enabled, generates language-prefixed versions of each redirect.
#
# Configuration:
# localize_redirects: true # Enable the feature
# exclude_from_redirect_localization: # Optional: paths to skip
# - /signin
# - /app
#
# Example:
# Input: /github https://github.com/org/repo 302
# Output: /github https://github.com/org/repo 302
# /es/github https://github.com/org/repo 302
# /de/github https://github.com/org/repo 302
# ...
Jekyll::Hooks.register :polyglot, :post_write do |site|
hook_redirects(site)
end
def hook_redirects(site)
return unless site.config.fetch('localize_redirects', false)
redirects_path = File.join(site.source, '_redirects')
return unless File.exist?(redirects_path)
exclusions = site.config.fetch('exclude_from_redirect_localization', [])
lines = File.readlines(redirects_path)
localized_lines = []
lines.each do |line|
# Always include the original line
localized_lines << line
# Skip comments and empty lines
stripped = line.strip
next if stripped.empty? || stripped.start_with?('#')
# Parse the redirect line: /source /target [status_code]
parts = stripped.split(/\s+/)
next if parts.length < 2
source = parts[0]
# Skip if source is in exclusion list
next if exclusions.include?(source)
# Only process paths that start with /
next unless source.start_with?('/')
# Skip if source already has a language prefix
next if site.languages.any? { |lang| source.start_with?("/#{lang}/") || source == "/#{lang}" }
# Add localized versions for non-default languages
site.languages.each do |lang|
next if lang == site.default_lang
localized_source = "/#{lang}#{source}"
destination = parts[1]
# Localize destination if it's an internal path (starts with /)
# but not if it's an external URL (contains ://)
localized_destination = if destination.start_with?('/') && !destination.include?('://')
"/#{lang}#{destination}"
else
destination
end
rest = parts.length > 2 ? " #{parts[2..].join(' ')}" : ''
localized_lines << "#{localized_source} #{localized_destination}#{rest}\n"
end
end
# Write to destination
dest_path = File.join(site.dest, '_redirects')
File.write(dest_path, localized_lines.join)
end
untra-polyglot-e688c05/lib/jekyll/polyglot/liquid.rb 0000664 0000000 0000000 00000000247 15201735340 0022606 0 ustar 00root root 0000000 0000000 module Jekyll
module Polyglot
module Liquid
require_relative 'liquid/tags/i18n_headers'
require_relative 'liquid/tags/static_href'
end
end
end
untra-polyglot-e688c05/lib/jekyll/polyglot/liquid/ 0000775 0000000 0000000 00000000000 15201735340 0022256 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/lib/jekyll/polyglot/liquid/tags/ 0000775 0000000 0000000 00000000000 15201735340 0023214 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/lib/jekyll/polyglot/liquid/tags/i18n_headers.rb 0000664 0000000 0000000 00000007763 15201735340 0026030 0 ustar 00root root 0000000 0000000 module Jekyll
module Polyglot
module Liquid
class I18nHeadersTag < ::Liquid::Tag
def initialize(tag_name, text, tokens)
super
@url = text
@url.strip!
@url.chomp! '/'
end
def render(context)
site = context.registers[:site]
page = context.registers[:page]
permalink = normalize_permalink(page['permalink'] || page['url'] || '')
normalized_permalink = strip_lang_prefix(permalink, site.active_lang)
permalink_lang = page['permalink_lang']
site_url = resolve_site_url(site)
lang_to_permalink = build_lang_to_permalink(site, page['page_id'], normalized_permalink)
canonical_tag(site, site_url, lang_to_permalink, permalink_lang, normalized_permalink) +
hreflang_tags(site, site_url, lang_to_permalink, permalink_lang, normalized_permalink)
end
private
def normalize_permalink(permalink)
permalink.start_with?('/') ? permalink : "/#{permalink}"
end
def strip_lang_prefix(permalink, active_lang)
stripped = permalink.delete_prefix("/#{active_lang}/")
stripped.start_with?('/') ? stripped : "/#{stripped}"
end
def resolve_site_url(site)
return @url unless @url.empty?
baseurl = site.config['baseurl'] || ''
site.config['url'] + baseurl
end
def build_lang_to_permalink(site, page_id, normalized_permalink)
site.find_translations(page_id, normalized_permalink)
end
def lookup_permalink(lang_to_permalink, permalink_lang, lang)
lang_to_permalink[lang] || (permalink_lang && permalink_lang[lang])
end
def with_lang_prefix(permalink, lang)
permalink.start_with?("/#{lang}/") ? permalink : "/#{lang}#{permalink}"
end
def canonical_tag(site, site_url, lang_to_permalink, permalink_lang, normalized_permalink)
current_lang = site.active_lang
has_translation = lookup_permalink(lang_to_permalink, permalink_lang, current_lang)
use_default = site.fallback_canonical_to_default_lang && !has_translation && current_lang != site.default_lang
canonical = if use_default
normalize_permalink(lookup_permalink(lang_to_permalink, permalink_lang, site.default_lang) || normalized_permalink)
elsif current_lang == site.default_lang
normalize_permalink(lookup_permalink(lang_to_permalink, permalink_lang, current_lang) || normalized_permalink)
else
current = normalize_permalink(lookup_permalink(lang_to_permalink, permalink_lang, current_lang) || normalized_permalink)
with_lang_prefix(current, current_lang)
end
" ζδΎ i18n ε€θ―θ¨εθ½ηζδ»ΆοΌζΉδΎΏεΏ«ζ·οΌιη¨δΊε类倧ε°εε’γ@untra εΊεγ
ko: @untra κ° λ§λ , ν¬κ³ μμ λΈλ‘κ·Έ λͺ¨λκ° λΉ λ₯΄κ³ μ§κ΄μ μΈ λ€κ΅μ΄ μ§μμ κ°λ₯μΌ νλ i18n μ§μ Jekyll νλ¬κ·ΈμΈ.
he: ΧͺΧΧ‘Χ£ ΧͺΧΧΧΧ Χ-i18n Χ’ΧΧΧ¨ Jekyll Χ©ΧΧΧ€Χ ΧΧͺ ΧΧͺΧΧΧΧ ΧΧ¨ΧΧΧͺ Χ©Χ€ΧΧͺ ΧΧΧΧΧ¨Χ ΧΧΧΧ ΧΧΧΧΧΧΧΧΧͺ, Χ’ΧΧΧ¨ ΧΧΧΧΧΧ ΧΧΧΧΧΧ ΧΧ§ΧΧ ΧΧ. ΧͺΧΧ¦Χ¨Χͺ @untra .
nl: Een plug-in voor internationlisering van Jekyll die meertalige ondersteuning snel en intuΓ―tief maakt, voor blogs groot en klein. Gemaakt door @untra .
ru: ΠΠ»Π°Π³ΠΈΠ½ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΊΠΈ i18n Π΄Π»Ρ Jekyll ΡΡΠΎ Π΄Π΅Π»Π°Π΅Ρ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΊΡ Π½Π΅ΡΠΊΠΎΠ»ΡΠΊΠΈΡ
ΡΠ·ΡΠΊΠΎΠ² Π±ΡΡΡΡΠΎΠΉ ΠΈ ΠΈΠ½ΡΡΠΈΡΠΈΠ²Π½ΠΎ ΠΏΠΎΠ½ΡΡΠ½ΠΎΠΉ, Π΄Π»Ρ Π±ΠΎΠ»ΡΡΠΈΡ
ΠΈ ΠΌΠ°Π»Π΅Π½ΡΠΊΠΈΡ
Π±Π»ΠΎΠ³ΠΎΠ². Π‘Π΄Π΅Π»Π°Π½ΠΎ Π² @untra .
de: Ein sprachunterstΓΌtzung plugin fΓΌr Jekyll , die UnterstΓΌtzung der Internationalisierung schnell und intuitiv macht, fΓΌr Blogs groΓ und klein. Hergestellt von @untra .
es: Un plugin soporte de i18n para Jekyll que hace soporte de internacionalizaciΓ³n rΓ‘pida e intuitiva, para los blogs grandes y pequeΓ±os. Hecho por @untra .
fr: Un plugin de support de i18n pour Jekyll qui fait support de l'internationalisation rapide et intuitive, pour tous les blogs. RΓ©alisΓ© par @untra .
en: A i18n support plugin for Jekyll that makes multi-language support fast and intuitive, for blogs big and small. Made by @untra .
pt-BR: Um plugin de suporte i18n para Jekyll que torna o suporte a vΓ‘rios idiomas rΓ‘pido e intuitivo, para blogs grandes e pequenos. Feito por @untra .
ar: Ψ₯ΨΆΨ§ΩΨ© Ψ―ΨΉΩ
i18n ΩΩ Jekyll ΨͺΨ¬ΨΉΩ Ψ―ΨΉΩ
Ψ§ΩΩΨΊΨ§Ψͺ Ψ§ΩΩ
ΨͺΨΉΨ―Ψ―Ψ© Ψ³Ψ±ΩΨΉΨ§Ω ΩΨ¨Ψ―ΩΩΩΨ§ΩΨ ΩΩΩ
Ψ―ΩΩΨ§Ψͺ Ψ§ΩΩΨ¨ΩΨ±Ψ© ΩΨ§ΩΨ΅ΨΊΩΨ±Ψ©. Ω
Ω Ψ΅ΩΨΉ @untra .
ja: Jekyll η¨γi18nγ΅γγΌγγγ©γ°γ€γ³γ§γ倧ε°γεγγγγγ°γε€θ¨θͺγ΅γγΌγγι«ιγ§η΄ζηγ«γγΎγγ@untra γδ½ζγ
it: Un plugin di supporto i18n per Jekyll che rende il supporto multilingue veloce e intuitivo, per blog grandi e piccoli. Realizzato da @untra .
tr: BΓΌyΓΌk ve küçük bloglar iΓ§in Γ§oklu dil desteΔini hΔ±zlΔ± ve sezgisel hale getiren Jekyll iΓ§in bir i18n destek eklentisi. @untra tarafΔ±ndan yapΔ±ldΔ±.
uk: ΠΠ»Π°Π³ΡΠ½ ΠΏΡΠ΄ΡΡΠΈΠΌΠΊΠΈ i18n Π΄Π»Ρ Jekyll , ΡΠΎ ΡΠΎΠ±ΠΈΡΡ Π±Π°Π³Π°ΡΠΎΠΌΠΎΠ²Π½Ρ ΠΏΡΠ΄ΡΡΠΈΠΌΠΊΡ ΡΠ²ΠΈΠ΄ΠΊΠΎΡ ΡΠ° ΡΠ½ΡΡΡΡΠΈΠ²Π½ΠΎ Π·ΡΠΎΠ·ΡΠΌΡΠ»ΠΎΡ Π΄Π»Ρ Π±Π»ΠΎΠ³ΡΠ² Π²Π΅Π»ΠΈΠΊΠΈΡ
Ρ ΠΌΠ°Π»ΠΈΡ
. Π‘ΡΠ²ΠΎΡΠ΅Π½ΠΎ @untra .
hi: Jekyll ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ ΰ€ΰ€ i18n ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€¨ ΰ€ͺΰ₯ΰ€²ΰ€ΰ€ΰ€¨ ΰ€ΰ₯ ΰ€¬ΰ€Ήΰ₯-ΰ€ΰ€Ύΰ€·ΰ€Ύ ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€¨ ΰ€ΰ₯ ΰ€€ΰ₯ΰ€ΰ€Ό ΰ€ΰ€° ΰ€Έΰ€Ήΰ€ ΰ€¬ΰ€¨ΰ€Ύΰ€€ΰ€Ύ ΰ€Ήΰ₯, ΰ€ΰ₯ΰ€ΰ₯ ΰ€ΰ€° ΰ€¬ΰ€‘ΰ€Όΰ₯ ΰ€¬ΰ₯ΰ€²ΰ₯ΰ€ΰ₯ΰ€ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ΰ₯€ @untra ΰ€¦ΰ₯ΰ€΅ΰ€Ύΰ€°ΰ€Ύ ΰ€¨ΰ€Ώΰ€°ΰ₯ΰ€ΰ€Ώΰ€€ΰ₯€
keywords:
en: multilingual, i18n, jekyll, polyglot, fast, intuitive, untra, github, pages, blog, plugin, ruby, gem, internationalization, localization, translation, language, support, multi-language, multi-lingual
ko: λ€κ΅μ΄, i18n, μ ν¬, λ€κ΅μ΄, λΉ λ₯Έ, μ§κ΄μ μΈ, untra, κΉνλΈ, νμ΄μ§, λΈλ‘κ·Έ, νλ¬κ·ΈμΈ, 루λΉ, μ ¬, κ΅μ ν, νμ§ν, λ²μ, μΈμ΄, μ§μ, λ€κ΅μ΄, λ€κ΅μ΄
he: Χ¨Χ-ΧΧ©ΧΧ Χ, i18n, Χ'Χ§ΧΧ, Χ¨Χ-ΧΧ©ΧΧ Χ, ΧΧΧΧ¨, ΧΧΧ ΧΧΧΧΧΧΧΧ, untra, ΧΧΧΧΧΧ, ΧΧ€ΧΧ, ΧΧΧΧ, ΧͺΧΧ‘Χ£, Χ¨ΧΧΧ, Χ'Χ, ΧΧΧ ΧΧΧΧΧΧΧͺ, ΧΧΧ§ΧΧΧΧ¦ΧΧ, ΧͺΧ¨ΧΧΧ, Χ©Χ€Χ, ΧͺΧΧΧΧ, Χ¨Χ-ΧΧ©ΧΧ Χ, Χ¨Χ-ΧΧ©ΧΧ Χ
nl: meertalig, i18n, jekyll, meertalig, snel, intuΓ―tief, untra, github, pagina's, blog, plugin, ruby, gem, internationalisering, lokalisatie, vertaling, taal, ondersteuning, meertalig, meertalig
ru: ΠΌΠ½ΠΎΠ³ΠΎΡΠ·ΡΡΠ½ΡΠΉ, i18n, Π΄ΠΆΠ΅ΠΊΠΈΠ»Π», ΠΏΠΎΠ»ΠΈΠ³Π»ΠΎΡ, Π±ΡΡΡΡΡΠΉ, ΠΈΠ½ΡΡΠΈΡΠΈΠ²Π½ΡΠΉ, untra, Π³ΠΈΡΡ
Π°Π±, ΡΡΡΠ°Π½ΠΈΡΡ, Π±Π»ΠΎΠ³, ΠΏΠ»Π°Π³ΠΈΠ½, ΡΡΠ±ΠΈΠ½, Π³Π΅ΠΌ, ΠΈΠ½ΡΠ΅ΡΠ½Π°ΡΠΈΠΎΠ½Π°Π»ΠΈΠ·Π°ΡΠΈΡ, Π»ΠΎΠΊΠ°Π»ΠΈΠ·Π°ΡΠΈΡ, ΠΏΠ΅ΡΠ΅Π²ΠΎΠ΄, ΡΠ·ΡΠΊ, ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΊΠ°, ΠΌΠ½ΠΎΠ³ΠΎΡΠ·ΡΡΠ½ΡΠΉ, ΠΌΠ½ΠΎΠ³ΠΎΡΠ·ΡΡΠ½ΡΠΉ
de: mehrsprachig, i18n, jekyll, polyglot, schnell, intuitiv, untra, github, seiten, blog, plugin, ruby, gem, internationalisierung, lokalisierung, ΓΌbersetzung, sprache, unterstΓΌtzung, mehrsprachig, mehrsprachig
es: multilingΓΌe, i18n, jekyll, polΓglota, rΓ‘pido, intuitivo, untra, github, pΓ‘ginas, blog, plugin, ruby, gem, internacionalizaciΓ³n, localizaciΓ³n, traducciΓ³n, idioma, soporte, multilingΓΌe, multilingΓΌe
fr: multilingue, i18n, jekyll, polyglotte, rapide, intuitif, untra, github, pages, blog, plugin, ruby, gem, internationalisation, localisation, traduction, langue, support, multilingue, multilingue
pt-BR: multilΓngue, i18n, jekyll, polΓglota, rΓ‘pido, intuitivo, untra, github, pΓ‘ginas, blog, plugin, ruby, gem, internacionalização, localização, tradução, idioma, suporte, multilΓngue, multilΓngue
zh-CN: ε€θ―θ¨, i18n, ζ°εΊε°, ε€θ―η§, εΏ«ι, η΄θ§, untra, κΉνλΈ, ι‘΅ι’, εε’, ζδ»Ά, ε’ζ―, gem, ε½ι
ε, ζ¬ε°ε, ηΏ»θ―, θ―θ¨, ζ―ζ, ε€θ―θ¨, ε€θ―θ¨
ar: Ω
ΨͺΨΉΨ―Ψ― Ψ§ΩΩΨΊΨ§Ψͺ, i18n, Ψ¬ΩΩΩΩ, Ω
ΨͺΨΉΨ―Ψ― Ψ§ΩΩΨΊΨ§Ψͺ, Ψ³Ψ±ΩΨΉ, Ψ¨Ψ―ΩΩΩ, untra, Ψ¬ΩΨ«Ψ¨, Ψ΅ΩΨΨ§Ψͺ, Ω
Ψ―ΩΩΨ©, Ψ₯ΨΆΨ§ΩΨ©, Ψ±ΩΨ¨Ω, gem, ΨͺΨ―ΩΩΩ, ΨͺΩΨ·ΩΩ, ΨͺΨ±Ψ¬Ω
Ψ©, ΩΨΊΨ©, Ψ―ΨΉΩ
, Ω
ΨͺΨΉΨ―Ψ― Ψ§ΩΩΨΊΨ§Ψͺ, Ω
ΨͺΨΉΨ―Ψ― Ψ§ΩΩΨΊΨ§Ψͺ
ja: ε€θ¨θͺ, i18n, γΈγ§γγ«, ε€θ¨θͺ, ι«ι, η΄ζη, untra, γγγγγ, γγΌγΈ, γγγ°, γγ©γ°γ€γ³, γ«γγΌ, gem, ε½ιε, γγΌγ«γ©γ€γΌγΌγ·γ§γ³, 翻訳, θ¨θͺ, γ΅γγΌγ, ε€θ¨θͺ, ε€θ¨θͺ
it: multilingue, i18n, jekyll, polyglot, veloce, intuitivo, untra, github, pagine, blog, plugin, ruby, gem, internazionalizzazione, localizzazione, traduzione, lingua, supporto, multilingue
tr: Γ§ok dilli, i18n, jekyll, polyglot, hΔ±zlΔ±, sezgisel, untra, github, sayfalar, blog, eklenti, ruby, gem, uluslararasΔ±laΕtΔ±rma, yerelleΕtirme, Γ§eviri, dil, destek, Γ§ok dilli
uk: Π±Π°Π³Π°ΡΠΎΠΌΠΎΠ²Π½ΠΈΠΉ, i18n, jekyll, polyglot, ΡΠ²ΠΈΠ΄ΠΊΠΈΠΉ, ΡΠ½ΡΡΡΡΠΈΠ²Π½ΠΈΠΉ, untra, github, ΡΡΠΎΡΡΠ½ΠΊΠΈ, Π±Π»ΠΎΠ³, ΠΏΠ»Π°Π³ΡΠ½, ruby, gem, ΡΠ½ΡΠ΅ΡΠ½Π°ΡΡΠΎΠ½Π°Π»ΡΠ·Π°ΡΡΡ, Π»ΠΎΠΊΠ°Π»ΡΠ·Π°ΡΡΡ, ΠΏΠ΅ΡΠ΅ΠΊΠ»Π°Π΄, ΠΌΠΎΠ²Π°, ΠΏΡΠ΄ΡΡΠΈΠΌΠΊΠ°, Π±Π°Π³Π°ΡΠΎΠΌΠΎΠ²Π½ΠΈΠΉ, Π±Π°Π³Π°ΡΠΎΠΌΠΎΠ²Π½ΠΈΠΉ
hi: ΰ€¬ΰ€Ήΰ₯ΰ€ΰ€Ύΰ€·ΰ₯, i18n, jekyll, polyglot, ΰ€€ΰ₯ΰ€ΰ€Ό, ΰ€Έΰ€Ήΰ€, untra, github, ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ , ΰ€¬ΰ₯ΰ€²ΰ₯ΰ€, ΰ€ͺΰ₯ΰ€²ΰ€ΰ€ΰ€¨, ruby, gem, ΰ€
ΰ€ΰ€€ΰ€°ΰ₯ΰ€°ΰ€Ύΰ€·ΰ₯ΰ€ΰ₯ΰ€°ΰ₯ΰ€―ΰ€ΰ€°ΰ€£, ΰ€Έΰ₯ΰ€₯ΰ€Ύΰ€¨ΰ₯ΰ€―ΰ€ΰ€°ΰ€£, ΰ€
ΰ€¨ΰ₯ΰ€΅ΰ€Ύΰ€¦, ΰ€ΰ€Ύΰ€·ΰ€Ύ, ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€¨, ΰ€¬ΰ€Ήΰ₯-ΰ€ΰ€Ύΰ€·ΰ€Ύ, ΰ€¬ΰ€Ήΰ₯ΰ€ΰ€Ύΰ€·ΰ₯
description:
zh-CN: δΈζ¬ΎδΈΊ Jekyll ζδΎ i18n ε€θ―θ¨εθ½ηζδ»ΆοΌζΉδΎΏεΏ«ζ·οΌιη¨δΊε类倧ε°εε’
ko: ν¬κ³ μμ λΈλ‘κ·Έ λͺ¨λκ° λΉ λ₯΄κ³ μ§κ΄μ μΈ λ€κ΅μ΄ μ§μμ κ°λ₯μΌ νλ i18n μ§μ Jekyll νλ¬κ·ΈμΈ.
he: ΧͺΧΧ‘Χ£ ΧͺΧΧΧΧ Χ-i18n Χ’ΧΧΧ¨ Jekyll Χ©ΧΧΧ€Χ ΧΧͺ ΧΧͺΧΧΧΧ ΧΧ¨ΧΧΧͺ Χ©Χ€ΧΧͺ ΧΧΧΧΧ¨Χ ΧΧΧΧ ΧΧΧΧΧΧΧΧΧͺ, Χ’ΧΧΧ¨ ΧΧΧΧΧΧ ΧΧΧΧΧΧ ΧΧ§ΧΧ ΧΧ. ΧͺΧΧ¦Χ¨Χͺ.
nl: Een plug-in voor internationlisering van Jekyll die meertalige ondersteuning snel en intuΓ―tief maakt, voor blogs groot en klein.
ru: ΠΠ»Π°Π³ΠΈΠ½ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΊΠΈ i18n Π΄Π»Ρ Jekyll ΡΡΠΎ Π΄Π΅Π»Π°Π΅Ρ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΊΡ Π½Π΅ΡΠΊΠΎΠ»ΡΠΊΠΈΡ
ΡΠ·ΡΠΊΠΎΠ² Π±ΡΡΡΡΠΎΠΉ ΠΈ ΠΈΠ½ΡΡΠΈΡΠΈΠ²Π½ΠΎ ΠΏΠΎΠ½ΡΡΠ½ΠΎΠΉ, Π΄Π»Ρ Π±ΠΎΠ»ΡΡΠΈΡ
ΠΈ ΠΌΠ°Π»Π΅Π½ΡΠΊΠΈΡ
Π±Π»ΠΎΠ³ΠΎΠ².
de: Ein sprachunterstΓΌtzung plugin fΓΌr Jekyll, die UnterstΓΌtzung der Internationalisierung schnell und intuitiv macht, fΓΌr Blogs groΓ und klein.
es: Un plugin soporte de i18n para Jekyll que hace soporte de internacionalizaciΓ³n rΓ‘pida e intuitiva, para los blogs grandes y pequeΓ±os.
fr: Un plugin de support de i18n pour Jekyll qui fait support de l'internationalisation rapide et intuitive, pour tous les blogs.
en: A i18n support plugin for Jekyll that makes multi-language support fast and intuitive, for blogs big and small.
pt-BR: Um plugin de suporte i18n para Jekyll que torna o suporte a vΓ‘rios idiomas rΓ‘pido e intuitivo, para blogs grandes e pequenos.
ar: Ψ₯ΨΆΨ§ΩΨ© Ψ―ΨΉΩ
i18n ΩΩ Jekyll ΨͺΨ¬ΨΉΩ Ψ―ΨΉΩ
Ψ§ΩΩΨΊΨ§Ψͺ Ψ§ΩΩ
ΨͺΨΉΨ―Ψ―Ψ© Ψ³Ψ±ΩΨΉΨ§Ω ΩΨ¨Ψ―ΩΩΩΨ§ΩΨ ΩΩΩ
Ψ―ΩΩΨ§Ψͺ Ψ§ΩΩΨ¨ΩΨ±Ψ© ΩΨ§ΩΨ΅ΨΊΩΨ±Ψ©.
ja: Jekyllη¨γi18nγ΅γγΌγγγ©γ°γ€γ³γ§γ倧ε°γεγγγγγ°γε€θ¨θͺγ΅γγΌγγι«ιγ§η΄ζηγ«γγΎγγ
it: Un plugin di supporto i18n per Jekyll che rende il supporto multilingue veloce e intuitivo, per blog grandi e piccoli.
tr: BΓΌyΓΌk ve küçük bloglar iΓ§in Γ§oklu dil desteΔini hΔ±zlΔ± ve sezgisel hale getiren Jekyll iΓ§in bir i18n destek eklentisi.
uk: ΠΠ»Π°Π³ΡΠ½ ΠΏΡΠ΄ΡΡΠΈΠΌΠΊΠΈ i18n Π΄Π»Ρ Jekyll, ΡΠΎ ΡΠΎΠ±ΠΈΡΡ Π±Π°Π³Π°ΡΠΎΠΌΠΎΠ²Π½Ρ ΠΏΡΠ΄ΡΡΠΈΠΌΠΊΡ ΡΠ²ΠΈΠ΄ΠΊΠΎΡ ΡΠ° ΡΠ½ΡΡΡΡΠΈΠ²Π½ΠΎ Π·ΡΠΎΠ·ΡΠΌΡΠ»ΠΎΡ Π΄Π»Ρ Π±Π»ΠΎΠ³ΡΠ² Π²Π΅Π»ΠΈΠΊΠΈΡ
Ρ ΠΌΠ°Π»ΠΈΡ
.
hi: Jekyll ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ ΰ€ΰ€ i18n ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€¨ ΰ€ͺΰ₯ΰ€²ΰ€ΰ€ΰ€¨ ΰ€ΰ₯ ΰ€¬ΰ€Ήΰ₯-ΰ€ΰ€Ύΰ€·ΰ€Ύ ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€¨ ΰ€ΰ₯ ΰ€€ΰ₯ΰ€ΰ€Ό ΰ€ΰ€° ΰ€Έΰ€Ήΰ€ ΰ€¬ΰ€¨ΰ€Ύΰ€€ΰ€Ύ ΰ€Ήΰ₯, ΰ€ΰ₯ΰ€ΰ₯ ΰ€ΰ€° ΰ€¬ΰ€‘ΰ€Όΰ₯ ΰ€¬ΰ₯ΰ€²ΰ₯ΰ€ΰ₯ΰ€ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ΰ₯€
paginate: 5
# Custom vars
version: 1.12.0
# practical values langsep are "|", "β’", "Β·", "-", "β"
langsep: "β’"
github:
repo: https://github.com/untra/polyglot
whitelist:
- jekyll-redirect-from untra-polyglot-e688c05/site/_data/ 0000775 0000000 0000000 00000000000 15201735340 0017072 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/ar/ 0000775 0000000 0000000 00000000000 15201735340 0017474 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/ar/sample.yml 0000664 0000000 0000000 00000000427 15201735340 0021503 0 ustar 00root root 0000000 0000000 1: "Ω
Ψ±ΨΨ¨Ψ§ΩΨ ΩΨ£ΩΩΨ§Ω Ψ¨Ω ΩΩ Ψ΅ΩΨΨ© ΨΉΩΩΨ©"
2: "ΩΨ±Ψ¬Ω Ψ§ΩΨ§Ψ³ΨͺΩ
ΨͺΨ§ΨΉ Ψ¨Ψ₯ΩΨ§Ω
ΨͺΩ"
3: "ΩΨ°Ψ§ Ψ§ΩΩΨ΅ Ψ§ΩΨΉΩΩΨ© Ψ¬Ψ§Ψ‘ Ω
Ω Ω
ΩΩ .yml ΩΩ Ω
Ψ¬ΩΨ― _data"
4: "ΨΉΩΨ§Ω
Ψ§Ψͺ html Ω
ΨΩΩΨΈΨ© "
5: 'ΩΨ§ΩΨ±ΩΨ§Ψ¨Ψ· ΩΨ³Ψ¨ΩΨ© '
untra-polyglot-e688c05/site/_data/ar/sidebar.yml 0000664 0000000 0000000 00000000264 15201735340 0021632 0 ustar 00root root 0000000 0000000 home: "Ψ§ΩΨ±Ψ¦ΩΨ³ΩΨ©"
currently: "ΨΨ§ΩΩΨ§Ω"
sample_title: "Ψ¨ΩΨ§ΩΨ§Ψͺ ΩΨ΅ Ω
ΩΨ³Ω ΩΩ
ΩΨ°Ψ¬ΩΨ©"
about: "ΨΩΩ"
not_available: "ΨΊΩΨ± Ω
ΨͺΩΩΨ± Ψ¨ΩΨ°Ω Ψ§ΩΩΨΊΨ©"
untra-polyglot-e688c05/site/_data/de/ 0000775 0000000 0000000 00000000000 15201735340 0017462 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/de/sample.yml 0000664 0000000 0000000 00000000360 15201735340 0021465 0 ustar 00root root 0000000 0000000 1: "Hallo und willkommen zu einer Beispielseite "
2: "Bitte genieΓen Sie Ihren Aufenthalt"
3: "Dieser Beispieltext stammte aus einer .yml Datei "
4: "HTML-Tags werden beibehalten "
5: 'und Links werden relativiert '
untra-polyglot-e688c05/site/_data/de/sidebar.yml 0000664 0000000 0000000 00000000224 15201735340 0021614 0 ustar 00root root 0000000 0000000 home: "Startseite"
currently: "Aktuell"
sample_title: "Beispiel-Rich-Text-Daten"
about: "Γber"
not_available: "In dieser Sprache nicht verfΓΌgbar"
untra-polyglot-e688c05/site/_data/en/ 0000775 0000000 0000000 00000000000 15201735340 0017474 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/en/sample.yml 0000664 0000000 0000000 00000000333 15201735340 0021477 0 ustar 00root root 0000000 0000000 1: "hello, and welcome to a sample page"
2: "please enjoy your stay"
3: "This sample text came from a .yml file in the _data directory"
4: "html tags are preserved "
5: 'and links are relativized '
untra-polyglot-e688c05/site/_data/en/sidebar.yml 0000664 0000000 0000000 00000000211 15201735340 0021622 0 ustar 00root root 0000000 0000000 home: "Home"
currently: "Currently"
sample_title: "Sample rich text data"
about: "About"
not_available: "Not available in this language"
untra-polyglot-e688c05/site/_data/es/ 0000775 0000000 0000000 00000000000 15201735340 0017501 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/es/sample.yml 0000664 0000000 0000000 00000000414 15201735340 0021504 0 ustar 00root root 0000000 0000000 1: " Hola , y bienvenidos a una pΓ‘gina de ejemplo"
2: " disfrutar de su estancia por favor "
3: " Este texto de muestra proviene de un archivo .yml en el directorio _data "
4: " etiquetas HTML se conservan "
5: ' y los enlaces se relativizan '
untra-polyglot-e688c05/site/_data/es/sidebar.yml 0000664 0000000 0000000 00000000237 15201735340 0021637 0 ustar 00root root 0000000 0000000 home: "Inicio"
currently: "Actualmente"
sample_title: "Datos de texto enriquecido de ejemplo"
about: "Acerca de"
not_available: "No disponible en este idioma"
untra-polyglot-e688c05/site/_data/fr/ 0000775 0000000 0000000 00000000000 15201735340 0017501 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/fr/sample.yml 0000664 0000000 0000000 00000000430 15201735340 0021502 0 ustar 00root root 0000000 0000000 1: " bonjour, et bienvenue Γ une page d'exemple "
2: " s'il vous plaΓt profiter de votre sΓ©jour "
3: " Cet exemple de texte provient d'un fichier .yml dans le rΓ©pertoire _data "
4: " balises html sont conservΓ©es "
5: ' et les liens sont relativisΓ©es '
untra-polyglot-e688c05/site/_data/fr/sidebar.yml 0000664 0000000 0000000 00000000241 15201735340 0021632 0 ustar 00root root 0000000 0000000 home: "Accueil"
currently: "Actuellement"
sample_title: "Exemple de donnΓ©es texte enrichi"
about: "Γ propos"
not_available: "Non disponible dans cette langue"
untra-polyglot-e688c05/site/_data/he/ 0000775 0000000 0000000 00000000000 15201735340 0017466 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/he/sidebar.yml 0000664 0000000 0000000 00000000240 15201735340 0021616 0 ustar 00root root 0000000 0000000 home: "ΧΧΧͺ"
currently: "ΧΧ¨ΧΧ’"
sample_title: "Χ ΧͺΧΧ Χ ΧΧ§Χ‘Χ Χ’Χ©ΧΧ¨ ΧΧΧΧΧΧ"
about: "ΧΧΧΧΧͺ"
not_available: "ΧΧ ΧΧΧΧ ΧΧ©Χ€Χ ΧΧ"
untra-polyglot-e688c05/site/_data/hi/ 0000775 0000000 0000000 00000000000 15201735340 0017472 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/hi/sample.yml 0000664 0000000 0000000 00000000777 15201735340 0021511 0 ustar 00root root 0000000 0000000 1: "ΰ€¨ΰ€ΰ€Έΰ₯ΰ€ΰ€Ύΰ€°, ΰ€ΰ€° ΰ€ΰ€ ΰ€¨ΰ€ΰ₯ΰ€¨ΰ€Ύ ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ ΰ€ͺΰ€° ΰ€ΰ€ͺΰ€ΰ€Ύ ΰ€Έΰ₯ΰ€΅ΰ€Ύΰ€ΰ€€ ΰ€Ήΰ₯"
2: "ΰ€ΰ₯ΰ€ͺΰ€―ΰ€Ύ ΰ€
ΰ€ͺΰ€¨ΰ₯ ΰ€ͺΰ₯ΰ€°ΰ€΅ΰ€Ύΰ€Έ ΰ€ΰ€Ύ ΰ€ΰ€¨ΰ€ΰ€¦ ΰ€²ΰ₯ΰ€"
3: "ΰ€―ΰ€Ή ΰ€¨ΰ€ΰ₯ΰ€¨ΰ€Ύ ΰ€ͺΰ€Ύΰ€ _data ΰ€¨ΰ€Ώΰ€°ΰ₯ΰ€¦ΰ₯ΰ€Άΰ€Ώΰ€ΰ€Ύ ΰ€ΰ₯ ΰ€ΰ€ .yml ΰ€«ΰ€Όΰ€Ύΰ€ΰ€² ΰ€Έΰ₯ ΰ€ΰ€―ΰ€Ύ ΰ€Ήΰ₯"
4: "html ΰ€ΰ₯ΰ€ ΰ€Έΰ€ΰ€°ΰ€ΰ₯ΰ€·ΰ€Ώΰ€€ ΰ€°ΰ€Ήΰ€€ΰ₯ ΰ€Ήΰ₯ΰ€"
5: 'ΰ€ΰ€° ΰ€²ΰ€Ώΰ€ΰ€ ΰ€Έΰ€Ύΰ€ͺΰ₯ΰ€ΰ₯ΰ€· ΰ€¬ΰ€¨ΰ€Ύΰ€ ΰ€ΰ€Ύΰ€€ΰ₯ ΰ€Ήΰ₯ΰ€'
untra-polyglot-e688c05/site/_data/hi/sidebar.yml 0000664 0000000 0000000 00000000433 15201735340 0021626 0 ustar 00root root 0000000 0000000 home: "ΰ€ΰ₯ΰ€ΰ₯ΰ€― ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ "
currently: "ΰ€΅ΰ€°ΰ₯ΰ€€ΰ€ΰ€Ύΰ€¨"
sample_title: "ΰ€¨ΰ€ΰ₯ΰ€¨ΰ€Ύ ΰ€Έΰ€ΰ₯ΰ€¦ΰ₯ΰ€§ ΰ€ͺΰ€Ύΰ€ ΰ€‘ΰ₯ΰ€ΰ€Ύ"
about: "ΰ€Ήΰ€ΰ€Ύΰ€°ΰ₯ ΰ€¬ΰ€Ύΰ€°ΰ₯ ΰ€ΰ₯ΰ€"
not_available: "ΰ€ΰ€Έ ΰ€ΰ€Ύΰ€·ΰ€Ύ ΰ€ΰ₯ΰ€ ΰ€ΰ€ͺΰ€²ΰ€¬ΰ₯ΰ€§ ΰ€¨ΰ€Ήΰ₯ΰ€ ΰ€Ήΰ₯"
untra-polyglot-e688c05/site/_data/it/ 0000775 0000000 0000000 00000000000 15201735340 0017506 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/it/sample.yml 0000664 0000000 0000000 00000000351 15201735340 0021511 0 ustar 00root root 0000000 0000000 1: "ciao e benvenuto in una pagina di esempio"
2: "buona permanenza"
3: "Questo testo di esempio proviene da un file .yml nella directory _data"
4: "i tag html sono preservati "
5: 'e i link sono relativizzati '
untra-polyglot-e688c05/site/_data/it/sidebar.yml 0000664 0000000 0000000 00000000224 15201735340 0021640 0 ustar 00root root 0000000 0000000 home: "Home"
currently: "Attualmente"
sample_title: "Dati di testo di esempio"
about: "Chi siamo"
not_available: "Non disponibile in questa lingua"
untra-polyglot-e688c05/site/_data/ja/ 0000775 0000000 0000000 00000000000 15201735340 0017464 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/ja/sample.yml 0000664 0000000 0000000 00000000440 15201735340 0021466 0 ustar 00root root 0000000 0000000 1: "γγγ«γ‘γ―γγ΅γ³γγ«γγΌγΈγΈγγγγ"
2: "γζ₯½γγΏγγ γγ"
3: "γγγ΅γ³γγ«γγγΉγγ―_dataγγ£γ¬γ―γγͺγ.ymlγγ‘γ€γ«γγζ₯γΎγγ"
4: "htmlγΏγ°γ―δΏζγγγΎγ "
5: 'γͺγ³γ―γ―ηΈε―ΎεγγγΎγ '
untra-polyglot-e688c05/site/_data/ja/sidebar.yml 0000664 0000000 0000000 00000000270 15201735340 0021617 0 ustar 00root root 0000000 0000000 home: "γγΌγ "
currently: "ηΎε¨"
sample_title: "γ΅γ³γγ«γͺγγγγγΉγγγΌγΏ"
about: "Polyglotγ«γ€γγ¦"
not_available: "γγθ¨θͺγ§γ―ε©η¨γ§γγΎγγ"
untra-polyglot-e688c05/site/_data/ko/ 0000775 0000000 0000000 00000000000 15201735340 0017503 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/ko/sample.yml 0000664 0000000 0000000 00000000440 15201735340 0021505 0 ustar 00root root 0000000 0000000 1: "μλ
νμΈμ, μν νμ΄μ§μ μ€μ κ²μ νμν©λλ€"
2: "μ¦κ±°μ΄ μκ° λ³΄λ΄μΈμ"
3: "μ΄ μν ν
μ€νΈλ _data λλ ν 리 λ΄μ .yml νμΌλ‘λΆν° λμμ΅λλ€"
4: "html νκ·Έλ 보쑴λλ©° "
5: 'λ§ν¬λ μλνλ©λλ€ '
untra-polyglot-e688c05/site/_data/ko/sidebar.yml 0000664 0000000 0000000 00000000233 15201735340 0021635 0 ustar 00root root 0000000 0000000 home: "ν"
currently: "νμ¬"
sample_title: "μν λ¦¬μΉ ν
μ€νΈ λ°μ΄ν°"
about: "μκ°"
not_available: "μ΄ μΈμ΄λ‘ μ 곡λμ§ μμ΅λλ€"
untra-polyglot-e688c05/site/_data/nl/ 0000775 0000000 0000000 00000000000 15201735340 0017503 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/nl/sample.yml 0000664 0000000 0000000 00000000344 15201735340 0021510 0 ustar 00root root 0000000 0000000 1: "Hallo en welkom bij een voorbeeldpagina"
2: "geniet van uw bezoek"
3: "Dit voorbeeld kwam van een .yml bestand in de _data directorie"
4: "HTML-tags worden behouden "
5: 'en links worden gerelativeerd '
untra-polyglot-e688c05/site/_data/nl/sidebar.yml 0000664 0000000 0000000 00000000212 15201735340 0021632 0 ustar 00root root 0000000 0000000 home: "Home"
currently: "Momenteel"
sample_title: "Voorbeeld rich text data"
about: "Over"
not_available: "Niet beschikbaar in deze taal"
untra-polyglot-e688c05/site/_data/pt-BR/ 0000775 0000000 0000000 00000000000 15201735340 0020016 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/pt-BR/sidebar.yml 0000664 0000000 0000000 00000000225 15201735340 0022151 0 ustar 00root root 0000000 0000000 home: "InΓcio"
currently: "Atualmente"
sample_title: "Dados de texto rico de exemplo"
about: "Sobre"
not_available: "NΓ£o disponΓvel neste idioma"
untra-polyglot-e688c05/site/_data/ru/ 0000775 0000000 0000000 00000000000 15201735340 0017520 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/ru/sample.yml 0000664 0000000 0000000 00000000616 15201735340 0021527 0 ustar 00root root 0000000 0000000 1: "ΠΏΡΠΈΠ²Π΅Ρ ΠΈ Π΄ΠΎΠ±ΡΠΎ ΠΏΠΎΠΆΠ°Π»ΠΎΠ²Π°ΡΡ Π½Π° ΠΎΠ±ΡΠ°Π·Π΅Ρ ΡΡΡΠ°Π½ΠΈΡΡ"
2: "ΠΏΠΎΠΆΠ°Π»ΡΠΉΡΡΠ°, Π½Π°ΡΠ»Π°ΠΆΠ΄Π°ΠΉΡΠ΅ΡΡ Π²Π°ΡΠΈΠΌ ΠΏΡΠ΅Π±ΡΠ²Π°Π½ΠΈΠ΅ΠΌ"
3: "ΠΡΠΎΡ ΠΎΠ±ΡΠ°Π·Π΅Ρ ΡΠ΅ΠΊΡΡΠ° Π²Π·ΡΡ ΠΈΠ· ΡΠ°ΠΉΠ»Π° .yml Π² ΠΊΠ°ΡΠ°Π»ΠΎΠ³Π΅ _data."
4: "HTML-ΡΠ΅Π³ΠΈ ΡΠΎΡ
ΡΠ°Π½ΠΈΠ»ΡΡ "
5: 'ΠΈ ΡΡΡΠ»ΠΊΠΈ ΡΠ΅Π»ΡΡΠΈΠ²ΠΈΠ·ΠΈΡΠΎΠ²Π°Π½Π½ΡΠΉ '
untra-polyglot-e688c05/site/_data/ru/sidebar.yml 0000664 0000000 0000000 00000000345 15201735340 0021656 0 ustar 00root root 0000000 0000000 home: "ΠΠ»Π°Π²Π½Π°Ρ"
currently: "Π’Π΅ΠΊΡΡΠ°Ρ Π²Π΅ΡΡΠΈΡ"
sample_title: "ΠΡΠΈΠΌΠ΅Ρ ΡΠΎΡΠΌΠ°ΡΠΈΡΠΎΠ²Π°Π½Π½ΠΎΠ³ΠΎ ΡΠ΅ΠΊΡΡΠ°"
about: "Π ΠΏΡΠΎΠ΅ΠΊΡΠ΅"
not_available: "ΠΠ΅Π΄ΠΎΡΡΡΠΏΠ½ΠΎ Π½Π° ΡΡΠΎΠΌ ΡΠ·ΡΠΊΠ΅"
untra-polyglot-e688c05/site/_data/tr/ 0000775 0000000 0000000 00000000000 15201735340 0017517 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/tr/sample.yml 0000664 0000000 0000000 00000000355 15201735340 0021526 0 ustar 00root root 0000000 0000000 1: "merhaba, ΓΆrnek sayfaya hoΕ geldiniz"
2: "iyi kalΔ±Εlar dileriz"
3: "Bu ΓΆrnek metin _data dizinindeki bir .yml dosyasΔ±ndan geldi"
4: "html etiketleri korunur "
5: 've baΔlantΔ±lar gΓΆreceli hale getirilir '
untra-polyglot-e688c05/site/_data/tr/sidebar.yml 0000664 0000000 0000000 00000000216 15201735340 0021652 0 ustar 00root root 0000000 0000000 home: "Ana Sayfa"
currently: "Εu anda"
sample_title: "Γrnek zengin metin verisi"
about: "HakkΔ±nda"
not_available: "Bu dilde mevcut deΔil"
untra-polyglot-e688c05/site/_data/uk/ 0000775 0000000 0000000 00000000000 15201735340 0017511 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/uk/sample.yml 0000664 0000000 0000000 00000000612 15201735340 0021514 0 ustar 00root root 0000000 0000000 1: "Π²ΡΡΠ°Ρ, ΡΠ° Π»Π°ΡΠΊΠ°Π²ΠΎ ΠΏΡΠΎΡΠΈΠΌΠΎ Π½Π° Π·ΡΠ°Π·ΠΊΠΎΠ²Ρ ΡΡΠΎΡΡΠ½ΠΊΡ"
2: "Π±ΡΠ΄Ρ Π»Π°ΡΠΊΠ°, Π½Π°ΡΠΎΠ»ΠΎΠ΄ΠΆΡΠΉΡΠ΅ΡΡ ΠΏΠ΅ΡΠ΅Π±ΡΠ²Π°Π½Π½ΡΠΌ"
3: "Π¦Π΅ΠΉ Π·ΡΠ°Π·ΠΊΠΎΠ²ΠΈΠΉ ΡΠ΅ΠΊΡΡ ΡΠ·ΡΡΠΎ Π· .yml-ΡΠ°ΠΉΠ»Ρ Π² ΠΊΠ°ΡΠ°Π»ΠΎΠ·Ρ _data"
4: "html-ΡΠ΅Π³ΠΈ Π·Π±Π΅ΡΡΠ³Π°ΡΡΡΡΡ "
5: 'Π° ΠΏΠΎΡΠΈΠ»Π°Π½Π½Ρ ΡΠ΅Π»ΡΡΠΈΠ²ΡΠ·ΡΡΡΡΡΡ '
untra-polyglot-e688c05/site/_data/uk/sidebar.yml 0000664 0000000 0000000 00000000277 15201735340 0021653 0 ustar 00root root 0000000 0000000 home: "ΠΠΎΠ»ΠΎΠ²Π½Π°"
currently: "ΠΠ°ΡΠ°Π·"
sample_title: "ΠΡΠ°Π·ΠΎΠΊ Π½Π°ΡΠΈΡΠ΅Π½ΠΎΠ³ΠΎ ΡΠ΅ΠΊΡΡΡ"
about: "ΠΡΠΎ Π½Π°Ρ"
not_available: "ΠΠ΅Π΄ΠΎΡΡΡΠΏΠ½ΠΎ ΡΡΡΡ ΠΌΠΎΠ²ΠΎΡ"
untra-polyglot-e688c05/site/_data/zh-CN/ 0000775 0000000 0000000 00000000000 15201735340 0020011 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_data/zh-CN/sample.yml 0000664 0000000 0000000 00000000321 15201735340 0022011 0 ustar 00root root 0000000 0000000 1: "δ½ ε₯½οΌζ¬’θΏζ₯ε°η€ΊδΎι‘΅ι’"
2: "θ―·ζ¨ζ¬£θ΅ζ¬ι‘΅"
3: "ζ¬ι‘΅ι’η± _data ηε½δΈηδΈδΈͺ .yml ζδ»Άηζ"
4: "HTML ζ ηΎδΎηΆδΏη "
5: 'θιΎζ₯εδΌθ’«ηΈε―Ήε '
untra-polyglot-e688c05/site/_data/zh-CN/sidebar.yml 0000664 0000000 0000000 00000000206 15201735340 0022143 0 ustar 00root root 0000000 0000000 home: "ι¦ι‘΅"
currently: "ε½εηζ¬"
sample_title: "ε―ζζ¬ζ°ζη€ΊδΎ"
about: "ε
³δΊ"
not_available: "ζ¬θ―θ¨ζζ ηΏ»θ―"
untra-polyglot-e688c05/site/_includes/ 0000775 0000000 0000000 00000000000 15201735340 0017767 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_includes/head.html 0000664 0000000 0000000 00000003071 15201735340 0021557 0 ustar 00root root 0000000 0000000
{% assign lang = site.active_lang %}
{% if page.title == "Home" %}
{{ site.title }} · {{ site.tagline }}
{% else %}
{{ page.title }} · {{ site.title }}
{% endif %}
{{ content }}
untra-polyglot-e688c05/site/_layouts/page.html 0000664 0000000 0000000 00000000162 15201735340 0021462 0 ustar 00root root 0000000 0000000 ---
layout: default
---
{{ page.title }}
{{ content }}
untra-polyglot-e688c05/site/_layouts/post.html 0000664 0000000 0000000 00000001040 15201735340 0021527 0 ustar 00root root 0000000 0000000 ---
layout: default
---
{{ page.title }}
{{ page.date | date_to_string }}
{{ content }}
untra-polyglot-e688c05/site/_layouts/redirect.html 0000664 0000000 0000000 00000001702 15201735340 0022350 0 ustar 00root root 0000000 0000000
{% assign redirection = page.redirect.to | remove_first: site.url %}
{% if site.active_lang == site.default_lang %}
{% assign redirectTo = site.url | append: redirection %}
{% else %}
{% assign redirectTo = site.url | append: "/" | append: site.active_lang | append: redirection %}
{% endif %}
Redirecting…
Redirecting…
Click here if you are not redirected.
untra-polyglot-e688c05/site/_posts/ 0000775 0000000 0000000 00000000000 15201735340 0017331 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/site/_posts/2012-02-06-whats-jekyll.md 0000664 0000000 0000000 00000001417 15201735340 0023320 0 ustar 00root root 0000000 0000000 ---
layout: post
title: What's Jekyll?
---
[Jekyll](http://jekyllrb.com) is a static site generator, an open-source tool for creating simple yet powerful websites of all shapes and sizes. From [the project's readme](https://github.com/mojombo/jekyll/blob/master/README.markdown):
> Jekyll is a simple, blog aware, static site generator. It takes a template directory [...] and spits out a complete, static website suitable for serving with Apache or your favorite web server. This is also the engine behind GitHub Pages, which you can use to host your projectβs page or blog right here from GitHub.
It's an immensely useful tool and one we encourage you to use here with Hyde.
Find out more by [visiting the project on GitHub](https://github.com/mojombo/jekyll).
untra-polyglot-e688c05/site/_posts/2013-12-28-introducing-hyde.md 0000664 0000000 0000000 00000003536 15201735340 0024170 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Introducing Hyde
---
Hyde is a brazen two-column [Jekyll](http://jekyllrb.com) theme that pairs a prominent sidebar with uncomplicated content. It's based on [Poole](http://getpoole.com), the Jekyll butler.
### Built on Poole
Poole is the Jekyll Butler, serving as an upstanding and effective foundation for Jekyll themes by [@mdo](https://twitter.com/mdo). Poole, and every theme built on it (like Hyde here) includes the following:
* Complete Jekyll setup included (layouts, config, [404](/404), [RSS feed](/atom.xml), posts, and [example page](/about))
* Mobile friendly design and development
* Easily scalable text and component sizing with `rem` units in the CSS
* Support for a wide gamut of HTML elements
* Related posts (time-based, because Jekyll) below each post
* Syntax highlighting, courtesy Pygments (the Python-based code snippet highlighter)
### Hyde features
In addition to the features of Poole, Hyde adds the following:
* Sidebar includes support for textual modules and a dynamically generated navigation with active link support
* Two orientations for content and sidebar, default (left sidebar) and [reverse](https://github.com/poole/lanyon#reverse-layout) (right sidebar), available via `` classes
* [Eight optional color schemes](https://github.com/poole/hyde#themes), available via `` classes
[Head to the readme](https://github.com/poole/hyde#readme) to learn more.
### Browser support
Hyde is by preference a forward-thinking project. In addition to the latest versions of Chrome, Safari (mobile and desktop), and Firefox, it is only compatible with Internet Explorer 9 and above.
### Download
Hyde is developed on and hosted with GitHub. Head to the GitHub repository for downloads, bug reports, and features requests.
Thanks!
untra-polyglot-e688c05/site/_posts/2015-11-14-polyglot-version-1-1.md 0000664 0000000 0000000 00000000452 15201735340 0024532 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot Version 1.1.0
lang: en
---
Polyglot now fully supports [Jekyll 3.0](https://jekyllrb.com/news/2015/10/26/jekyll-3-0-released/) blogs! Go [give it a try!](https://github.com/untra/polyglot)
{% highlight yaml %}
gem 'jekyll-polyglot', '~> 1.1.0'
{% endhighlight %}
untra-polyglot-e688c05/site/_posts/2015-9-19-presenting-polyglot.md 0000664 0000000 0000000 00000004754 15201735340 0024674 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Presenting Polyglot
lang: en
---
After months of work and refinement, I am proud to present **Polyglot**: a i18n plugin for [Jekyll](http://jekyllrb.com) sites that *need* to cater their content to multiple languages and audiences.
### Features
While there are other multi-language plugins for Jekyll, Polyglot is special. Polyglot takes care of the typical cruftwork normally left to developers to manage (such as wrangling urls and ensuring consistent sitemaps) while providing efficient and simple tools Jekyll developers can utilize into SEO and fast-tracked content aggregation.
## Relativized Links
In the past, a multi-language static site or blog had to keep delicate track of what language each relative link the site was serving. It was all too easy for a developer to stumble, and foreign language visitors would quickly get lost in untranslated content.
Polyglot automatically relativizes the urls for each language you want your site to build for. This allows website visitors to stay isolated on one language while browsing your website.
## Fallback Support
When you *don't* have translated or multilingual content, Jekyll will still build with the content you do have. When you *do* have translated or multilingual content, Jekyll will build using that content. Simple as that.
Sitemaps stay consistent across all languages, and translated stays in the site it was built for.
## Rich Content Translation
Rich language content is normally hard to implement. Short strings or language dependent banners are typically hard for a Jekyll website to keep consistent.
*Except when it's this easy*. In your config.yml, just store your strings as:
{% highlight yaml %}
hello:
en: Hello!
es: Β‘hola!
fr: Bonjour!
de: Guten Tag!
{% endhighlight %}
and in your liquid, just call:
{% highlight html %}
{% raw %}
{{ site.hello[site.active_lang]}}
{% endraw %}
{% endhighlight %}
produces:
{{ site.hello[site.active_lang]}}
## Fast, Asynchronous, Zero-Overhead Builds
Polyglot will build your multi-language website just as fast as it will build your default language website. Polyglot runs with a minimal overhead by *simultaneously* building all languages of your website as separate process. This means your website build time won't be a function of how many languages you need to support.
### Download
Polyglot is available as a gem, or as a Jekyll plugin. It can be installed with:
{% highlight bash %}
gem install 'jekyll-polyglot'
{% endhighlight %}
untra-polyglot-e688c05/site/_posts/2016-12-16-Polyglot-1.2.4.md 0000664 0000000 0000000 00000002576 15201735340 0023170 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.2.4
lang: en
---
A new version of Polyglot has been released! Give it a try!
{% highlight yaml %}
gem install jekyll-polyglot
{% endhighlight %}
This release was made possible due to the kind support of github user [vlsi](https://github.com/vlsi), who helped fix a few bugs and added new features:
### Support translation of absolute URLs
Polyglot will now translate your `site.url`, so absolute urls will now get translated as well.
### Translation of all Jekyll Collections
[Jekyll collections](https://jekyllrb.com/docs/collections/) are a fairly new feature. This update translates all registered collections, not just site posts and pages.
### Use language-specific `_data` for `site.data` rich text when `site.data[:lang]` is present
Top level rich text organized by language will be assigned to the site.data when building. Before, when rendering rich text, you would have to use:
{% highlight html %}
{% raw %}
{{ site.data[site.active_lang].richTextString }}
{% endraw %}
{% endhighlight %}
Now rich text can be rendered with just:
{% highlight html %}
{% raw %}
{{ site.data.richTextString }}
{% endraw %}
{% endhighlight %}
### The `I18n_Headers` tag now defaults to `site.url` when left blank
Users can now use
{% highlight html %}
{% raw %}
{% I18n_Headers %}
{% endraw %}
{% endhighlight %}
without specifying a url, defaulting it to your `site.url`
untra-polyglot-e688c05/site/_posts/2016-4-20-Polyglot-1.2.0.md 0000664 0000000 0000000 00000002330 15201735340 0023064 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.2.0
lang: en
---
A new version of Polyglot has been released! Give it a try!
{% highlight yaml %}
gem install jekyll-polyglot
{% endhighlight %}
and list `jekyll-polyglot` among your listed gems in your `_config.yml`
It involves mostly groundwork to prepare for new features and better multilingual content management. It does have a new feature:
## {% raw %} {% I18n_Headers %} {% endraw %}
Put this tag with the [url of your website](https://github.com/untra/polyglot/blob/site/_includes/head.html#L6) in your `head.html` includes file to get the maximum SEO provided by having a multilingual website. It's the same as the following liquid code:
{% highlight html %}{% raw %}
Affiliations . Address. Contacts. Moto. Etc.` and in the brazilian portuguese page it has `subtitle: Afiliaçáes . Endereço. Contatos. Lema. Etc.`. To use this information in the layout, it is used like this:
{% raw %}
```liquid
{{ page.subtitle }}
```
{% endraw %}
The same goes for the content below the frontmatter in both files, which is simply used in the layout like this:
{% raw %}
```liquid
{{ content }}
```
{% endraw %}
Polyglot will automatically render the page with the correct values for the current language.
## Sharing a layout between pages with localized data
For the `subtitle` of the page they used `key: value` pairs in the frontmatter, but sometimes we want to use these same pairs in different parts of the site. For example, if we want to use the same `subtitle` in the `about.md` and in another page, we would have to repeat the same pair in the frontmatter of both pages. This is not ideal because if we want to change the `subtitle` we would have to change it in two places. This is where localized data comes in. You can create a file like `_data/:lang/strings.yml`, one for each language, and Polyglot will bring those keys under `site.data[:lang].strings`.
For example, in the template site there are two files, [\_data/en-us/strings.yml](https://github.com/george-gca/multi-language-al-folio/blob/main/_data/en-us/strings.yml) and [\_data/pt-br/strings.yml](https://github.com/george-gca/multi-language-al-folio/blob/main/_data/pt-br/strings.yml). In the first file they have:
```yaml
latest_posts: latest posts
```
And in the second file they have:
```yaml
latest_posts: ΓΊltimas postagens
```
This way, they can use the `latest_posts` key in the layout like this:
{% raw %}
```liquid
{{ site.data[site.active_lang].strings.latest_posts }}
```
{% endraw %}
Which will correctly get the value for the `latest_posts` variable defined in the file `_data/:lang/strings.yml` for the current language.
## Defining which variable to use in the frontmatter
Now if you want to define this variable in the frontmatter of the page, this gets a little bit trickier. One possible solution is to check if the value of the variable has a `.` in it, and if it does use the value in the file `_data/:lang/strings.yml`. This is how you would do it:
{% raw %}
```liquid
{% if frontmatter_var contains '.' %}
{% assign first_part = frontmatter_var | split: '.' | first %}
{% assign last_part = frontmatter_var | split: '.' | last %}
{% capture result %}{{ site.data[site.active_lang].strings[first_part][last_part] }}{% endcapture %}
{% endif %}
{{ result }}
```
{% endraw %}
This will work, for example, if `frontmatter_var = blog.title`.
Now, if you need to check if the localization string (in this case `blog.title`) actually exists in the file `_data/:lang/strings.yml` before using it, you'll have to create a plugin to check if the variable exists in the file `_data/:lang/strings.yml` and if it does, use it, otherwise fallback to any value you want. I will not go into detail on how to do this, but I will show you how to use it. You can see the code for the plugin [here](https://github.com/george-gca/multi-language-al-folio/blob/main/_plugins/localization-exists.rb).
{% raw %}
```liquid
{% if frontmatter_var contains '.' %}
{% capture contains_localization %}{% localization_exists {{ frontmatter_var }} %}{% endcapture %}
{% if contains_localization == 'true' %}
{% assign first_part = frontmatter_var | split: '.' | first %}
{% assign last_part = frontmatter_var | split: '.' | last %}
{% capture result %}{{ site.data[site.active_lang].strings[first_part][last_part] }}{% endcapture %}
{% else %}
{% capture result %}fallback value{% endcapture %}
{% endif %}
{% endif %}
{{ result }}
```
{% endraw %} untra-polyglot-e688c05/site/_posts/2024-03-17-polyglot-1.8.0.md 0000664 0000000 0000000 00000004237 15201735340 0023226 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.8.0 - Community Contributions Release
lang: en
---
Get excited for Jekyll-Polyglot 1.8.0, which has a few feature improvements and recognizes community documentation and contributions!
## language specific permalinks
One new feature is to give pages language specific permalinks and to retain their association to other relative pages. This new feature is again improved by **[antoniovazquezblanco](https://github.com/antoniovazquezblanco)**, who is a gentleman and a scholar.
## sitemap generation & i18n SEO
This release also recognizes the quality [sitemap.xml]({{ site.url }}/sitemap.xml) and [robots.txt]({{ site.url }}/robots.txt) solution provided by **[jerturowetz](https://github.com/jerturowetz)**. This website now demonstrates and captures more SEO power by using these to be crawlable as a static jekyll website by search providers. See the example website files [here](https://github.com/untra/polyglot/tree/master/site).
## jekyll :polyglot :post_write hook
Github user **[obfusk](https://github.com/obfusk)** contributed a [tiny PR](https://github.com/untra/polyglot/pull/142) a few years back:
With polyglot `:site, :post_write` like these run for each child processes:
```rb
Jekyll::Hooks.register :site, :post_write do |site|
...
end
```
This release adds a custom `:post_write` hook that runs exactly once, after all languages been processed (whether or not `parallel_localization` is used):
```rb
Jekyll::Hooks.register :polyglot, :post_write do |site|
# do something amazing here!
end
```
This feature is helpful for complex jekyll static sites that make additional use of [jekyll hook plugins](https://jekyllrb.com/docs/plugins/hooks/).
She also contributed a fix for [additional logging when language subprocesses crash](https://github.com/untra/polyglot/pull/145). Thanks for this contribution!
## localized variables and portuguese translation.
**[george-gca](https://github.com/george-gca)** is a talented and awesome guy, contributing [an entire blogpost](/2024/02/29/localized-variables/) on how best to localize rich text from site data. He also provided a [site brazilian translation](https://polyglot.untra.io/pt-BR/).
untra-polyglot-e688c05/site/_posts/2024-08-18-polyglot-1.8.1.md 0000664 0000000 0000000 00000001272 15201735340 0023231 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.8.1 - Community Bug Fixes Release
lang: en
---
Jekyll-Polyglot 1.8.1 has been released, which has a few feature improvements and recognizes community found bugs and provided fixes.
## Community provided bugfixes
**[hacketiwack](https://github.com/hacketiwack)** provided a [stricter check for setting a doc permalink](https://github.com/untra/polyglot/pull/200/files), preventing downstream problems with empty frontmatter fields.
Github user **[blackpill](https://github.com/blackpill)** submitted a [one character bugfix](https://github.com/untra/polyglot/pull/211/files) for the i18n headers tag when rendering the default language link alternative href.
untra-polyglot-e688c05/site/_posts/2025-01-18-polyglot-1.9.0.md 0000664 0000000 0000000 00000002434 15201735340 0023224 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.9.0 - Instructional Improvements
lang: en
description: Jekyll Polyglot 1.9.0 release, with instructional improvements for better SEO for multi language websites.
---
Jekyll-Polyglot 1.9.0 has been released, which has minor dependency updates, and instructional improvements for getting the most from your multi-language website.
## Community provided instructional improvements
Thank you to **[aturret](https://github.com/aturret)** for helping to maintain the existing `zh-CN` site pages. θ°’θ°’οΌ
**[george-gca](https://github.com/george-gca)** improved the optional `derive_lang_from_path` configuration to better identify document language from the path inference. Tests were added for his helpful [feature improvement PR](https://github.com/untra/polyglot/pull/222). This improvement helps infer the language of posts and pages missing `lang` frontmatter, from any part of the document filepath.
Github user **[yunseo-kim](https://github.com/yunseo-kim)** submitted a [instructions to improve sitemap generation](https://github.com/untra/polyglot/pull/230) . To help with SEO, a website should have only one root sitemap.xml , and not have duplicates for each sub-language site. Be sure to add the `sitemap.xml` to the `exclude_from_localization` configuration.
untra-polyglot-e688c05/site/_posts/2025-07-07-polyglot-1.10.0.md 0000664 0000000 0000000 00000005237 15201735340 0023304 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.10 - i18n_headers improvements
lang: en
description: Jekyll Polyglot 1.10.0 release, with improvements to SEO generation when using the i18n_headers plugin
---
Jekyll-Polyglot 1.10 is now available. It has vast improvements and changes to the `i18n_headers` liquid plugin for SEO improvements, and minor adjustments for parallel build idempotency. Community Contributions and Vibe Coding helped with a large portion of these release features, testing and blog post.
This version of polyglot now requires ruby >= 3.1 , which may break in build systems.
## i18n_headers improvements
the `i18n_headers` plugin now has extended capabilities as part of this release:
* it will add `
{{ site.hello[site.active_lang]}}
## Schnell, Asynchron, baut Nullarbeit
Polyglot wird Ihre mehrsprachige Website genauso schnell zu bauen, wie es Ihre Standardsprache Website zu bauen. Polyglot lΓ€uft mit einem minimalen Overhead von *gleichzeitig* GebΓ€ude alle Sprachen Ihrer Website als separaten Prozess. Das bedeutet, Ihre Website Build-Zeit wird nicht davon ab, wie viele Sprachen, die unterstΓΌtzt werden mΓΌssen.
### Download
Polyglot ist als eines ruby gem oder als Jekyll Plugin. Es kann mit installiert werden:
{% highlight bash %}
gem install 'jekyll-polyglot'
{% endhighlight %}
untra-polyglot-e688c05/site/_posts/de/2016-4-20-Polyglot-1.2.0.md 0000664 0000000 0000000 00000002464 15201735340 0023464 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.2.0
lang: de
---
Eine neue Version von Polyglot wurde verΓΆffentlicht! Versuche es!
{% highlight yaml %}
gem install jekyll-polyglot
{% endhighlight %}
und eine Liste `jekyll-polyglot` unter Ihren aufgelisteten Edelsteine ββin Ihrer `_config.yml`
Es geht vor allem Grundstein fΓΌr neue Funktionen und eine bessere Verwaltung mehrsprachiger Inhalte vorzubereiten. Er hat eine neue Funktion:
## {% raw %} {% I18n_Headers %} {% endraw %}
Setzen Sie diesen Tag mit der [url Ihrer Website](https://github.com/untra/polyglot/blob/site/_includes/head.html#L6) in Ihrem `head.html` enthΓ€lt Datei die maximale SEO zu erhalten, die von mit einer mehrsprachigen Website. Es ist die gleiche wie die folgende FlΓΌssigkeit Code:
{% highlight html %}{% raw %}
{{ site.hello[site.active_lang]}}
## RΓ‘pido, AsΓncrono, Cero-Overhead Builds
Polyglot va a construir su sitio web en varios idiomas tan rΓ‘pido como se va a construir su sitio web idioma predeterminado. Polyglot se ejecuta con una sobrecarga mΓnima de *simultΓ‘neamente* edificio todos los idiomas de su sitio web como proceso independiente. Esto significa que su sitio web el tiempo de construcciΓ³n no va a ser una funciΓ³n de la cantidad de idiomas que necesita para apoyar.
### Descargar
Polyglot estΓ‘ disponible como una ruby gem, o como un plugin Jekyll. Se puede instalar con:
{% highlight bash %}
gem install 'jekyll-polyglot'
{% endhighlight %}
untra-polyglot-e688c05/site/_posts/es/2016-4-20-Polyglot-1.2.0.md 0000664 0000000 0000000 00000002476 15201735340 0023506 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.2.0
lang: es
---
Una nueva versiΓ³n de PolΓglota ha sido puesto en libertad! Β‘Darle una oportunidad!
{% highlight yaml %}
gem install jekyll-polyglot
{% endhighlight %}
y la lista de `Jekyll-polyglot` entre sus gemas que aparecen en su` _config.yml`
Se trata en su mayorΓa bases para prepararse para nuevas caracterΓsticas y una mejor gestiΓ³n de contenidos multilingΓΌes. Se tiene una nueva caracterΓstica:
## {% raw %} {% I18n_Headers %} {% endraw %}
Ponga esta etiqueta con la [URL de su sitio web](https://github.com/untra/polyglot/blob/site/_includes/head.html#L6) en su `head.html` incluye archivos para obtener el mΓ‘ximo previsto por SEO tener un sitio web multilingΓΌe. Es el mismo que el siguiente cΓ³digo de lΓquido:
{% highlight html %}{% raw %}
{{ site.hello[site.active_lang]}}
## Rapide, Asynchrone, ZΓ©ro Frais-GΓ©nΓ©raux Builds
Polyglot va construire votre site multi-langue aussi vite que il va construire votre site de langue par dΓ©faut. Polyglot fonctionne avec un minimum de frais gΓ©nΓ©raux par *simultanΓ©ment* bΓ’timent toutes les langues de votre site Web comme un processus distinct. Cela signifie que votre temps site de construction ne sera pas fonction du nombre de langues dont vous avez besoin pour soutenir.
### TΓ©lΓ©charger
Polyglot est disponible comme une ruby gem, ou comme un plugin Jekyll. Il peut Γͺtre installΓ© avec:
{% highlight bash %}
gem install 'jekyll-polyglot'
{% endhighlight %}
untra-polyglot-e688c05/site/_posts/fr/2016-4-20-Polyglot-1.2.0.md 0000664 0000000 0000000 00000002503 15201735340 0023475 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.2.0
lang: fr
---
Une nouvelle version de Polyglot a Γ©tΓ© libΓ©rΓ©! Essaie!
{% highlight yaml %}
gem install jekyll-polyglot
{% endhighlight %}
et la liste `jekyll-polyglot` parmi vos pierres prΓ©cieuses figurant dans votre `_config.yml`
Elle consiste principalement bases pour se prΓ©parer Γ de nouvelles fonctionnalitΓ©s et une meilleure gestion de contenu multilingue. Elle a une nouvelle fonctionnalitΓ©:
## {% raw %} {% I18n_Headers %} {% endraw %}
Mettez cette balise avec le [url de votre site](https://github.com/untra/polyglot/blob/site/_includes/head.html#L6) dans votre `head.html` comprend fichier pour obtenir le rΓ©fΓ©rencement maximum fourni par ayant un site Web multilingue. Il est le mΓͺme que le code de liquide suivant:
{% highlight html %}{% raw %}
{{ site.hello[site.active_lang]}}
## λΉ λ₯΄κ³ , λΉλκΈ°νλ, μ€λ²ν€λ μλ λΉλ
Polyglotμ κΈ°μ‘΄ μΈμ΄ μ¬μ΄νΈλ₯Ό λΉλνλ κ² λ§νΌ λ€κ΅μ΄ μ¬μ΄νΈλ λΉ λ₯΄κ² λΉλν©λλ€.
Polyglotμ μ¬λ¬λΆμ μ¬μ΄νΈμ λͺ¨λ μΈμ΄λ₯Ό κ°κ°μ νλ‘μΈμ€λ‘μ¨ *λμμ* λΉλν΄ μ€λ²ν€λλ₯Ό μ΅μνν©λλ€. μ¦, μΉμ¬μ΄νΈ λΉλ μκ°μ΄ μ§μνλ μΈμ΄μ κ°―μμ μ λΉλ‘νμ§ μμλ λλ€λ λ»μ΄μ£ .
### λ€μ΄λ‘λ
Polyglotμ gemμΌλ‘λ λ°°ν¬λκ³ μκ³ , Jekyll νλ¬κ·ΈμΈμΌλ‘λ μ 곡λκ³ μμ΅λλ€. μ€μΉνμλ €λ©΄:
{% highlight bash %}
gem install 'jekyll-polyglot'
{% endhighlight %}
untra-polyglot-e688c05/site/_posts/ko/2023-02-27-korean-support.md 0000664 0000000 0000000 00000000575 15201735340 0024315 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot μΉ μ¬μ΄νΈκ° μ΄μ νκ΅μ΄λ‘ μ 곡λ©λλ€.
lang: ko
---
μ΄ [μΉμ¬μ΄νΈ](https://polyglot.untra.io/ko/) νκ΅μ΄ μ§μμΌλ‘ μ
λ°μ΄νΈ λμμ΅λλ€!
μ΄κ²μ μν΄ μ 곡λ©λλ€ **[SalinatedCoffee](https://github.com/SalinatedCoffee)**, μ΄λ¬ν λ³νμ κΈ°μ¬ν μ¬λ. νλ‘μ νΈλ₯Ό λμ μ£Όμ
μ κ³ λ§μμ! untra-polyglot-e688c05/site/_posts/ko/2024-03-17-polyglot-1.8.0.md 0000664 0000000 0000000 00000005402 15201735340 0023632 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.8.0 - 컀λ€λν° μ 곡물 릴리μ€
lang: ko
---
λͺ κ°μ§ κΈ°λ₯ ν₯μκ³Ό 컀λ€λν° λ¬Έμ λ° κΈ°μ¬λ₯Ό μΈμ νλ Jekyll-Polyglot 1.8.0μ λν΄ κΈ°λλ₯Ό λμ΄μΈμ! λͺ κ°μ§ κΈ°λ₯ ν₯μκ³Ό 컀λ€λν° λ¬Έμ λ° κΈ°μ¬λ₯Ό μΈμ νλ μ ν¬-ν΄λ¦¬κΈλ‘― 1.8.0 μ λν΄ κΈ°λλ₯Ό λμ΄μΈμ!
## μΈμ΄λ³ κ³ μ λ§ν¬
ν κ°μ§ μλ‘μ΄ κΈ°λ₯μ νμ΄μ§μ μΈμ΄λ³ κ³ μ λ§ν¬λ₯Ό μ 곡νκ³ λ€λ₯Έ μλ νμ΄μ§μμ μ°κ²°μ μ μ§νλ κ²μ
λλ€. μ΄ μλ‘μ΄ κΈ°λ₯μ λ λ€μ **[antoniovazquezblanco](https://github.com/antoniovazquezblanco)** μ μν΄ κ°μ λμμ΅λλ€, μ§μ€λ μ μ¬μ΄λ©΄μ νμ μλ λΆμ
λλ€.
## μ¬μ΄νΈλ§΅ μμ± λ° λ€κ΅μ΄ SEO
μ΄ λ¦΄λ¦¬μ€λ λν νμ§μ μΈμ ν©λλ€ [sitemap.xml]({{ site.url }}/sitemap.xml) κ·Έλ¦¬κ³ [robots.txt]({{ site.url }}/robots.txt) solution provided by **[jerturowetz](https://github.com/jerturowetz)**. μ΄ μ¬μ΄νΈλ μ΄μ κ²μ μμ§μ μν΄ μ μ μ ν¬ μΉμ¬μ΄νΈλ‘ ν¬λ‘€λ§λ μ μλλ‘ μ΄λ¬ν μ€μ μ μ¬μ©νμ¬ λ λ§μ SEO κΈ°λ₯μ 보μ¬μ£Όκ³ νμ©ν©λλ€. [μ¬κΈ°](https://github.com/untra/polyglot/tree/master/site) μμ μΉμ¬μ΄νΈ νμΌμ μ°Έμ‘°νμμμ€.
## jekyll :polyglot :post_write hook
Github μ¬μ©μ **[obfusk](https://github.com/obfusk)** λͺ λ
μ μμ [κΈ°μ¬λ₯Ό νμ΅λλ€](https://github.com/untra/polyglot/pull/142) κΈ°μ¬λ₯Ό νμ΅λλ€.
μ μ¬μ©νμ¬ polyglot `:site, :post_write` μ΄ κΈ°λ₯μ κ° μμ νλ‘μΈμ€ μ€ν μ ν λ² μ€νλ©λλ€:
```rb
Jekyll::Hooks.register :site, :post_write do |site|
...
end
```
μ΄ λ¦΄λ¦¬μ€λ λͺ¨λ μΈμ΄κ° μ²λ¦¬λ ν μ νν ν λ² μ€νλλ μ¬μ©μ μ μ νν¬ `:post_write` λ₯Ό μΆκ°ν©λλ€ (μ¬λΆ `parallel_localization` μ¬μ©λ©λλ€):
```rb
Jekyll::Hooks.register :polyglot, :post_write do |site|
# μ¬κΈ°μ λλΌμ΄ κ²μ λ§λ€μ΄ 보μΈμ!
end
```
μ΄ κΈ°λ₯μ μΆκ°μ μΈ νμ©μ΄ νμν 볡μ‘ν μ ν¬ μ μ μ¬μ΄νΈμ μ μ©ν©λλ€ [jekyll hook plugins](https://jekyllrb.com/docs/plugins/hooks/).
κ·Έλ
λ λν λ€μκ³Ό κ°μ λ¬Έμ λ₯Ό ν΄κ²°νλ [μΈμ΄ μλΈ νλ‘μΈμ€ μΆ©λ μ μΆκ° λ‘κΉ
](https://github.com/untra/polyglot/pull/145). μ΄ κΈ°μ¬μ κ°μ¬ν©λλ€!
## μ§μ λ³μ λ° ν¬λ₯΄ν¬κ°μ΄ λ²μ
**[george-gca](https://github.com/george-gca)** μ¬λ₯μ΄ λ°μ΄λκ³ λ©μ§ λΆμ
λλ€, κ·Έλ [μ 체 λΈλ‘κ·Έ κ²μλ¬Όμ κΈ°κ³ νμ΅λλ€](/2024/02/29/localized-variables/) μΉμ¬μ΄νΈ λ°μ΄ν°μμ λ¦¬μΉ ν
μ€νΈλ₯Ό κ°μ₯ ν¨κ³Όμ μΌλ‘ λ‘컬λΌμ΄μ§νλ λ°©λ²μ λν. κ·Έλ λν μ 곡νμ΅λλ€ [λΈλΌμ§ ν¬λ₯΄ν¬κ°μ΄ μ¬μ΄νΈ λ²μ](https://polyglot.untra.io/pt-BR/).
untra-polyglot-e688c05/site/_posts/ko/2024-08-18-polyglot-1.8.1.md 0000664 0000000 0000000 00000001440 15201735340 0023637 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.8.1 - Community Bug Fixes Release
lang: ko
---
Jekyll-Polyglot 1.8.1μ΄ μΆμλμμ΅λλ€. μ΄λ² 릴리μ€μλ λͺ κ°μ§ κΈ°λ₯ κ°μ μ¬νκ³Ό 컀λ€λν°μμ λ°κ²¬λ λ²κ·Έ ν΄κ²°μ΄ ν¬ν¨λμ΄ μμ΅λλ€.
## 컀λ€λν° μ 곡 λ²κ·Έ μμ
**[hacketiwack](https://github.com/hacketiwack)**μ λ¬Έμ νΌmalink μ€μ μ μν [λ³΄λ€ μ격ν κ²μ¬](https://github.com/untra/polyglot/pull/200/files)λ₯Ό μ 곡νμ¬ λΉ νλ°νΈλ§€ν° νλλ‘ μΈν νλ₯ λ¬Έμ λ₯Ό λ°©μ§νμ΅λλ€.
Github μ¬μ©μ **[blackpill](https://github.com/blackpill)**μ κΈ°λ³Έ μΈμ΄ λ§ν¬ λ체 href λ λλ§ μ i18n ν€λ νκ·Έμ λν [λ¨μΌ λ¬Έμ λ²κ·Έ μμ ](https://github.com/untra/polyglot/pull/211/files)μ μ μΆνμ΅λλ€.
untra-polyglot-e688c05/site/_posts/ko/2025-07-07-polyglot-1.10.0.md 0000664 0000000 0000000 00000006176 15201735340 0023720 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.10 - i18n_headers κ°μ
lang: ko
description: Jekyll Polyglot 1.10.0 릴리μ€, i18n_headers νλ¬κ·ΈμΈ μ¬μ© μ SEO μμ± κ°μ
---
Jekyll-Polyglot 1.10μ΄ μΆμλμμ΅λλ€. μ΄λ² 릴리μ€μμλ SEO κ°μ μ μν `i18n_headers` liquid νλ¬κ·ΈμΈμ λν λλμ μΈ κ°μ κ³Ό, λ³λ ¬ λΉλμ λ©±λ±μ± κ΄λ ¨ μκ·λͺ¨ μ‘°μ μ΄ ν¬ν¨λμ΄ μμ΅λλ€. 컀λ€λν° κΈ°μ¬μλ€κ³Ό Vibe Codingμ΄ λ§μ κΈ°λ₯, ν
μ€νΈ, λΈλ‘κ·Έ ν¬μ€νΈ μμ±μ ν° λμμ μ£Όμμ΅λλ€.
## i18n_headers κ°μ μ¬ν
μ΄λ² 릴리μ€μμ `i18n_headers` νλ¬κ·ΈμΈμ λ€μκ³Ό κ°μ νμ₯λ κΈ°λ₯μ κ°μΆκ² λμμ΅λλ€:
* κ° νμ΄μ§ μΈμ΄λ³λ‘ `GitHub-repository voor downloads, bugrapporten en andere featureverzoeken.
Dank je!
untra-polyglot-e688c05/site/_posts/nl/2015-11-14-polyglot-version-1-1.md 0000664 0000000 0000000 00000000460 15201735340 0025142 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot versie 1.1.0
lang: nl
---
Polyglot ondersteunt nu volledig [Jekyll 3.0](https://jekyllrb.com/news/2015/10/26/jekyll-3-0-released/)-blogs! Ga [het uitproberen!](https://github.com/untra/polyglot)
{% highlight yaml %}
gem 'jekyll-polyglot', '~> 1.1.0'
{% endhighlight %}
untra-polyglot-e688c05/site/_posts/nl/2015-9-19-presenting-polyglot.md 0000664 0000000 0000000 00000005261 15201735340 0025277 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Aankondiging Polyglot
lang: nl
---
Na maanden van werk en verbeteringen kondig ik met trots aan **Polyglot**: een i18n-plug-in voor [Jekyll](http://jekyllrb.com)-websites, die een *noodzaak* hebben hun content in meerdere talen aan hun publike aan te bieden.
### Features
Zowaar er andere meertalige plugin-ins voor Jekyll zijn, Polyglot is anders. Polyglot bekommert zich om de typische zaken die normaal door ontwikkelaars worden beheerd (zoals het vermangelen van URL's en verzekeren van consistente sitemaps) en tegelijkertijd efficiΓ«nte en eenvoudige tools aanbieden die Jekyll-ontwikkelaars kunnen gebruiken in SEO en snelle contentaggregatie.
## Gerelativeerde URL's
Een meertalige statische site of blog moest in het verleden delicaat bijhouden welke taal werd aangeboden door elke relatieve link op de website. Hierdoor struikelde een ontwikkelaar snel en buitenlandse bezoekers met een andere taal verloren zichzelf snel in onvertaalde content.
Polyglot relativeert automatisch de URL's voor elke taal waar je je website voor wil bouwen. Dit maakt het mogelijk dat bezoekers geΓ―soleerd blijven in een taal terwijl ze je website bekijken.
## Fallback-ondersteuning
Als je *geen* vertaalde or meertalige content hebt, zal Jekyll nog steeds de site bouwen met de content die je hebt. Als je *wel* vertaalde of meertalige content hebt, zal Jekyll de site bouwen met die conent. Zo eenvoudig is het.
Sitemaps blijven consistent over alle talen, en de vertaling blijft in de website waarvoor het gebouwd was.
## Rich content vertalen
Vertalen van rich content is normaal moeilijk te implementeren. Korte strings of taalafhankelijke banners zijn typisch lastig voor een Jekyll-website om consistent te houden.
*Behalve, wanneer het makkelijk is*. In je config.yml, sla je string op deze manier op:
{% highlight yaml %}
hello:
en: Hello!
es: Β‘hola!
fr: Bonjour!
de: Guten Tag!
{% endhighlight %}
en in je liquid, roep alleen maar aan
{% highlight html %}
{% raw %}
{{ site.hello[site.active_lang]}}
{% endraw %}
{% endhighlight %}
dat produceert:
{{ site.hello[site.active_lang]}}
## Snel, asynchroon en zonder overhead bouwen
Polyglot bouwt je meertalige website net zo snel als het je website voor je standaardtaal bouwt. Polyglot runt met een minimale overhead door *simultaan* alle talen van je website in een apart proces te bouwen. Dit betekent dat je website wordt gebouwd in een tijd die onafhankelijk is van de hoeveelheid talen die je wil ondersteunen.
### Download
Polyglot is beschikbaar als een ruby gem of als een Jekyll-plug-in. Het kan worden geΓ―nstalleerd met:
{% highlight bash %}
gem install 'jekyll-polyglot'
{% endhighlight %}
untra-polyglot-e688c05/site/_posts/nl/2016-12-16-Polyglot-1.2.4.md 0000664 0000000 0000000 00000002754 15201735340 0023577 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.2.4
lang: nl
---
Een nieuwe versie van Polyglot is gepubliceerd! Probeer het uit!
{% highlight yaml %}
gem install jekyll-polyglot
{% endhighlight %}
Deze publicatie is mogelijk gemaakt door de vriendelijke hulp van de GitHub-gebruiker [vlsi](https://github.com/vlsi), die heeft geholpen wat bugs te fiksen en nieuwe features toe te voegen:
### Ondersteuning vertalen van absolute URL's
Polyglot zal nu je `site.url` vertalen, zodat absolute URL's ook vertaald worden.
### Vertaling van alle Jekyll collecties
[Jekyll collecties](https://jekyllrb.com/docs/collections/) is een redelijk nieuwe feature. Deze update vertaalt alle geregistreerde collecties, niet alleen posts en pagina's.
### Gebruik taalspecifieke `_data` voor `site.data` rich text als `site.data[:lang]` aanwezig is
Rich text op top level die op taal is gesorteerd wordt toegekend aan de site.data tijdens het bouwen van de site. Voorheen, toen rich text werd gerendered, moest je dit doen:
{% highlight html %}
{% raw %}
{{ site.data[site.active_lang].richTextString }}
{% endraw %}
{% endhighlight %}
Rich text kan nu worden gerendered met alleen:
{% highlight html %}
{% raw %}
{{ site.data.richTextString }}
{% endraw %}
{% endhighlight %}
### De `I18n_Headers` tag gaat nu standaard naar `site.url` als die niet is ingevuld
Gebruikers hebben nu toegang tot
{% highlight html %}
{% raw %}
{% I18n_Headers %}
{% endraw %}
{% endhighlight %}
zonder een URL op te geven, die gaat standaard naar `site.url`
untra-polyglot-e688c05/site/_posts/nl/2016-4-20-Polyglot-1.2.0.md 0000664 0000000 0000000 00000002276 15201735340 0023506 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.2.0
lang: nl
---
Een nieuwe versie van Polyglot is gepubliceerd! Probeer het uit!
{% highlight yaml %}
gem install jekyll-polyglot
{% endhighlight %}
en neem `jekyll-polyglot` op in je lijst van gems in je `_config.yml`
Het gaat vooral om voorbereidingen voor nieuwe features en betere meertalig contentbeheer. Het heeft ook een nieuwe feature:
## {% raw %} {% I18n_Headers %} {% endraw %}
Plaats deze tag met de [URL van je website](https://github.com/untra/polyglot/blob/site/_includes/head.html#L6) in je `head.html` om de maximale SEO te krijgen van een meertalige website. Het is hetzelfde als de volgende liquid code:
{% highlight html %}{% raw %}
Affiliations . Address. Contacts. Moto. Etc.` e na pΓ‘gina em portuguΓͺs brasileiro tem `subtitle: Afiliaçáes . EndereΓ§o. Contatos. Lema. Etc.`. Essa informação no layout Γ© usada dessa forma:
{% raw %}
```liquid
{{ page.subtitle }}
```
{% endraw %}
O mesmo vale para o conteΓΊdo abaixo do frontmatter em ambos os arquivos, que Γ© simplesmente usado no layout dessa forma:
{% raw %}
```liquid
{{ content }}
```
{% endraw %}
Polyglot renderizarΓ‘ automaticamente a pΓ‘gina com os valores corretos para o idioma atual.
## Compartilhando um layout entre pΓ‘ginas com dados traduzidos
Para o `subtitle` da pΓ‘gina eles usaram pares `chave: valor` no frontmatter, mas Γ s vezes queremos usar esses mesmos pares em diferentes partes do site. Por exemplo, se quisermos usar o mesmo `subtitle` no `about.md` e em outra pΓ‘gina, terΓamos que repetir o mesmo par no frontmatter de ambas as pΓ‘ginas. Isso nΓ£o Γ© ideal porque se quisermos mudar o `subtitle` terΓamos que mudΓ‘-lo em dois lugares. Γ aΓ que entram os dados traduzidos. VocΓͺ pode criar um arquivo como `_data/:lang/strings.yml`, um para cada idioma, e o Polyglot trarΓ‘ essas chaves sob `site.data[:lang].strings`.
Por exemplo, no site modelo existem dois arquivos, [\_data/en-us/strings.yml](https://github.com/george-gca/multi-language-al-folio/blob/main/_data/en-us/strings.yml) e [\_data/pt-br/strings.yml](https://github.com/george-gca/multi-language-al-folio/blob/main/_data/pt-br/strings.yml). No primeiro arquivo eles tΓͺm:
```yaml
latest_posts: latest posts
```
E no segundo arquivo eles tΓͺm:
```yaml
latest_posts: ΓΊltimas postagens
```
Dessa forma, eles podem usar a chave `latest_posts` no layout assim:
{% raw %}
```liquid
{{ site.data[site.active_lang].strings.latest_posts }}
```
{% endraw %}
O que obterΓ‘ corretamente o valor para a variΓ‘vel `latest_posts` definida no arquivo `_data/:lang/strings.yml` para o idioma atual.
## Definindo qual variΓ‘vel usar no frontmatter
Agora, se vocΓͺ quiser definir essa variΓ‘vel no frontmatter da pΓ‘gina, isso fica um pouco mais complicado. Uma possΓvel solução Γ© verificar se o valor da variΓ‘vel tem um `.` nele e, se tiver, usar o valor no arquivo `_data/:lang/strings.yml`. Γ assim que vocΓͺ faria:
{% raw %}
```liquid
{% if frontmatter_var contains '.' %}
{% assign first_part = frontmatter_var | split: '.' | first %}
{% assign last_part = frontmatter_var | split: '.' | last %}
{% capture result %}{{ site.data[site.active_lang].strings[first_part][last_part] }}{% endcapture %}
{% endif %}
{{ result }}
```
{% endraw %}
Isso funcionarΓ‘, por exemplo, se `frontmatter_var = blog.title`.
Agora, se vocΓͺ precisar verificar se a string de tradução (neste caso `blog.title`) realmente existe no arquivo `_data/:lang/strings.yml` antes de usΓ‘-la, vocΓͺ terΓ‘ que criar um plugin para verificar se a variΓ‘vel existe no arquivo `_data/:lang/strings.yml` e, se existir, usΓ‘-la, caso contrΓ‘rio, retornar para qualquer valor que vocΓͺ quiser. NΓ£o entrarei em detalhes sobre como fazer isso, mas mostrarei como usΓ‘-lo. VocΓͺ pode ver o cΓ³digo do plugin [aqui](https://github.com/george-gca/multi-language-al-folio/blob/main/_plugins/localization-exists.rb).
{% raw %}
```liquid
{% if frontmatter_var contains '.' %}
{% capture contains_localization %}{% localization_exists {{ frontmatter_var }} %}{% endcapture %}
{% if contains_localization == 'true' %}
{% assign first_part = frontmatter_var | split: '.' | first %}
{% assign last_part = frontmatter_var | split: '.' | last %}
{% capture result %}{{ site.data[site.active_lang].strings[first_part][last_part] }}{% endcapture %}
{% else %}
{% capture result %}fallback value{% endcapture %}
{% endif %}
{% endif %}
{{ result }}
```
{% endraw %} untra-polyglot-e688c05/site/_posts/pt-BR/2024-03-17-polyglot-1.8.0.md 0000664 0000000 0000000 00000004602 15201735340 0024146 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.8.0 - Liberação de contribuiçáes comunitÑrias
lang: pt-BR
---
Fique animado com o Jekyll-Polyglot 1.8.0, que tem algumas melhorias de recursos e reconhece a documentação e contribuiçáes da comunidade!
## links permanentes especΓficos idoma
Um novo recurso Γ© fornecer links permanentes especΓficos ao idioma das pΓ‘ginas e manter sua associação com outras pΓ‘ginas relativas. Este novo recurso foi novamente aprimorado por **[antoniovazquezblanco](https://github.com/antoniovazquezblanco)**, que Γ© um cavalheiro e estudioso.
## geração de mapa de site e SEO i18n
Este lançamento também reconhece a qualidade [sitemap.xml]({{ site.url }}/sitemap.xml) y [robots.txt]({{ site.url }}/robots.txt) solução fornecida por **[jerturowetz](https://github.com/jerturowetz)**. Este site agora demonstra e captura mais poder de SEO ao usÑ-los para ser rastreÑvel como um site jekyll estÑtico por provedores de pesquisa. Veja os arquivos do site de exemplo [aqui](https://github.com/untra/polyglot/tree/master/site).
## jekyll :polyglot :post_write hook
Github user **[obfusk](https://github.com/obfusk)** contribuiu com [pequeno PRs](https://github.com/untra/polyglot/pull/142) alguns anos atrΓ‘s:
Com o poliglota `:site, :post_write` como estes sΓ£o executados para cada processo filho:
```rb
Jekyll::Hooks.register :site, :post_write do |site|
...
end
```
Esta versΓ£o adiciona um personalizado `:post_write` hook que Γ© executado exatamente uma vez, depois que todos os idiomas foram processados (whether or not `parallel_localization` is used):
```rb
Jekyll::Hooks.register :polyglot, :post_write do |site|
# faΓ§a algo incrΓvel aqui!
end
```
Este recurso Γ© ΓΊtil para sites estΓ‘ticos jekyll complexos que fazem uso adicional de [jekyll hook plugins](https://jekyllrb.com/docs/plugins/hooks/).
Obfusk também contribuiu com uma correção para [registro adicional quando os subprocessos da linguagem falham](https://github.com/untra/polyglot/pull/145). Obrigado por esta contribuição!
## variΓ‘veis ββlocalizadas e tradução para o portuguΓͺs.
**[george-gca](https://github.com/george-gca)** Γ© um cara talentoso e incrΓvel, ele contribuiu [com um todo blogpost](/2024/02/29/localized-variables/) por qual a melhor forma de localizar rich text dos dados do site. Ele tambΓ©m forneceu um[site de tradução brasileiro](https://polyglot.untra.io/pt-BR/).
untra-polyglot-e688c05/site/_posts/pt-BR/2024-08-18-polyglot-1.8.1.md 0000664 0000000 0000000 00000001461 15201735340 0024155 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.8.1 - Community Bug Fixes Release
lang: pt-BR
---
Jekyll-Polyglot 1.8.1 foi lançado, trazendo algumas melhorias de recursos e reconhecendo bugs identificados pela comunidade, para os quais foram fornecidas correçáes.
## Correçáes de Bugs Fornecidas pela Comunidade
**[hacketiwack](https://github.com/hacketiwack)** contribuiu com uma [verificação mais rigorosa para definir um permalink de documento](https://github.com/untra/polyglot/pull/200/files), evitando problemas posteriores com campos vazios de frontmatter.
O usuÑrio do Github **[blackpill](https://github.com/blackpill)** enviou uma [correção de bug de um caractere para a tag](https://github.com/untra/polyglot/pull/211/files) de cabeçalhos i18n ao renderizar o href alternativo do link do idioma padrão. untra-polyglot-e688c05/site/_posts/pt-BR/2025-01-18-polyglot-1.9.0.md 0000664 0000000 0000000 00000002525 15201735340 0024151 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.9.0 - Melhorias Instrucionais
lang: pt-BR
description: jekyll-polyglot lanΓ§amento 1.9.0, con melhorias instrucionais para melhor SEO para sites multilΓngues.
---
Jekyll-Polyglot 1.9.0 foi lanΓ§ado, que possui pequenas atualizaçáes de dependΓͺncia e melhorias instrucionais para obter o mΓ‘ximo do seu site multilΓngue.
## Melhorias instrucionais fornecidas pela comunidade
Obrigado a **[aturret](https://github.com/aturret)** por ajudar a manter as pΓ‘ginas do site chinΓͺs (zh-CN) existentes. θ°’θ°’οΌ
**[george-gca](https://github.com/george-gca)** aprimorou a configuração opcional `derive_lang_from_path` para melhor identificar o idioma do documento a partir da inferΓͺncia do caminho. Testes foram adicionados para seu ΓΊtil [PR de melhoria de recurso](https://github.com/untra/polyglot/pull/222). Essa melhoria ajuda a inferir o idioma de posts e pΓ‘ginas sem frontmatter `lang`, de qualquer parte do caminho do arquivo do documento.
O usuÑrio do Github **[yunseo-kim](https://github.com/yunseo-kim)** enviou [instruçáes para melhorar a geração de sitemap](https://github.com/untra/polyglot/pull/230). Para ajudar no SEO, um site deve ter apenas um sitemap.xml raiz, e não duplicatas para cada site de sub-linguagem. Certifique-se de adicionar `sitemap.xml` à configuração `exclude_from_localization`. untra-polyglot-e688c05/site/_posts/pt-BR/2025-07-07-polyglot-1.10.0.md 0000664 0000000 0000000 00000005433 15201735340 0024226 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.10 - melhorias no i18n_headers
lang: pt-BR
description: Lançamento do Jekyll Polyglot 1.10.0, com melhorias na geração de SEO ao usar o plugin i18n_headers
---
O Jekyll-Polyglot 1.10 jΓ‘ estΓ‘ disponΓvel. Ele traz grandes melhorias e mudanΓ§as no plugin liquid `i18n_headers` para SEO, alΓ©m de pequenos ajustes para idempotΓͺncia em builds paralelos. Contribuiçáes da comunidade e Vibe Coding ajudaram em grande parte dos recursos, testes e redação deste lanΓ§amento.
## Melhorias no i18n_headers
O plugin `i18n_headers` agora possui capacidades estendidas nesta versΓ£o:
* adiciona `GitHub 代η εΊ θΏθ‘δΈθ½½γζ±ζ₯ιι’οΌδ»₯εηΉζ§ζδΊ€γ
θ°’θ°’δ½Ώη¨οΌ
untra-polyglot-e688c05/site/_posts/zh-CN/2015-11-14-polyglot-version-1-1.md 0000664 0000000 0000000 00000000457 15201735340 0025456 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot ηζ¬ 1.1.0
lang: zh-CN
---
Polyglot η°ε·²ε
¨ι’ζ―ζ [Jekyll 3.0](https://jekyllrb.com/news/2015/10/26/jekyll-3-0-released/) εε’οΌ[ε»θ―θ―ηε§οΌ](https://github.com/untra/polyglot)
{% highlight yaml %}
gem 'jekyll-polyglot', '~> 1.1.0'
{% endhighlight %}
untra-polyglot-e688c05/site/_posts/zh-CN/2015-9-19-presenting-polyglot.md 0000664 0000000 0000000 00000005132 15201735340 0025602 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot ηδ»
lang: zh-CN
---
ε¨η»θΏζ°ζηζ磨εοΌζεΎιͺε²ε°δΈΊε€§εΆδ»η» **Polyglot**οΌδΈΊι£δΊ*ιθ¦*δΈΊε
ΆεδΌζδΎε€θ―θ¨ε
εΉηη½η«ζζι ηοΌδΈζ¬Ύ [Jekyll](http://jekyllrb.com) η i18n ζδ»Άγ
### ηΉζ§
ε°½η‘εΈι’δΈεε¨ε
Άδ»η Jekyll ε€θ―θ¨ζδ»ΆοΌPolyglot ε΄δΉζε
Άη¬ηΉδΉε€γε€θ―θ¨ζδ»ΆοΌPolyglot ε¨ε
ζ½δΊι£δΊιεΈΈηη» Jekyll εΌεθ
ε»εηθζ΄»η΄―ζ΄»οΌζ―ε¦δΈΊδΊδΏζδΈεθ―θ¨η½η«δΈη«ηΉε°εΎδΏζδΈθ΄θε»ζθ
Ύ url ηεζ³οΌηεζΆοΌθΏδΈΊδ»δ»¬ζδΎδΊι«ζδΈηεη SEO δΈε
εΉθεε·₯ε
·γ
## εε»ΊηΈε―ΉειΎζ₯
ε¨θΏε»οΌδΈζ¬Ύιζη½η«/εε’ηε€θ―θ¨ζδ»ΆεΏ
ι‘»θ΄ΉεΏε°θ·θΏη»΄ζ€η½η«δΈζζδΎηζ―η§θ―θ¨ηηΈε―ΉιΎζ₯γεΌεθ
εΎεΉζη―ιοΌηΆεε€θ―θΏε’ε°±δΌδΈδΈεζθΏθΏζ²‘ηΏ»θ―ηε
εΉδΉδΈγ
Polyglot θͺε¨εε°δΈΊζ―η§δ½ εΈζη½η«ζζ₯ζηθ―θ¨η url θΏθ‘ηΈε―Ήεε€ηγθΏε―δ»₯θ©η½η«ηθΏε’ε―δ»₯ε¨ζ΅θ§δ½ ηη½η«ζΆδΈη΄δ½Ώη¨εδΈη§θ―θ¨ηηζ¬γ
## εΊεζ―ζ
ε½δ½ *沑ζ*δΈΊε€θ―θ¨ε
εΉζδΎηΏ»θ―ηζ¬ζΆοΌJekyll δΎηΆδΌδΈΊθ―₯θ―θ¨ηεη«ηΉζ Ήζε·²ζηε
εΉθΏθ‘ζε»Ίγθε¨δ½ *ζδΎ*δΊε€θ―θ¨ηΏ»θ―ηζ¬ηζ
ε΅δΈοΌJekyll δΌζ Ήζθ―₯ε
εΉε―Ήθ―₯θ―θ¨ηεη«ηΉζε»Ίε―ΉεΊε
εΉγε°±ζ―θΏδΉηεγ
η«ηΉε°εΎε―Ήζζθ―θ¨εδΏζδΈθ΄οΌηΏ»θ―ε
εΉδΈε
Άζε€ηεη«ηΉδΈδΈε―ΉεΊγ
## ε―ζζ¬ηΏ»θ―
δΈθ¬ζ₯θ²οΌε―ζζ¬ε
εΉηε€θ―θ¨ηΏ»θ―εΎιΎεη°γε―ΉδΈδΈͺ Jekyll η½η«ζ₯θ―΄οΌε€θ―θ¨ηηε符串ζθ
ζδΊθ―θ¨ηηΉεη¨θ―εΎιΎε¨ζΎη€ΊδΈδΏζδΈθ΄γ
*δ½η°ε¨ε΄ηεε¦ζ―*οΌεͺιε¨δ½ η `config.yml` ζδ»ΆδΈοΌζη
§ε¦δΈζΉεΌεε¨ε符串οΌ
{% highlight yaml %}
hello:
en: Hello!
es: Β‘hola!
fr: Bonjour!
de: Guten Tag!
{% endhighlight %}
ζη
§ε¦δΈζΉεΌδ½Ώη¨ Liquid 樑ζΏε
εΉοΌ
{% highlight html %}
{% raw %}
{{ site.hello[site.active_lang]}}
{% endraw %}
{% endhighlight %}
δΌηζε¦δΈε
εΉοΌ
{{ site.hello[site.active_lang]}}
## εΏ«ιοΌεΌζ₯οΌιΆζζ¬ζε»Ί
Polyglot δΌεζε»Ίδ½ ηι»θ€θ―θ¨η«ηΉδΈζ ·ζε»Ίδ½ ηε€θ―θ¨η«ηΉγPolyglot δΌδ»₯ζε°ηζζ¬ε¨εθͺη¬η«ηθΏη¨δΈ*εζΆ*ζε»Ίδ½ ηη½η«ηζ―η§θ―θ¨ηεη«ηΉγθΏζε³ηοΌδ½ ηη½η«ηζε»ΊζΆι΄δΈδΌε δΈΊζ―ζθ―θ¨ηζ°ιθε’ε γ
### δΈθ½½
Polyglot ζ―ζ gem ηζ¬οΌδΉε―δ»₯ε½δ½ Jekyll ζδ»Άδ½Ώη¨γε―δ»₯δ½Ώη¨ε¦δΈδ»£η εθ£
οΌ
{% highlight bash %}
gem install 'jekyll-polyglot'
{% endhighlight %}
untra-polyglot-e688c05/site/_posts/zh-CN/2016-12-16-Polyglot-1.2.4.md 0000664 0000000 0000000 00000002702 15201735340 0024076 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.2.4
lang: zh-CN
---
Polyglot ηε
¨ζ°ηζ¬η°ε·²ζ¨εΊγε»θ―θ―ε§οΌ
{% highlight yaml %}
gem install jekyll-polyglot
{% endhighlight %}
ζ¬ηζ¬η± GitHub η¨ζ· [vlsi](https://github.com/vlsi) ηηεΏζ―ζζδΎοΌδ»δΏε€δΊδΈδΊ bugοΌεΉΆζ·»ε δΊδΈεζ°ηΉζ§οΌ
### ζ―ζη»ε―Ή URL ηε€θ―θ¨ηΏ»θ―ηζ¬
Polyglot η°ε¨δΌηΏ»θ―δ½ η `site.url`οΌε ζ€οΌη»ε―Ή URL δΉδΌεΎε°ηΏ»θ―δΊγ
### ζ―ζε―Ήε
¨ι¨ Jekyll ειηηΏ»θ―
[Jekyll ει](https://jekyllrb.com/docs/collections/)ζ―δΈι‘Ή Jekyll ηε
¨ζ°ηΉζ§γζ¬ζ¬‘ζ΄ζ°δΉδΌζζζη°ζειι½θΏθ‘ηΏ»θ―οΌθδΈεͺζζη« ει‘΅ι’γ
### ε½ `site.data[:lang]` εε¨ζΆοΌε―Ή `site.data` ηε―ζζ¬δ½Ώη¨θ―θ¨ηΉεη `_data` ε
εΉηΏ»θ―
ζ Ήηε½δΈηε―ζζ¬δΌε¨ηζζΆγδΉεε¦ζζ³θ¦ζΈ²ζε―ζζ¬ε
εΉοΌδ½ ιθ¦ζη
§ε¦δΈζΉεΌδ½Ώη¨οΌ
{% highlight html %}
{% raw %}
{{ site.data[site.active_lang].richTextString }}
{% endraw %}
{% endhighlight %}
η°ε¨οΌε―ζζ¬ε
εΉε―δ»₯η΄ζ₯δ½Ώη¨ε¦δΈζ ηΎθΏθ‘ζΈ²ζοΌ
{% highlight html %}
{% raw %}
{{ site.data.richTextString }}
{% endraw %}
{% endhighlight %}
### `I18n_Headers` ε¨ηη©ΊζΆδ½Ώη¨ζ₯θͺ `site.url` ηι»θ€εΌ
η¨ζ·η°ε¨ε―δ»₯ε¨δΈζεηΉε url ηζ
ε΅δΈδ½Ώη¨δΈεζ ηΎοΌ
{% highlight html %}
{% raw %}
{% I18n_Headers %}
{% endraw %}
{% endhighlight %}
θΏδΊζ ηΎε°δΌδ½Ώη¨δ½ η `site.url` ηι»θ€εΌγ
untra-polyglot-e688c05/site/_posts/zh-CN/2016-4-20-Polyglot-1.2.0.md 0000664 0000000 0000000 00000002507 15201735340 0024011 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.2.0
lang: zh-CN
---
Polyglot ηε
¨ζ°ηζ¬η°ε·²ζ¨εΊγε»θ―θ―ε§οΌ
{% highlight yaml %}
gem install jekyll-polyglot
{% endhighlight %}
ζ€ε€οΌθΏθ―·ζ `jekyll-polyglot` ζ·»ε ε°δ½ ηη½η«η `_config.yml` η gem ε葨δΈγ
ζ¬ηζ¬δΈ»θ¦ζ―δΈΊζ₯δΈζ₯ηζ°ηΉζ§δ»₯εζ΄ε₯½ηε€θ―θ¨ε
εΉη‘ηζδΎεΊη‘εε€γζ€ε€οΌζ¬ηζ¬θΏε
ζ¬δΊδΈδΊζ°ηΉζ§οΌ
## {% raw %} {% I18n_Headers %} {% endraw %}
θ―·ζθΏδΊζ ηΎε[δ½ ηη½η«η url](https://github.com/untra/polyglot/blob/site/_includes/head.html#L6) δΈεζΎε
₯δ½ η `includes` ζδ»Άε€ΉδΈη `head.html` ζδ»ΆδΈοΌδ»₯ζ€θ·εΎζ倧εηε€θ―θ¨η«ηΉ SEO γε
ΆζζδΈε¦δΈ Liquid 代η ηεοΌ
{% highlight html %}{% raw %}
Affiliations . Address. Contacts. Moto. Etc.`οΌθε·΄θ₯Ώθ‘θηθ―ι‘΅ι’ηεΌδΈΊ `subtitle: Afiliaçáes . EndereΓ§o. Contatos. Lema. Etc.`γθ¦ε¨εΈε±δΈδ½Ώη¨ζ€δΏ‘ζ―οΌε―δ»₯θΏζ ·δ½Ώη¨οΌ
{% raw %}
```liquid
{{ page.subtitle }}
```
{% endraw %}
θΏδΈ€δΈͺζδ»ΆδΈεη½ε
ζ°ζδΈζΉηε
εΉδΉζ―δΈζ ·ηοΌε―δ»₯ε¨εΈε±δΈθΏζ ·δ½Ώη¨οΌ
{% raw %}
```liquid
{{ content }}
```
{% endraw %}
Polyglot δΌθͺε¨δ½Ώη¨ε½εθ―θ¨ηζ£η‘εΌζΈ²ζι‘΅ι’γ
## ε¨ι‘΅ι’δΉι΄ε
±δΊ«εΈε±εζ¬ε°εζ°ζ
ε―ΉδΊι‘΅ι’η `subtitle`οΌδ»δ»¬ε¨εη½ε
ζ°ζδΈδ½Ώη¨δΊ `key: value` ιεΌε―ΉοΌδ½ζζΆζ们εΈζε¨η«ηΉηδΈει¨εδΈδ½Ώη¨θΏδΊηΈεηε―ΉγδΎε¦οΌε¦ζζ们ζ³ε¨ `about.md` εε¦δΈδΈͺι‘΅ι’δΈδ½Ώη¨ηΈεη `subtitle`οΌζ们ε°δΈεΎδΈε¨θΏδΈ€δΈͺι‘΅ι’ηεη½ε
ζ°ζδΈιε€ηΈεηε―ΉγθΏεΉΆδΈζ―ζ们ζ³θ¦ηοΌε δΈΊε¦ζζ们ιθ¦ζ΄ζΉ `subtitle`οΌζ们ε°δΈεΎδΈε¨δΈ€δΈͺε°ζΉζ΄ζΉεγθΏε°±ζ―ζ¬ε°εζ°ζηη¨ζ¦δΉε°γζ¨ε―δ»₯εε»ΊδΈδΈͺζδ»ΆοΌδΎε¦ `_data/:lang/strings.yml`οΌζ―η§θ―θ¨δΈδΈͺοΌPolyglot ε°θΏδΊιεΈ¦ε° `site.data[:lang].strings` δΈγ
ζ―ε¦θ―΄οΌε¨ζ¨‘ζΏη«ηΉδΈζδΈ€δΈͺζδ»ΆοΌ[\_data/en-us/strings.yml](https://github.com/george-gca/multi-language-al-folio/blob/main/_data/en-us/strings.yml) ε [\_data/pt-br/strings.yml](https://github.com/george-gca/multi-language-al-folio/blob/main/_data/pt-br/strings.yml)γε¨η¬¬δΈδΈͺζδ»ΆδΈοΌεη½ε
ζ°ζε
εΉε
ζ¬οΌ
```yaml
latest_posts: latest posts
```
θε¨η¬¬δΊδΈͺζδ»ΆδΈοΌεη½ε
ζ°ζε
εΉε
ζ¬οΌ
```yaml
latest_posts: ΓΊltimas postagens
```
θΏζ ·οΌδ»δ»¬ε―δ»₯ε¨εΈε±δΈδ½Ώη¨ `latest_posts` ιοΌε¦δΈζη€ΊοΌ
{% raw %}
```liquid
{{ site.data[site.active_lang].strings.latest_posts }}
```
{% endraw %}
θΏζ ·δΈζ₯οΌ`latest_posts` ειηεΌε°ζ£η‘θ·εε°ε½εθ―θ¨η `_data/:lang/strings.yml` ζδ»ΆδΈεδΉηεΌγ
## ε¨εη½ε
ζ°ζδΈεδΉθ¦δ½Ώη¨ηει
η°ε¨οΌε¦ζζ¨ζ³ε¨ι‘΅ι’ηεη½ε
ζ°ζδΈεδΉθΏδΈͺειοΌθΏε°±ζηΉζ£ζδΊγδΈδΈͺε―θ½η解ε³ζΉζ‘ζ―ζ£ζ₯ειηεΌδΈζ―ε¦ζ `.`οΌε¦ζζοΌε°±δ½Ώη¨ζδ»Ά `_data/:lang/strings.yml` δΈηεΌγδ½ ε―δ»₯θΏδΉθΏθ‘ζδ½οΌ
{% raw %}
```liquid
{% if frontmatter_var contains '.' %}
{% assign first_part = frontmatter_var | split: '.' | first %}
{% assign last_part = frontmatter_var | split: '.' | last %}
{% capture result %}{{ site.data[site.active_lang].strings[first_part][last_part] }}{% endcapture %}
{% endif %}
{{ result }}
```
{% endraw %}
ε¦ζ `frontmatter_var = blog.title` οΌθΏζ΅δ»£η ε°±δΌηζγ
This will work, for example, if `frontmatter_var = blog.title`.
η°ε¨οΌε¦ζζ¨ιθ¦ε¨δ½Ώη¨εδΉεζ£ζ₯ζ¬ε°εε符串οΌθ―₯ζ‘δΎζ
ε΅δΈζ― `blog.title`οΌζ―ε¦ει
εε¨δΊζδ»Ά `_data/:lang/strings.yml` δΈοΌζ¨ε°δΈεΎδΈεε»ΊδΈδΈͺζδ»Άζ₯ζ£ζ₯ειζ―ε¦εε¨δΊζδ»Ά `_data/:lang/strings.yml` δΈοΌε¦ζεε¨οΌεδ½Ώη¨εοΌε¦εειε°δ»»δ½ζ¨ζ³θ¦ηεΌγζδΈδΌθ―¦η»δ»η»ε¦δ½εε°θΏδΈηΉοΌδ½ζδΌεζ¨ε±η€Ίε¦δ½δ½Ώη¨εγζ¨ε―δ»₯ε¨[θΏι](https://github.com/george-gca/multi-language-al-folio/blob/main/_plugins/localization-exists.rb)ει
θ―₯ζδ»Άη代η γ
{% raw %}
```liquid
{% if frontmatter_var contains '.' %}
{% capture contains_localization %}{% localization_exists {{ frontmatter_var }} %}{% endcapture %}
{% if contains_localization == 'true' %}
{% assign first_part = frontmatter_var | split: '.' | first %}
{% assign last_part = frontmatter_var | split: '.' | last %}
{% capture result %}{{ site.data[site.active_lang].strings[first_part][last_part] }}{% endcapture %}
{% else %}
{% capture result %}fallback value{% endcapture %}
{% endif %}
{% endif %}
{{ result }}
```
{% endraw %} untra-polyglot-e688c05/site/_posts/zh-CN/2024-03-17-polyglot-1.8.0.md 0000664 0000000 0000000 00000004213 15201735340 0024137 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.8.0 - η€ΎεΊθ΄‘ηεεΈ
lang: zh-CN
---
ιεΈΈε
΄ε₯ε°ε£εΈ Jekyll-Polyglot 1.8.0 ηζ¬εεΈδΊοΌθΏδΈͺηζ¬ε’ε δΊδΈδΊεθ½ζΉθΏοΌεΉΆθ€ε―δΊζ₯θͺη€ΎεΊηζζ‘£εθ΄‘ηοΌ
## δΈεθ―θ¨ηδΈε±ζ°ΈδΉ
ιΎζ₯
Polyglot 1.8.0 ηζ¬ε’ε δΊδΈδΊζ°εθ½οΌε―δ»₯δΈΊι‘΅ι’θΎη½ηΉεδΊθ―θ¨ηζ°ΈδΉ
ιΎζ₯οΌεΉΆδΏηε们δΈε
Άδ»ηΈε
³ι‘΅ι’ηε
³θγθΏδΈͺζ°εθ½η±δΈδ½η»
士εε¦θ
ββ **[antoniovazquezblanco](https://github.com/antoniovazquezblanco)** ζδΎγ
## η½η«ε°εΎηζε i18n SEO
θΏδΈͺηζ¬θΏθ€ε―δΊ **[jerturowetz](https://github.com/jerturowetz)** ζδΎηι«θ΄¨ι [sitemap.xml]({{ site.url }}/sitemap.xml) ε [robots.txt]({{ site.url }}/robots.txt) 解ε³ζΉζ‘γζ¬η½η«η°ε¨ιθΏθΏδΊζδ»Άζ΄ε₯½ε°ε±η€Ίεζθ·δΊζη΄’εΌζζδΎη SEO ειγε―δ»₯ε¨[θΏι](https://github.com/untra/polyglot/tree/master/site)ζ₯ηη€ΊδΎη½η«ηζδ»Άγ
## jekyll :polyglot :post_write ι©ε
GitHub η¨ζ· **[obfusk](https://github.com/obfusk)** ε¨ε εΉ΄εθ΄‘ηδΊδΈδΈͺ[εΎε°η PR](https://github.com/untra/polyglot/pull/142)οΌ
ιθΏε€θ―θ¨ `:site, :post_write` ι©εοΌεθΏζ ·δΈΊζ―δΈͺεθΏη¨θΏθ‘οΌ
```rb
Jekyll::Hooks.register :site, :post_write do |site|
...
end
```
θΏδΈͺηζ¬ε’ε δΊδΈδΈͺθͺεδΉ `:post_write` ι©εοΌεε¨ζζθ―θ¨ε€ηεζεθΏθ‘δΈζ¬‘οΌζ θΊζ―ε¦δ½Ώη¨ `parallel_localization`οΌοΌ
```rb
Jekyll::Hooks.register :polyglot, :post_write do |site|
# do something amazing here!
end
```
θΏδΈηΉζ§ε―ΉδΊδ½Ώη¨δΊ [Jekyll hook ζδ»Ά](https://jekyllrb.com/docs/plugins/hooks/)ηε€ζη Jekyll ιζη«ηΉιεΈΈζη¨γ
ε₯ΉθΏδΈΊ[θ―θ¨εθΏη¨ε΄©ζΊζΆηι’ε€ζ₯εΏθ°ε½](https://github.com/untra/polyglot/pull/145)ζδΎδΊδΏε€γζθ°’θΏδΈͺθ΄‘ηοΌ
## ζ¬ε°εειεθ‘θηθ―ηΏ»θ―
**[george-gca](https://github.com/george-gca)** ζ―δΈδΈͺζεζ¨ͺζΊ’ηγεΎζ£ηεΆδΌοΌδ»δΈΊε¦δ½ζε₯½ε°δ»η«ηΉζ°ζζ¬ε°εε―ζζ¬θ΄‘ηδΊ[δΈζ΄η―εε’ζη« ](/2024/02/29/localized-variables/)γδ»θΏζδΎδΊ[ζ¬η«ηθ‘θηθ―ηΏ»θ―](https://polyglot.untra.io/pt-BR/)γ
untra-polyglot-e688c05/site/_posts/zh-CN/2024-08-18-polyglot-1.8.1.md 0000664 0000000 0000000 00000001252 15201735340 0024146 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.8.1 - η€ΎεΊ Bug δΏε€εεΈ
lang: zh-CN
---
Jekyll-Polyglot 1.8.1 ηζ¬ε·²η»εεΈοΌε
ΆδΈε
ε«δΊδΈδΊεθ½ζΉθΏοΌεΉΆδΏε€δΊη€ΎεΊεη°η Bugγ
## η€ΎεΊζδΎη Bug δΏε€
**[hacketiwack](https://github.com/hacketiwack)** ζδΎδΊη¨δΊ[ζ΄δΈ₯ζ Όζ£ζ₯θΎη½ζζ‘£ζ°ΈδΉ
ιΎζ₯](https://github.com/untra/polyglot/pull/200/files)η代η οΌι²ζ’ε η©Ίηεη½εζ΅ε―Όθ΄ηδΈζΈΈιι’γ
Github η¨ζ· **[blackpill](https://github.com/blackpill)** ζδΊ€δΊιε―Ή i18n headers ζ ηΎη[εε符ιθ――δΏε€](https://github.com/untra/polyglot/pull/211/files)οΌη¨δΊζΈ²ζι»θ€θ―θ¨ιΎζ₯ηζΏδ»£ιΎζ₯οΌhrefοΌγ
untra-polyglot-e688c05/site/_posts/zh-CN/2025-01-18-polyglot-1.9.0.md 0000664 0000000 0000000 00000002374 15201735340 0024146 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.9.0 - ζη¨δΌε
lang: zh-CN
description: Jekyll Polyglot 1.9.0 ηζ¬ε―Ήζη¨θΏθ‘δΊδΌεοΌθΏδΈζ₯ε©εδΌεζ¨ηε€θ―θ¨η½η«η SEOγ
---
Jekyll-Polyglot 1.9.0 η°ε·²εεΈγζ΄ζ°ε
εΉε
ζ¬ε°θΈδΎθ΅ι‘Ήζ΄ζ°οΌδ»₯εε©ζ¨ε
εε©η¨ε€θ―θ¨η½η«ηΉζ§ηδΌεηζη¨γ
## η€ΎεΊζδΎηζη¨ζΉθΏ
ζθ°’ **[aturret](https://github.com/aturret)** εΈε©η»΄ζ€η°ζηηδ½δΈζ (zh-CN) η½η«ι‘΅ι’γθ°’θ°’οΌ
**[george-gca](https://github.com/george-gca)** δΌεδΊε―ιη `derive_lang_from_path` ι
η½γε
Άε―δ»₯ζ΄ε₯½ε°δ»θ·―εΎζ¨ζδΈθ―ε«ζζ‘£θ―θ¨γδ»εη¨η[εθ½δΌε PR](https://github.com/untra/polyglot/pull/222) δΈθΏε
ζ¬δΊζ΅θ―γζ€ι‘ΉζΉθΏζε©δΊζ¨ζηΌΊε° `lang` ει‘΅ε
εΉεζ΅ηεΈεει‘΅ι’ηθ―θ¨οΌθΏδΊθ―θ¨ζ₯θͺζζ‘£ζδ»Άθ·―εΎηδ»»δ½ι¨εγ
Github η¨ζ· **[yunseo-kim](https://github.com/yunseo-kim)** ζδΊ€δΊδΈδ»½[δΌεη½η«ε°εΎηζηζη¨](https://github.com/untra/polyglot/pull/230)γδΈΊιι
SEO ζε
³θ§θοΌδΈδΈͺη½η«εΊθ―₯εͺζδΈδΈͺζ Ήηε½δΈη `sitemap.xml`οΌε
Άδ»θ―θ¨ηεη«ηΉε
δΈεΊε
ε«θ―₯ζδ»Άηε―ζ¬γθ―·ε‘εΏ
ε° `sitemap.xml` ζ·»ε ε° `exclude_from_localization` ι
η½δΈγ
untra-polyglot-e688c05/site/_posts/zh-CN/2025-07-07-polyglot-1.10.0.md 0000664 0000000 0000000 00000005257 15201735340 0024225 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Polyglot 1.10 - i18n_headers δΌε
lang: zh-CN
description: Jekyll Polyglot 1.10.0 ηζ¬ε―Ήi18n_headers ζδ»Άε¨ SEO ηζζΉι’θΏθ‘δΊδΌε
---
Jekyll-Polyglot 1.10 η°ε·²εεΈγζ¬ζ¬‘εεΈε―Ή liquid ζδ»Ά `i18n_headers` θΏθ‘δΊε€§ιδΌεεζΉε¨δ»₯ζε SEO ζζοΌεΉΆε―ΉεΉΆθ‘ζε»ΊηεΉηζ§εδΊδΊθΈθ°ζ΄γη€ΎεΊθ΄‘ηθ
ε Vibe Coding ε¨ζ¬ζ¬‘εεΈηθ―Έε€εθ½γζ΅θ―οΌδ»₯εεε’ζ°εδΈεζ₯δΊιθ¦δ½η¨γ
η°ηζ¬η polyglot ιθ¦ζ΄ζ° ruby θ³ 3.1 εδ»₯δΈηζ¬οΌε―θ½δΌη ΄εζ¨η°ζηζε»Ίη³»η»γ
## i18n_headers ζΉθΏ
`i18n_headers` ζδ»Άη°ε·²ε
·ε€ζ΄ε€εθ½οΌ
* ε
ΆδΌδΈΊζ―η§θ―θ¨ηι‘΅ι’ζ·»ε `
Polyglot ΩΩ Ψ₯ΨΆΨ§ΩΨ© Ω
ΩΨͺΩΨΨ© Ψ§ΩΩ
Ψ΅Ψ―Ψ± ΩΩΨͺΨ―ΩΩΩ ΩΩ
Ψ―ΩΩΨ§Ψͺ Jekyll . Polyglot Ψ³ΩΩ Ψ§ΩΨ₯ΨΉΨ―Ψ§Ψ― ΩΨ§ΩΨ§Ψ³ΨͺΨΨ―Ψ§Ω
Ω
ΨΉ Ψ£Ω Ω
Ψ΄Ψ±ΩΨΉΨ ΩΩΨͺΩΨ³ΨΉ ΩΩΨΊΨ§Ψͺ Ψ§ΩΨͺΩ ΨͺΨ±ΩΨ― Ψ―ΨΉΩ
ΩΨ§. Ω
ΨΉ Ψ―ΨΉΩ
Ψ§ΩΨ§ΨΨͺΩΨ§Ψ·Ω ΩΩΩ
ΨΨͺΩΩ Ψ§ΩΩ
ΩΩΩΨ―Ψ ΩΨ₯ΨΉΨ§Ψ―Ψ© ΨͺΩΨ¬ΩΩ URL Ψ§ΩΨͺΩΩΨ§Ψ¦ΩΨ ΩΩΨ΅ΩΨ§Ψͺ SEO ΩΩΩΨ© Ψ ΩΨ³Ω
Ψ Polyglot ΩΨ£Ω Ω
Ψ―ΩΩΨ© Ω
ΨͺΨΉΨ―Ψ―Ψ© Ψ§ΩΩΨΊΨ§Ψͺ Ψ¨Ψ§ΩΨͺΨ±ΩΩΨ² ΨΉΩΩ Ψ§ΩΩ
ΨΨͺΩΩ Ψ―ΩΩ Ψ§ΩΨͺΨΉΩΩΨ―.
_`jekyll-polyglot` ΨΊΩΨ± Ω
Ψ―ΨΉΩΩ
Ψ¨ΨΉΨ― Ψ¨Ψ΄ΩΩ Ψ£Ψ΅ΩΩ ΩΩ github-actions_
### Ψ§ΩΨͺΨ«Ψ¨ΩΨͺ
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### Ψ₯Ψ―Ψ§Ψ±Ψ© Ψ§ΩΩΨΊΨ§Ψͺ Ψ§ΩΩ
Ψ―ΨΉΩΩ
Ψ©
ΩΩ `_config.yml`Ψ ΨͺΨ―ΩΨ± Ψ§ΩΨΨ΅Ψ§Ψ¦Ψ΅ Ψ§ΩΨͺΨ§ΩΩΨ© Ψ§ΩΩΨΊΨ§Ψͺ Ψ§ΩΨͺΩ ΩΨ―ΨΉΩ
ΩΨ§ Ω
ΩΩΨΉΩ. ΩΩ
ΩΩΩ ΨͺΩΩΩΨ± Ψ―ΨΉΩ
ΩΩΨΊΨ© Ψ¬Ψ―ΩΨ―Ψ© Ψ¨Ψ₯ΨΆΨ§ΩΨͺΩΨ§ Ψ₯ΩΩ ΩΨ°Ω Ψ§ΩΩΩΩ
(Ψ§ΩΨΈΨ± Ψ£Ψ―ΩΨ§Ω). ΩΨͺΩ
ΨͺΨΨ―ΩΨ― Ψ§ΩΩΨΊΨ§Ψͺ Ψ¨ΩΨ§Ψ³Ψ·Ψ© [Ψ±Ω
ΩΨ² Ψ§ΩΩ
ΩΨ·ΩΨ©](https://developer.chrome.com/webstore/i18n) Ψ§ΩΨ±Ψ³Ω
ΩΨ© Ψ§ΩΨΨ§Ψ΅Ψ© Ψ¨ΩΨ§.
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` Ω
Ψ΅ΩΩΩΨ© Ω
Ω Ψ±Ω
ΩΨ² Ψ§ΩΩ
ΩΨ·ΩΨ© ΨͺΨΨ―Ψ― Ψ§ΩΩΨΊΨ§Ψͺ Ψ§ΩΩ
Ψ―ΨΉΩΩ
Ψ© Ω
Ω Ψ§ΩΩ
ΩΩΨΉ.
* `default_lang:` Ψ§ΩΩΨΊΨ© Ψ§ΩΨ§ΩΨͺΨ±Ψ§ΨΆΩΨ© ΩΩΩ
ΩΩΨΉ.
* `exclude_from_localization:` Ψ§ΩΩ
Ψ¬ΩΨ―Ψ§Ψͺ ΩΨ§ΩΨ£Ψ―ΩΨ© Ψ§ΩΨͺΩ ΩΩ Ψ¬Ψ²Ψ‘ Ω
Ω Ψ§ΩΩ
ΩΩΨΉ Ψ§ΩΩ
Ψ¨ΩΩΨ ΩΩΩΩ ΩΨ§ ΨͺΨΨͺΨ§Ψ¬ Ψ₯ΩΩ ΨͺΨ±Ψ¬Ω
Ψ©. ΩΨ°Ψ§ Ψ¨Ψ΄ΩΩ Ψ±Ψ¦ΩΨ³Ω ΩΨͺΩΩΩΩ Ψ£ΩΩΨ§Ψͺ Ψ§ΩΨ¨ΩΨ§Ψ‘Ψ ΩΩΨ£Ω Ω
ΩΩΨ§Ψͺ Ψ§ΩΨ£Ψ΅ΩΩ Ω
Ψ«Ω Ψ§ΩΨ΅ΩΨ± ΩΨ§ΩΨΨ·ΩΨ· ΩΩ Ψ£Ψ¬Ψ²Ψ§Ψ‘ ΩΨ¨ΩΨ±Ψ© Ω
Ω Ψ§ΩΩ
ΩΩΨΉΨ ΩΨΆΩ
Ω ΨΉΨ―Ω
"ΨͺΨ±Ψ¬Ω
ΨͺΩΨ§" Ψ£Ω ΨͺΩΨ±Ψ§Ψ±ΩΨ§ Ψ¨Ψ΄ΩΩ ΨΊΩΨ± ΨΆΨ±ΩΨ±Ω ΩΩ Ψ§ΩΩ
ΨΨ±Ψ¬Ψ§Ψͺ.
* `url` Ψ±Ψ§Ψ¨Ψ· Ω
ΩΩΨΉΩ Ψ§ΩΨ₯ΩΩΨͺΨ±ΩΩΩ Ψ§ΩΨ«Ψ§Ψ¨Ψͺ ΩΩΨ₯ΩΨͺΨ§Ψ¬.
### Ψ₯ΨΆΨ§ΩΨ© ΩΨΊΨ© Ψ¬Ψ―ΩΨ―Ψ©
Ψ¨Ψ§ΩΨͺΨ±Ψ§ΨΆ Ψ£Ω ΩΨ―ΩΩ Ψ¨Ψ§ΩΩΨΉΩ Ω
ΩΩΨΉΩΨ§ ΩΨΈΩΩΩΩΨ§ Ψ¨ΩΨΊΨ© ΩΨ§ΨΨ―Ψ©Ψ ΩΨ₯Ω Ψ₯ΨΆΨ§ΩΨ© ΩΨΊΨ© Ψ¬Ψ―ΩΨ―Ψ© ΩΩ ΨͺΩΩΩ Ψ¨Ψ³ΩΨ·Ψ©. _ΩΨ₯ΩΨ΄Ψ§Ψ‘ Ω
ΩΩΨΉ Ω
ΨͺΨΉΨ―Ψ― Ψ§ΩΩΨΊΨ§Ψͺ ΨΩΩΨ§Ψ ΩΨ¬Ψ¨ Ψ£Ω ΨͺΨͺΩΩΨΉ Ψ₯ΨΉΨ§Ψ―Ψ© Ψ₯ΩΨ΄Ψ§Ψ‘ ΩΩ Ω
ΨΨͺΩΨ§Ω Ψ¨Ψ§ΩΩΨΊΨ© Ψ§ΩΨ¬Ψ―ΩΨ―Ψ©._ ΩΨ― ΩΨ¨Ψ―Ω ΩΨ°Ψ§ Ω
ΩΩ
Ψ© ΩΨ¨ΩΨ±Ψ©Ψ ΩΩΩ ΩΩΨ± ΩΩ Ψ§ΩΨͺΨ±Ψ¬Ω
Ψ© ΨΉΩΩ Ψ£Ψ¬Ψ²Ψ§Ψ‘. Ψ§ΩΩ
ΨΨͺΩΩ ΩΩ Ψ§ΩΩ
ΩΩΨ Ω
Ω Ψ§ΩΨ£ΩΩ
Ψ£Ω ΨͺΨΨ΅Ω Ψ§ΩΨ΅ΩΨΨ§Ψͺ ΩΨ§ΩΩ
ΩΨ΄ΩΨ±Ψ§Ψͺ Ψ§ΩΨ¬Ψ―ΩΨ―Ψ© ΨΉΩΩ ΨͺΨ±Ψ¬Ω
Ψ§Ψͺ Ω
ΨΨ―Ψ«Ψ©. Ψ₯ΩΨ΄Ψ§Ψ‘ Ω
ΩΩΨΉ Ω
ΨͺΨΉΨ―Ψ― Ψ§ΩΩΨΊΨ§Ψͺ Ψ΅ΨΉΨ¨ ΩΩΨ· Ψ₯Ψ°Ψ§ Ψ·ΩΨ¨Ψͺ Ψ£Ω ΩΩΩΩ Ω
ΨͺΨ±Ψ¬Ω
ΩΨ§ Ψ¨Ψ΄ΩΩ Ω
Ψ«Ψ§ΩΩ Ω
Ω Ψ§ΩΨ¨Ψ―Ψ§ΩΨ©.
Ψ£ΩΩΨ§ΩΨ ΩΨ¬Ψ¨ ΨΉΩΩΩ (ΩΩΨ±ΩΩΩΨ ΩΩ
Ψ―ΩΨ±ΩΩ Ψ£ΩΨΆΩΨ§ Ψ₯Ψ°Ψ§ ΩΨ§Ω ΩΨ―ΩΩ Ψ¨ΨΉΨΆ Ω
ΩΩΩ
) Ω
ΩΨ§ΩΨ΄Ψ© ΩΨ§ΨΨͺΩΨ§Ψ± Ψ§ΩΩ
ΨΨͺΩΩ Ψ§ΩΨ°Ω ΨͺΨΨͺΨ§Ψ¬ ΩΨͺΨ±Ψ¬Ω
ΨͺΩ ΩΩΩ
ΩΩΨΉ Ψ§ΩΨ¬Ψ―ΩΨ―. ΩΨ¬Ψ¨ Ψ§ΨΨͺΩΨ§Ψ± Ψ§ΩΩ
ΨΨͺΩΩ Ψ§ΩΨ£Ψ³Ψ§Ψ³Ω Ψ§ΩΩ
ΩΨΆΩ ΩΩΨͺΨ±Ψ¬Ω
Ψ©. ΨΆΨΉ ΩΩ Ψ§ΨΉΨͺΨ¨Ψ§Ψ±Ω Ψ§ΩΨͺΨΩΩΩΨ§Ψͺ ΩΨ§ΩΨ΅ΩΨΨ§Ψͺ ΩΨ§ΩΩ
ΩΨ΄ΩΨ±Ψ§Ψͺ Ψ§ΩΨ΄Ψ§Ψ¦ΨΉΨ© ΩΨͺΨ―ΩΩ Ψ§ΩΩ
Ψ³ΨͺΨΨ―Ω
ΩΩ Ψ§ΩΨΨ§ΩΩΩΩ ΩΨ§ΩΩ
Ψ³ΨͺΩΨ¨ΩΩΩΩ Ψ₯ΩΩ Ω
ΩΩΨΉΩ. ΨΉΩΨ― Ψ§ΩΨ΄ΩΨ Ψ£ΨΉΨ· Ψ§ΩΨ£ΩΩΩΩΨ© ΩΩΨ΅ΩΨΨ§Ψͺ ΨΉΩΩ Ω
ΩΨ΄ΩΨ±Ψ§Ψͺ Ψ§ΩΩ
Ψ―ΩΩΨ© Ψ§ΩΩΨ―ΩΩ
Ψ©. Ψ₯Ψ°Ψ§ ΩΨ§Ω Ψ°ΩΩ ΩΨΉΩΩ Ψ₯Ψ·ΩΨ§Ω ΩΨΊΨ© Ψ¬Ψ―ΩΨ―Ψ© ΩΩ ΩΩΨͺ Ψ£ΩΨ±Ψ¨Ψ ΩΩΨ― ΨͺΨͺΨ·ΩΨ¨ Ψ§ΩΩ
ΩΨ΄ΩΨ±Ψ§Ψͺ Ψ§ΩΩΨ―ΩΩ
Ψ© Ψ¬ΩΨ―ΩΨ§ Ψ£ΩΨ«Ψ± Ω
Ω
Ψ§ ΨͺΨ³ΨͺΨΩ ΩΩΨͺΨ±Ψ¬Ω
Ψ©.
Ψ«Ψ§ΩΩΩΨ§Ψ ΩΨ¬Ψ¨ ΨΉΩΩΩ (Ψ£Ω ΩΩΩΨ΅Ω Ψ¨Ψ΄Ψ―Ψ©) ΨͺΩΩΩΨ± ΨͺΨΊΨ·ΩΨ© 100% ΩΩΩ
ΨΨͺΩΩ Ψ§ΩΨΊΩΩ ΨΉΨ¨Ψ± Ω
ΩΩΨΉΩ. ΩΨ°Ω Ψ³ΩΨ§Ψ³Ω Ψ΅ΨΊΩΨ±Ψ© Ω
ΨΆΩ
ΩΨ© Ψ¨Ψ·Ψ±Ω Ψ£ΩΨ«Ψ± ΨͺΨΉΩΩΨ―ΩΨ§. ΩΩΨ§Ω Ψ·Ψ±Ω Ω
ΨͺΨΉΨ―Ψ―Ψ© ΩΩΨͺΩΨ±Ψ§Ψ± ΨΉΩΩ Ψ§ΩΩ
ΨΨͺΩΩ Ψ§ΩΨΊΩΩ. ΨͺΨ°ΩΨ±Ψ ΩΨ¬Ψ¨ ΨΉΩΩΩ Ψ―ΨΉΩ
Ψ¬Ω
ΩΨΉ Ψ§ΩΨ³ΩΨ§Ψ³Ω Ψ§ΩΨ΅ΨΊΩΨ±Ψ© Ψ¨Ψ¬Ω
ΩΨΉ Ψ§ΩΩΨΊΨ§Ψͺ ΩΩ Ψ§ΩΩ
ΨΨͺΩΩ Ψ§ΩΨΊΩΩ Ψ§ΩΨΨ§Ψ΅ Ψ¨Ω.
#### Ψ§ΩΩ
ΨΨͺΩΩ Ω
ΨͺΨΉΨ―Ψ― Ψ§ΩΩΨΊΨ§Ψͺ
ΩΨ£ΨͺΩ Ω
ΨΨͺΩΩ Ψ§ΩΩ
ΩΩΨΉ ΩΩ ΩΩΨΉΩΩ: **Ψ£Ψ³Ψ§Ψ³Ω** Ω**ΨΊΩΩ**.
Ψ§ΩΩ
ΨΨͺΩΩ Ψ§ΩΨ£Ψ³Ψ§Ψ³Ω ΩΩ Ψ§ΩΩΨ΅ Ψ§ΩΨΉΨ§Ψ―Ω ΩΩ
ΩΨ΄ΩΨ±Ψ§Ψͺ Ψ§ΩΩ
Ψ―ΩΩΨ© ΩΨ§ΩΨ΅ΩΨΨ§Ψͺ ΩΨ§ΩΩ
ΨΨͺΩΩ ΨΊΩΨ± Ψ§ΩΨͺΩΨ§ΨΉΩΩ. ΩΩΨ± ΩΩ Ψ§ΩΨ΅ΩΨΨ§Ψͺ ΩΨ§ΩΩ
ΩΨ΄ΩΨ±Ψ§Ψͺ. Ψ§ΩΩ
ΨΨͺΩΩ Ψ§ΩΨ£Ψ³Ψ§Ψ³Ω ΩΩ ΩΩΩΨ― ΩΩΨ±Ψ§Ψͺ Ω
ΩΩΨΉΩ. ΩΩΩΨ± Polyglot Ψ―ΨΉΩ
Ψ§ΨΨͺΩΨ§Ψ·Ω ΩΩΩ
ΨΨͺΩΩ Ψ§ΩΨ£Ψ³Ψ§Ψ³Ω.
Ψ§ΩΩ
ΨΨͺΩΩ Ψ§ΩΨΊΩΩ ΨͺΩΨ§ΨΉΩΩ ΩΩΨ§ΩΨͺ ΩΩ
ΩΩΩ Ω
Ω Ψ³ΩΨ§Ψ³Ω Ψ£ΩΨ΅Ψ±. ΩΩΨ± ΩΩ Ψ£Ψ΄Ψ±Ψ·Ψ© Ψ§ΩΨͺΩΩΩ ΩΨ§ΩΩΩΨ§Ψ¦Ω
Ψ§ΩΩ
ΩΨ³Ψ―ΩΨ©. Ψ§ΩΩ
ΨΨͺΩΩ Ψ§ΩΨΊΩΩ Ψ£ΩΨ«Ψ± ΨͺΩΩΩΨ© ΩΩΨ¨ΩΩ Ψ²ΩΨ§Ψ±Ω ΨΉΩΩ Ψ§ΩΩ
ΩΩΨΉ. _ΩΨ§ ΩΩΨ¬Ψ― Ψ―ΨΉΩ
Ψ§ΨΨͺΩΨ§Ψ·Ω ΩΩΩ
ΨΨͺΩΩ Ψ§ΩΨΊΩΩ Ψ§ΩΩ
ΩΩΩΨ―._
#### Ψ£Ψ―ΩΨ§Ψͺ Liquid
Ψ£Ψ―ΩΨ§Ψͺ Liquid Ψ§ΩΨͺΨ§ΩΩΨ© Ω
ΨͺΨ§ΨΨ© ΩΩΨ§Ψ³ΨͺΨΨ―Ψ§Ω
Ω
ΨΉ jekyll-polyglot:
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages` ΩΨ΄ΩΨ± Ω
Ψ¨Ψ§Ψ΄Ψ±Ψ© Ψ₯ΩΩ Ω
Ψ΅ΩΩΩΨ© `languages` ΩΩ _config.yml. ΩΩ
ΩΩ Ψ§ΩΩΨ΅ΩΩ Ψ₯ΩΩΩ ΨΉΨ¨Ψ± Liquid.
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang` ΩΨ΄ΩΨ± Ω
Ψ¨Ψ§Ψ΄Ψ±Ψ© Ψ₯ΩΩ Ψ³ΩΨ³ΩΨ© `default_lang` ΩΩ _config.yml. ΩΩ
ΩΩ Ψ§ΩΩΨ΅ΩΩ Ψ₯ΩΩΩ ΨΉΨ¨Ψ± Liquid.
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang` ΩΩ Ψ±Ω
Ψ² Ψ§ΩΩ
ΩΨ·ΩΨ© Ψ§ΩΨ°Ω ΩΨͺΩ
Ψ¨ΩΨ§Ψ‘ Ψ§ΩΨ΅ΩΨΨ© ΩΩ. ΩΨ°Ψ§ `"de"` ΩΩΩΨ³ΨΨ© Ψ§ΩΨ£ΩΩ
Ψ§ΩΩΨ© Ω
Ω Ψ§ΩΨ΅ΩΨΨ©Ψ `"es"` ΩΩΩΨ³ΨΨ© Ψ§ΩΨ₯Ψ³Ψ¨Ψ§ΩΩΨ©Ψ ΩΩΩΨ°Ψ§. ΩΩ
ΩΩ Ψ§ΩΩΨ΅ΩΩ Ψ₯ΩΩΩ ΨΉΨ¨Ψ± Liquid.
Ψ¨Ψ§Ψ³ΨͺΨΨ―Ψ§Ω
ΩΨ°Ω Ψ§ΩΨ£Ψ―ΩΨ§ΨͺΨ ΩΩ
ΩΩΩ ΨͺΨΨ―ΩΨ― ΩΩΩΩΨ© Ψ₯Ψ±ΩΨ§Ω Ψ§ΩΩ
ΨΨͺΩΩ Ψ§ΩΨΊΩΩ Ψ§ΩΨ΅ΨΩΨ.
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
Ψ§ΩΩ
ΨͺΨΊΩΨ± `page.rendered_lang` ΩΨ΄ΩΨ± Ψ₯ΩΩ Ψ§ΩΩΨΊΨ© Ψ§ΩΩΨΉΩΩΨ© ΩΩ
ΨΨͺΩΩ Ψ§ΩΨ΅ΩΨΨ©Ψ Ω
Ω
Ψ§ ΩΨ³Ω
Ψ ΩΩΩΩΨ§ΩΨ¨ Ψ¨Ψ§ΩΨͺΨ΄Ψ§Ω Ω
ΨͺΩ ΩΨͺΩ
ΨͺΩΨ―ΩΩ
Ψ§ΩΨ΅ΩΨΨ© ΩΩ
ΨΨͺΩΩ Ψ§ΨΨͺΩΨ§Ψ·Ω.
### Ψ―ΨΉΩ
Github Pages
Ψ¨Ψ΄ΩΩ Ψ§ΩΨͺΨ±Ψ§ΨΆΩΨ ΩΩ
ΩΨΉ Github [Ω
Ψ―ΩΩΨ§Ψͺ Jekyll Ω
Ω Ψ§Ψ³ΨͺΨΨ―Ψ§Ω
Ψ§ΩΨ₯ΨΆΨ§ΩΨ§Ψͺ](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides). ΩΨͺΩ
Ψ°ΩΩ ΨΉΩ
Ψ―ΩΨ§ ΩΩ
ΩΨΉ ΨͺΨ΄ΨΊΩΩ Ψ§ΩΨͺΨΉΩΩΩ
Ψ§Ψͺ Ψ§ΩΨ¨Ψ±Ω
Ψ¬ΩΨ© Ψ§ΩΨΆΨ§Ψ±Ψ© ΨΉΩΩ ΨΩΨ§Ψ―Ω
Github. ΨΉΩΩ Ψ§ΩΨ±ΨΊΩ
Ω
Ω Ψ£Ω ΩΨ°Ψ§ ΩΨ¬ΨΉΩ Ψ§Ψ³ΨͺΨΨ―Ψ§Ω
Polyglot (ΩΨ₯ΨΆΨ§ΩΨ§Ψͺ Jekyll Ψ§ΩΨ£ΨΨ±Ω) Ψ£Ψ΅ΨΉΨ¨Ψ Ψ₯ΩΨ§ Ψ£ΩΩ ΩΨ§ ΩΨ²Ψ§Ω Ω
Ω
ΩΩΩΨ§.
#### Ψ¨ΩΨ§Ψ‘ `_site/` Ψ₯ΩΩ gh-pages
Ψ¨Ψ―ΩΨ§Ω Ω
Ω Ψ§Ψ³ΨͺΨΆΨ§ΩΨ© Ω
ΨΨ±Ω Ω
Ψ―ΩΩΨ© Jekyll ΨΉΩΩ GithubΨ ΩΩ
ΩΩΩ ΨͺΨ·ΩΩΨ± Ω
ΩΩΨΉ Jekyll Ψ§ΩΨΨ§Ψ΅ Ψ¨Ω ΨΉΩΩ ΩΨ±ΨΉ Ω
ΩΩΨ΅ΩΨ Ψ«Ω
Ψ―ΩΨΉ Ω
ΨΨͺΩΩΨ§Ψͺ `_site/` Ψ§ΩΩ
Ψ¨ΩΩΨ© Ψ₯ΩΩ ΩΨ±ΨΉ `gh-pages` Ψ§ΩΨΨ§Ψ΅ Ψ¨Ω. ΩΨͺΩΨ ΩΩ ΩΨ°Ψ§ Ψ₯Ψ―Ψ§Ψ±Ψ© ΩΨ§ΩΨͺΨΩΩ
ΩΩ Ψ₯Ψ΅Ψ―Ψ§Ψ±Ψ§Ψͺ ΨͺΨ·ΩΩΨ± Ω
ΩΩΨΉΩ Ω
ΨΉ Github *Ψ―ΩΩ Ψ§ΩΨ§ΨΉΨͺΩ
Ψ§Ψ― ΨΉΩΩ Github ΩΨ¨ΩΨ§Ψ‘ Ω
ΩΩΨΉΩ!*
ΩΩ
ΩΩΩ Ψ§ΩΩΩΨ§Ω
Ψ¨Ψ°ΩΩ ΨΉΩ Ψ·Ψ±ΩΩ Ψ§ΩΨΩΨ§ΨΈ ΨΉΩΩ Ω
ΨΨͺΩΩ Jekyll Ψ§ΩΨΨ§Ψ΅ Ψ¨Ω ΨΉΩΩ ΩΨ±ΨΉ Ω
ΩΩΨ΅ΩΨ ΩΨ§ΩΨ§ΩΨͺΨ²Ψ§Ω
ΩΩΨ· Ψ¨Ω
Ψ¬ΩΨ― `_site/` Ψ₯ΩΩ ΩΨ±ΨΉ gh-pages Ψ§ΩΨΨ§Ψ΅ Ψ¨Ω. ΩΨ£Ω ΩΨ°Ω Ω
Ψ¬Ψ±Ψ― Ψ΅ΩΨΨ§Ψͺ HTML Ψ«Ψ§Ψ¨ΨͺΨ© ΩΩ Ω
Ψ¬ΩΨ―Ψ§ΨͺΨ Ψ³ΩΨ³ΨͺΨΆΩΩΩΨ§ Github Ω
Ψ«Ω Ψ£Ω Ω
ΨΨͺΩΩ [gh-pages](https://pages.github.com/) Ψ’ΨΨ±.
#### Ψ£ΨͺΩ
ΨͺΨ© Ψ°ΩΩ!
ΨͺΩΨ³Ψ§ΨΉΨ― ΩΨ°Ω Ψ§ΩΨΉΩ
ΩΩΨ© Ψ¨Ψ΄ΩΩ ΩΨ¨ΩΨ± Ψ¨ΩΨ§Ψ³Ψ·Ψ© Ψ³ΩΨ±ΩΨ¨Ψͺ Ψ¨Ψ³ΩΨ· Ψ³ΩΨ¨ΩΩ Ω
ΩΩΨΉΩ ΩΩΩΨͺΨ²Ω
Ψ¨Ω
Ψ¬ΩΨ― `_site/` Ψ₯ΩΩ gh-pages Ψ§ΩΨΨ§Ψ΅ Ψ¨Ω. ΩΨ«ΩΨ± Ω
Ω Ψ§ΩΩΨ§Ψ³ ΩΨ―ΩΩΩ
ΩΨ§ΨΨ―. [ΩΩΨ§ ΩΨ§ΨΨ―](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/). [ΩΩΨ§ Ψ’ΨΨ±](https://gist.github.com/cobyism/4730490). ΩΩΨ§ [Ψ³ΩΨ±ΩΨ¨Ψͺ Ψ§ΩΩΨ΄Ψ± Ψ§ΩΨΨ§Ψ΅ Ψ¨Ω](https://github.com/untra/polyglot/blob/main/publi.sh):
```bash
#! /bin/sh
# ΨΊΩΩΨ± Ψ£Ψ³Ω
Ψ§Ψ‘ Ψ§ΩΩΨ±ΩΨΉ ΩΩΩΩΨ§ ΩΨ°ΩΩ
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.de.md 0000664 0000000 0000000 00000016465 15201735340 0020061 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Γber
permalink: about/
lang: de
---
Polyglot ist ein Open-Source-Internationalisierungs-Plugin fΓΌr Jekyll -Blogs. Polyglot ist einfach zu installieren und zu verwenden, und es skaliert mit den Sprachen, die Sie unterstΓΌtzen mΓΆchten. Es bietet Fallbacks fΓΌr fehlende Inhalte, automatische URL-Relativierung und leistungsfΓ€hige SEO-Rezepte . So kΓΆnnen Sie mehrsprachige Blogs erstellen und sich dabei auf den Inhalt konzentrieren anstatt auf nervige technische Details.
_`jekyll-polyglot` wird noch nicht nativ in github-actions unterstΓΌtzt_
### Installation
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### UnterstΓΌtzte Sprachen verwalten
In `_config.yml` verwalten die folgenden Eigenschaften, welche Sprachen von Ihrer Website unterstΓΌtzt werden. Sie kΓΆnnen UnterstΓΌtzung fΓΌr eine neue Sprache hinzufΓΌgen, indem Sie sie zu diesen Werten hinzufΓΌgen (siehe unten). Sprachen werden durch ihre offiziellen [Gebietsschema-Codes](https://developer.chrome.com/webstore/i18n) identifiziert.
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` Ein Array von Gebietsschema-Codes, die die unterstΓΌtzten Sprachen der Website identifizieren.
* `default_lang:` Standardsprache fΓΌr die Website.
* `exclude_from_localization:` Ordner und Verzeichnisse, die Teil der erstellten Website sind, aber nicht lokalisiert werden mΓΌssen. Dies dient hauptsΓ€chlich dazu, die Build-Zeiten zu verkΓΌrzen, und da Asset-Dateien wie Bilder und Schriftarten groΓe Teile der Website sind, wird sichergestellt, dass sie nicht unnΓΆtig "ΓΌbersetzt" oder in der Ausgabe dupliziert werden.
* `url` die URL Ihrer statischen Produktions-Website.
### Eine neue Sprache hinzufΓΌgen
Vorausgesetzt, Sie haben bereits eine funktionierende einsprachige Website, wird das HinzufΓΌgen einer neuen Sprache nicht trivial sein. _Um wirklich eine mehrsprachige Website zu erstellen, sollten Sie erwarten, dass Sie alle Ihre Inhalte in der neuen Sprache neu erstellen mΓΌssen._ Das mag wie ein groΓes Unterfangen erscheinen, aber betrachten Sie die Γbersetzung in Teilen. Inhalt ist KΓΆnig; es ist wichtiger, dass neue Seiten und BeitrΓ€ge aktualisierte Γbersetzungen erhalten. Die Erstellung einer mehrsprachigen Website ist nur schwierig, wenn Sie verlangen, dass sie von Anfang an perfekt ΓΌbersetzt ist.
Erstens sollten Sie (und Ihr Team, und auch Ihre Manager, falls vorhanden) besprechen und auswΓ€hlen, welche Inhalte Sie fΓΌr die neue Website ΓΌbersetzen mΓΌssen. Sie mΓΌssen Ihre bevorzugten grundlegenden Inhalte zur Γbersetzung auswΓ€hlen. BerΓΌcksichtigen Sie Analysen, beliebte Seiten und BlogbeitrΓ€ge sowie den Fluss aktueller und zukΓΌnftiger Benutzer zu Ihrer Website. Im Zweifelsfall priorisieren Sie Seiten ΓΌber Γ€ltere BlogbeitrΓ€ge. Wenn es bedeutet, eine neue Sprache frΓΌher zu starten, kann die Γbersetzung Γ€lterer BeitrΓ€ge mehr Aufwand sein, als sie wert sind.
Zweitens mΓΌssen Sie (oder sollten Sie dringend) eine 100%ige Abdeckung von Rich Content auf Ihrer Website bereitstellen. Dies sind kleine Zeichenketten, die auf komplexere Weise eingebettet sind. Es gibt mehrere MΓΆglichkeiten, Rich Content zu durchlaufen. Denken Sie daran, dass Sie alle kleinen Zeichenketten in allen Sprachen in Ihrem Rich Content unterstΓΌtzen mΓΌssen.
#### Mehrsprachige Inhalte
Website-Inhalte gibt es in zwei Varianten: **Basis** und **Rich**.
Basis-Inhalte sind der flache Text von BlogbeitrΓ€gen, Seiten und nicht-interaktiven Inhalten. Denken Sie an Seiten und BeitrΓ€ge. Basis-Inhalte sind der Treibstoff fΓΌr die Klicks auf Ihrer Website. Polyglot bietet Fallback-UnterstΓΌtzung fΓΌr Basis-Inhalte.
Rich Content ist interaktiv, auffΓ€llig und besteht aus kΓΌrzeren Zeichenketten. Denken Sie an Navigationsleisten und Dropdown-MenΓΌs. Rich Content ist technischer und hΓ€lt Ihre Besucher auf der Website. _Es gibt keine Fallback-UnterstΓΌtzung fΓΌr fehlenden Rich Content._
#### Liquid-Werkzeuge
Die folgenden Liquid-Werkzeuge sind fΓΌr die Verwendung mit jekyll-polyglot verfΓΌgbar:
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages` zeigt direkt auf das `languages`-Array in _config.yml. Es kann ΓΌber Liquid aufgerufen werden.
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang` zeigt direkt auf die `default_lang`-Zeichenkette in _config.yml. Es kann ΓΌber Liquid aufgerufen werden.
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang` ist der Gebietsschema-Code, fΓΌr den die Seite erstellt wird. Dies ist `"de"` fΓΌr die deutsche Version einer Seite, `"es"` fΓΌr die spanische Version usw. Es kann ΓΌber Liquid aufgerufen werden.
Mit diesen Werkzeugen kΓΆnnen Sie angeben, wie der richtige Rich Content angehΓ€ngt wird.
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
Die Variable `page.rendered_lang` gibt die tatsΓ€chliche Sprache des Seiteninhalts an und ermΓΆglicht es Templates zu erkennen, wenn eine Seite als Fallback-Inhalt bereitgestellt wird.
### Github Pages UnterstΓΌtzung
StandardmΓ€Γig verhindert Github, dass [Jekyll-Blogs Plugins verwenden](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides). Dies geschieht absichtlich, um zu verhindern, dass bΓΆsartiger Code auf Github-Servern ausgefΓΌhrt wird. Obwohl dies die Verwendung von Polyglot (und anderen Jekyll-Plugins) erschwert, ist es dennoch mΓΆglich.
#### `_site/` nach gh-pages erstellen
Anstatt Ihre Jekyll-Blogging-Engine auf Github zu hosten, kΓΆnnen Sie Ihre Jekyll-Website auf einem separaten Branch entwickeln und dann den erstellten `_site/`-Inhalt in Ihren `gh-pages`-Branch pushen. Dies ermΓΆglicht es Ihnen, Ihre Website-Entwicklung mit Github zu verwalten und zu versionieren, *ohne sich darauf verlassen zu mΓΌssen, dass Github Ihre Website erstellt!*
Sie kΓΆnnen dies tun, indem Sie Ihren Jekyll-Inhalt auf einem separaten Branch pflegen und nur den `_site/`-Ordner in Ihren gh-pages-Branch committen. Da dies nur statische HTML-Seiten in Ordnern sind, wird Github sie wie jeden anderen [gh-pages](https://pages.github.com/)-Inhalt hosten.
#### Automatisieren Sie es!
Dieser Prozess wird enorm durch ein einfaches Skript unterstΓΌtzt, das Ihre Website erstellt und den `_site/`-Ordner in Ihre gh-pages pusht. Viele Leute haben eines. [Hier ist eines](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/). [Hier ist ein anderes](https://gist.github.com/cobyism/4730490). Hier ist [mein VerΓΆffentlichungsskript](https://github.com/untra/polyglot/blob/main/publi.sh):
```bash
#! /bin/sh
# Γndern Sie die Branch-Namen entsprechend
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.en.md 0000664 0000000 0000000 00000014724 15201735340 0020067 0 ustar 00root root 0000000 0000000 ---
layout: page
title: About
permalink: about/
lang: en
---
Polyglot is an open source internationalization plugin for Jekyll blogs. Polyglot is easy to setup and use with any project, and it scales to the languages you want to support. With fallback support for missing content, automatic url relativization, and powerful SEO recipes , Polyglot allows any multi-language blog to focus on content without the cruftwork.
_`jekyll-polyglot` is not yet supported natively in github-actions_
### Install
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### Managing Supported Languages
in `_config.yml`, the following properties manage what languages are supported by your website. You can provide support for a new language by adding it these values (see below). Languages are identified by their official [locale codes](https://developer.chrome.com/webstore/i18n).
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` an array of locale codes identifying the languages supported by the website.
* `default_lang:` default language for the website.
* `exclude_from_localization:` folders and directories that are part of the built website, but don't need to be localized. This is primarily to cut back on build times, and because asset files like images and fonts are big parts of the website, ensures they are not needlessly "translated" or duplicated in the output.
* `url` the url of your production static website.
### Adding a new language
Assuming you already have a functional single-language website, adding a new language won't be trivial. _To truly make a multilingual website, you should expect to have to remake all of your content in the new language._ This may seem like a big undertaking, but consider the translation in parts. Content is king; it's more important new pages and posts get updated words in translation. Making a multi-language website is only hard if you require that it be perfectly translated from the start.
Firstly, you (and your team, and your managers too if you have a few of those lying around) should discuss and choose what content you need translated over into the new website. You must choose your preferred asic content to translate over. Consider analytics, popular pages and blogposts, and the flow of current and future users to your website. When in doubt, prioritize pages over legacy blogposts. If it means getting to launch a new language sooner, legacy posts may be more effort than they are worth translating.
Secondly, you must (or strongly ought to) provide 100% coverage of rich content through your site. These are small strings embeded in more complex ways. There are multiple ways to iterate over rich content. Remember, you must support all language small strings in your rich content.
#### Multilingual Content
Website Content comes in two flavors: **basic** and **rich**.
Basic content is the flat text of blogposts, pages, and non-interactive content. Think pages and posts. Basic content is the fuel for your websites clicks. Polyglot gives basic content fallback support.
Rich content is interactive, flashy, and composed of shorter strings. Think navbars and dropdowns. Rich content is more technical, and keeps your visitors on the site. _There is no fallback support for missing rich content._
#### Liquid Tools
The following liquid tools are available for use with jekyll-polyglot:
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages` points directly to the `languages` array in _config.yml . It can be accessed through liquid.
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang` points directly to the `default_lang` string in _config.yml . It can be accessed through liquid.
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang` is the locale code the page is being built for. This is `"de"` for the german version of a page, `"es"` for the spanish version, and so on. It can be accessed through liquid.
Using these tools, you can specify how to attach the correct rich content.
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
The `page.rendered_lang` variable that indicates the actual language of a page's content, Allowing templates to detect when a page is being served as fallback content.
### Github Pages Support
By default github prevents [jekyll blogs from using plugins](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides). This is done intentionally to prevent malicious code from being executed on github servers. Although this makes using Polyglot (and other jekyll plugins) harder to use, it's still doable.
#### Building `_site/` to gh-pages
Instead of hosting your Jekyll blogging engine on github, you can develop your jekyll website on a separate branch, and then push the built `_site/` contents to your `gh-pages` branch. This allows you to manage and source-control your website development with github *without having to rely on github to build your website!*
You can do this by maintaining your Jekyll content on a separate branch, and only committing the `_site/` folder to your gh-pages branch. Because these are just static html pages in folders, github will host them like any other [gh-pages](https://pages.github.com/) content.
#### Automate it!
This process is helped tremendously with a simple script that will build your website and commit the `_site/` folder to your gh-pages. A lot of people have one. [Here's one](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/). [Here's another](https://gist.github.com/cobyism/4730490). Here is [my publish script](https://github.com/untra/polyglot/blob/main/publi.sh):
```bash
#! /bin/sh
# change the branch names appropriately
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.es.md 0000664 0000000 0000000 00000016050 15201735340 0020066 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Sobre
permalink: about/
lang: es
---
Polyglot es un plugin de cΓ³digo abierto de internacionalizaciΓ³n para blogs Jekyll . Polyglot es fΓ‘cil de configurar y usar con cualquier proyecto, y escala a los idiomas que deseas soportar. Con soporte de respaldo para contenido faltante, relativizaciΓ³n automΓ‘tica de URL, y potentes recetas SEO , Polyglot permite a cualquier blog multilingΓΌe centrarse en el contenido sin el trabajo tedioso.
_`jekyll-polyglot` aΓΊn no es soportado nativamente en github-actions_
### InstalaciΓ³n
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### GestiΓ³n de idiomas soportados
En `_config.yml`, las siguientes propiedades gestionan quΓ© idiomas son soportados por tu sitio web. Puedes proporcionar soporte para un nuevo idioma agregΓ‘ndolo a estos valores (ver abajo). Los idiomas se identifican por sus [cΓ³digos de localizaciΓ³n](https://developer.chrome.com/webstore/i18n) oficiales.
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` un array de cΓ³digos de localizaciΓ³n que identifican los idiomas soportados por el sitio web.
* `default_lang:` idioma predeterminado para el sitio web.
* `exclude_from_localization:` carpetas y directorios que son parte del sitio web construido, pero no necesitan ser localizados. Esto es principalmente para reducir los tiempos de construcciΓ³n, y debido a que archivos de recursos como imΓ‘genes y fuentes son grandes partes del sitio web, asegura que no sean innecesariamente "traducidos" o duplicados en la salida.
* `url` la url de tu sitio web estΓ‘tico de producciΓ³n.
### Agregar un nuevo idioma
Asumiendo que ya tienes un sitio web funcional en un solo idioma, agregar un nuevo idioma no serΓ‘ trivial. _Para realmente crear un sitio web multilingΓΌe, debes esperar tener que recrear todo tu contenido en el nuevo idioma._ Esto puede parecer una gran tarea, pero considera la traducciΓ³n en partes. El contenido es rey; es mΓ‘s importante que las nuevas pΓ‘ginas y publicaciones obtengan traducciones actualizadas. Crear un sitio web multilingΓΌe solo es difΓcil si requieres que estΓ© perfectamente traducido desde el principio.
Primero, tΓΊ (y tu equipo, y tambiΓ©n tus gerentes si tienes algunos) deben discutir y elegir quΓ© contenido necesitan traducir para el nuevo sitio web. Debes elegir tu contenido bΓ‘sico preferido para traducir. Considera anΓ‘lisis, pΓ‘ginas y publicaciones populares, y el flujo de usuarios actuales y futuros a tu sitio web. En caso de duda, prioriza las pΓ‘ginas sobre las publicaciones de blog antiguas. Si significa lanzar un nuevo idioma antes, las publicaciones antiguas pueden requerir mΓ‘s esfuerzo del que valen para traducir.
Segundo, debes (o deberΓas fuertemente) proporcionar una cobertura del 100% del contenido rico en tu sitio. Estas son pequeΓ±as cadenas incrustadas de maneras mΓ‘s complejas. Hay mΓΊltiples formas de iterar sobre el contenido rico. Recuerda, debes soportar todas las pequeΓ±as cadenas en todos los idiomas en tu contenido rico.
#### Contenido multilingΓΌe
El contenido del sitio web viene en dos sabores: **bΓ‘sico** y **rico**.
El contenido bΓ‘sico es el texto plano de publicaciones de blog, pΓ‘ginas y contenido no interactivo. Piensa en pΓ‘ginas y publicaciones. El contenido bΓ‘sico es el combustible para los clics de tu sitio web. Polyglot proporciona soporte de respaldo para el contenido bΓ‘sico.
El contenido rico es interactivo, llamativo y compuesto de cadenas mΓ‘s cortas. Piensa en barras de navegaciΓ³n y menΓΊs desplegables. El contenido rico es mΓ‘s tΓ©cnico y mantiene a tus visitantes en el sitio. _No hay soporte de respaldo para el contenido rico faltante._
#### Herramientas Liquid
Las siguientes herramientas Liquid estΓ‘n disponibles para usar con jekyll-polyglot:
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages` apunta directamente al array `languages` en _config.yml. Se puede acceder a travΓ©s de Liquid.
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang` apunta directamente a la cadena `default_lang` en _config.yml. Se puede acceder a travΓ©s de Liquid.
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang` es el cΓ³digo de localizaciΓ³n para el que se estΓ‘ construyendo la pΓ‘gina. Esto es `"de"` para la versiΓ³n alemana de una pΓ‘gina, `"es"` para la versiΓ³n espaΓ±ola, y asΓ sucesivamente. Se puede acceder a travΓ©s de Liquid.
Usando estas herramientas, puedes especificar cΓ³mo adjuntar el contenido rico correcto.
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
La variable `page.rendered_lang` indica el idioma real del contenido de una pΓ‘gina, permitiendo que las plantillas detecten cuando una pΓ‘gina se estΓ‘ sirviendo como contenido de respaldo.
### Soporte de Github Pages
Por defecto, Github impide que los [blogs Jekyll usen plugins](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides). Esto se hace intencionalmente para evitar que cΓ³digo malicioso se ejecute en los servidores de Github. Aunque esto hace que usar Polyglot (y otros plugins de Jekyll) sea mΓ‘s difΓcil, todavΓa es posible.
#### Construir `_site/` a gh-pages
En lugar de alojar tu motor de blog Jekyll en Github, puedes desarrollar tu sitio web Jekyll en una rama separada, y luego empujar el contenido construido `_site/` a tu rama `gh-pages`. Esto te permite gestionar y controlar la versiΓ³n de tu desarrollo de sitio web con Github *Β‘sin tener que depender de Github para construir tu sitio web!*
Puedes hacer esto manteniendo tu contenido Jekyll en una rama separada, y solo haciendo commit de la carpeta `_site/` a tu rama gh-pages. Debido a que estas son solo pΓ‘ginas HTML estΓ‘ticas en carpetas, Github las alojarΓ‘ como cualquier otro contenido [gh-pages](https://pages.github.com/).
#### Β‘AutomatΓzalo!
Este proceso se ayuda enormemente con un simple script que construirΓ‘ tu sitio web y harΓ‘ commit de la carpeta `_site/` a tu gh-pages. Mucha gente tiene uno. [AquΓ hay uno](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/). [AquΓ hay otro](https://gist.github.com/cobyism/4730490). AquΓ estΓ‘ [mi script de publicaciΓ³n](https://github.com/untra/polyglot/blob/main/publi.sh):
```bash
#! /bin/sh
# cambia los nombres de las ramas apropiadamente
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.fr.md 0000664 0000000 0000000 00000016374 15201735340 0020077 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Γ propos
permalink: about/
lang: fr
---
Polyglot est un plugin open source d'internationalisation pour les blogs construits avec Jekyll. Polyglot est facile Γ installer et Γ utiliser pour tout projet, et il Γ©volue avec les langues que vous souhaitez supporter. Avec solution de repli pour le contenu manquant, relativisation automatique d'URL, et de puissantes recettes de SEO, Polyglot permet un blog multi-langue pour se concentrer sur le contenu uniquement.
_`jekyll-polyglot` n'est pas encore supportΓ© nativement dans github-actions_
### Installation
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### Gestion des langues supportΓ©es
Dans `_config.yml`, les propriétés suivantes gèrent les langues supportées par votre site web. Vous pouvez ajouter le support d'une nouvelle langue en l'ajoutant à ces valeurs (voir ci-dessous). Les langues sont identifiées par leurs [codes de locale](https://developer.chrome.com/webstore/i18n) officiels.
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` un tableau de codes de locale identifiant les langues supportΓ©es par le site web.
* `default_lang:` langue par dΓ©faut du site web.
* `exclude_from_localization:` dossiers et rΓ©pertoires qui font partie du site web construit, mais qui n'ont pas besoin d'Γͺtre localisΓ©s. Ceci est principalement pour rΓ©duire les temps de construction, et parce que les fichiers d'assets comme les images et les polices sont de grandes parties du site web, cela garantit qu'ils ne sont pas inutilement "traduits" ou dupliquΓ©s dans la sortie.
* `url` l'url de votre site web statique de production.
### Ajouter une nouvelle langue
En supposant que vous avez déjà un site web fonctionnel monolingue, ajouter une nouvelle langue ne sera pas trivial. _Pour vraiment créer un site web multilingue, vous devez vous attendre à devoir recréer tout votre contenu dans la nouvelle langue._ Cela peut sembler une grande entreprise, mais considérez la traduction par parties. Le contenu est roi; il est plus important que les nouvelles pages et articles reçoivent des traductions mises à jour. Créer un site web multilingue n'est difficile que si vous exigez qu'il soit parfaitement traduit dès le départ.
Premièrement, vous (et votre équipe, et vos managers aussi si vous en avez quelques-uns) devriez discuter et choisir quel contenu vous devez traduire pour le nouveau site web. Vous devez choisir votre contenu de base préféré à traduire. Considérez les analytics, les pages et articles populaires, et le flux des utilisateurs actuels et futurs vers votre site web. En cas de doute, priorisez les pages plutôt que les anciens articles de blog. Si cela signifie lancer une nouvelle langue plus tôt, les anciens articles peuvent demander plus d'efforts qu'ils n'en valent la peine pour la traduction.
DeuxiΓ¨mement, vous devez (ou devriez fortement) fournir une couverture Γ 100% du contenu riche Γ travers votre site. Ce sont de petites chaΓnes intΓ©grΓ©es de maniΓ¨res plus complexes. Il existe plusieurs faΓ§ons d'itΓ©rer sur le contenu riche. N'oubliez pas que vous devez supporter toutes les petites chaΓnes dans toutes les langues dans votre contenu riche.
#### Contenu multilingue
Le contenu du site web existe en deux variΓ©tΓ©s: **basique** et **riche**.
Le contenu basique est le texte plat des articles de blog, des pages et du contenu non interactif. Pensez aux pages et aux articles. Le contenu basique est le carburant pour les clics sur votre site web. Polyglot offre un support de repli pour le contenu basique.
Le contenu riche est interactif, flashy et composΓ© de chaΓnes plus courtes. Pensez aux barres de navigation et aux menus dΓ©roulants. Le contenu riche est plus technique et garde vos visiteurs sur le site. _Il n'y a pas de support de repli pour le contenu riche manquant._
#### Outils Liquid
Les outils Liquid suivants sont disponibles pour utilisation avec jekyll-polyglot:
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages` pointe directement vers le tableau `languages` dans _config.yml. Il peut Γͺtre accΓ©dΓ© via Liquid.
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang` pointe directement vers la chaΓne `default_lang` dans _config.yml. Il peut Γͺtre accΓ©dΓ© via Liquid.
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang` est le code de locale pour lequel la page est construite. C'est `"de"` pour la version allemande d'une page, `"es"` pour la version espagnole, et ainsi de suite. Il peut Γͺtre accΓ©dΓ© via Liquid.
En utilisant ces outils, vous pouvez spΓ©cifier comment attacher le bon contenu riche.
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
La variable `page.rendered_lang` indique la langue rΓ©elle du contenu d'une page, permettant aux templates de dΓ©tecter quand une page est servie comme contenu de repli.
### Support Github Pages
Par dΓ©faut, Github empΓͺche les [blogs Jekyll d'utiliser des plugins](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides). Ceci est fait intentionnellement pour empΓͺcher l'exΓ©cution de code malveillant sur les serveurs Github. Bien que cela rende l'utilisation de Polyglot (et d'autres plugins Jekyll) plus difficile, c'est toujours faisable.
#### Construire `_site/` vers gh-pages
Au lieu d'hΓ©berger votre moteur de blog Jekyll sur Github, vous pouvez dΓ©velopper votre site web Jekyll sur une branche sΓ©parΓ©e, puis pousser le contenu construit `_site/` vers votre branche `gh-pages`. Cela vous permet de gΓ©rer et de contrΓ΄ler la version de votre dΓ©veloppement de site web avec Github *sans avoir Γ compter sur Github pour construire votre site web!*
Vous pouvez faire cela en maintenant votre contenu Jekyll sur une branche sΓ©parΓ©e, et en ne committant que le dossier `_site/` vers votre branche gh-pages. Parce que ce sont juste des pages HTML statiques dans des dossiers, Github les hΓ©bergera comme tout autre contenu [gh-pages](https://pages.github.com/).
#### Automatisez-le!
Ce processus est grandement facilitΓ© par un simple script qui construira votre site web et committera le dossier `_site/` vers votre gh-pages. Beaucoup de gens en ont un. [En voici un](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/). [En voici un autre](https://gist.github.com/cobyism/4730490). Voici [mon script de publication](https://github.com/untra/polyglot/blob/main/publi.sh):
```bash
#! /bin/sh
# changez les noms des branches en consΓ©quence
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.he.md 0000664 0000000 0000000 00000017471 15201735340 0020063 0 ustar 00root root 0000000 0000000 ---
layout: page
title: ΧΧΧΧΧͺ
permalink: about/
lang: he
---
Polyglot ΧΧΧ ΧͺΧΧ‘Χ£ Χ§ΧΧ Χ€ΧͺΧΧ ΧΧΧΧ ΧΧΧ Χ’ΧΧΧ¨ ΧΧΧΧΧΧ Χ©Χ Jekyll . Polyglot Χ§Χ ΧΧΧͺΧ§Χ Χ ΧΧΧ©ΧΧΧΧ© ΧΧΧ Χ€Χ¨ΧΧΧ§Χ, ΧΧΧΧ ΧΧͺΧ¨ΧΧ ΧΧ©Χ€ΧΧͺ Χ©ΧͺΧ¨Χ¦Χ ΧΧͺΧΧΧ ΧΧΧ. Χ’Χ ΧͺΧΧΧΧ ΧΧΧΧΧΧ ΧΧͺΧΧΧ ΧΧ‘Χ¨, ΧΧΧ‘ΧΧΧͺ ΧΧΧΧΧΧΧΧͺ Χ©Χ ΧΧͺΧΧΧΧͺ URL, ΧΧΧͺΧΧΧ Χ SEO Χ’ΧΧ¦ΧΧͺΧΧΧ , Polyglot ΧΧΧ€Χ©Χ¨ ΧΧΧ ΧΧΧΧ Χ¨Χ-ΧΧ©ΧΧ Χ ΧΧΧͺΧΧ§Χ ΧΧͺΧΧΧ ΧΧΧ Χ’ΧΧΧΧ ΧΧΧΧΧ’Χͺ.
_`jekyll-polyglot` Χ’ΧΧΧΧ ΧΧΧ Χ Χ ΧͺΧΧ ΧΧΧΧ€Χ ΧΧ§ΧΧ¨Χ Χ-github-actions_
### ΧΧͺΧ§Χ Χ
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### Χ ΧΧΧΧ Χ©Χ€ΧΧͺ Χ ΧͺΧΧΧΧͺ
ΧΧ§ΧΧΧ₯ `_config.yml`, ΧΧΧΧ€ΧΧΧ ΧΧ ΧΧΧΧΧ ΧΧ ΧΧΧΧ ΧΧΧΧ Χ©Χ€ΧΧͺ Χ ΧͺΧΧΧΧͺ ΧΧΧͺΧ¨ Χ©ΧΧΧ. ΧͺΧΧΧΧ ΧΧΧΧ‘ΧΧ£ ΧͺΧΧΧΧ ΧΧ©Χ€Χ ΧΧΧ©Χ Χ’Χ ΧΧΧ ΧΧΧ‘Χ€ΧͺΧ ΧΧ’Χ¨ΧΧΧ ΧΧΧ (Χ¨ΧΧ ΧΧΧΧ). Χ©Χ€ΧΧͺ ΧΧΧΧΧΧͺ ΧΧ€Χ [Χ§ΧΧΧ ΧΧΧ§ΧΧ](https://developer.chrome.com/webstore/i18n) ΧΧ¨Χ©ΧΧΧΧ Χ©ΧΧΧ.
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` ΧΧ’Χ¨Χ Χ©Χ Χ§ΧΧΧ ΧΧ§ΧΧ ΧΧΧΧΧΧ ΧΧͺ ΧΧ©Χ€ΧΧͺ ΧΧ ΧͺΧΧΧΧͺ ΧΧΧͺΧ¨.
* `default_lang:` Χ©Χ€Χͺ ΧΧ¨ΧΧ¨Χͺ ΧΧΧΧΧ Χ©Χ ΧΧΧͺΧ¨.
* `exclude_from_localization:` ΧͺΧΧ§ΧΧΧͺ ΧΧ‘Χ€Χ¨ΧΧΧͺ Χ©ΧΧ ΧΧΧ§ ΧΧΧΧͺΧ¨ ΧΧΧ ΧΧ, ΧΧ ΧΧΧ Χ Χ¦Χ¨ΧΧΧΧͺ ΧΧΧΧΧͺ ΧΧͺΧΧ¨ΧΧΧΧͺ. ΧΧ ΧΧ’ΧΧ§Χ¨ ΧΧΧ ΧΧ§Χ¦Χ¨ ΧΧΧ Χ ΧΧ ΧΧΧ, ΧΧΧΧΧΧΧ Χ©Χ§ΧΧ¦Χ Χ ΧΧ‘ΧΧ ΧΧΧ ΧͺΧΧΧ ΧΧͺ ΧΧΧΧ€Χ ΧΧ ΧΧ ΧΧΧ§ΧΧ ΧΧΧΧΧΧ ΧΧΧΧͺΧ¨, ΧΧΧΧΧ Χ©ΧΧ "ΧΧͺΧΧ¨ΧΧΧ" ΧΧ ΧΧ©ΧΧΧ€ΧΧ Χ©ΧΧ ΧΧ¦ΧΧ¨Χ ΧΧ€ΧΧ.
* `url` ΧΧͺΧΧΧͺ Χ-URL Χ©Χ ΧΧͺΧ¨ ΧΧΧΧ¦ΧΧ¨ ΧΧ‘ΧΧΧ Χ©ΧΧ.
### ΧΧΧ‘Χ€Χͺ Χ©Χ€Χ ΧΧΧ©Χ
ΧΧΧ ΧΧ Χ©ΧΧΧ¨ ΧΧ© ΧΧΧ ΧΧͺΧ¨ Χ€ΧΧ Χ§Χ¦ΧΧΧ ΧΧ ΧΧ©Χ€Χ ΧΧΧͺ, ΧΧΧ‘Χ€Χͺ Χ©Χ€Χ ΧΧΧ©Χ ΧΧ ΧͺΧΧΧ ΧΧ¨ΧΧΧΧΧΧΧΧͺ. _ΧΧΧ ΧΧΧ¦ΧΧ¨ ΧΧΧΧͺ ΧΧͺΧ¨ Χ¨Χ-ΧΧ©ΧΧ Χ, Χ’ΧΧΧΧ ΧΧ¦Χ€ΧΧͺ Χ©ΧͺΧ¦ΧΧ¨ΧΧ ΧΧΧ¦ΧΧ¨ ΧΧΧΧ© ΧΧͺ ΧΧ ΧΧͺΧΧΧ Χ©ΧΧΧ ΧΧ©Χ€Χ ΧΧΧΧ©Χ._ ΧΧ ΧΧΧΧ Χ Χ¨ΧΧ ΧΧΧ©ΧΧΧ ΧΧΧΧΧ, ΧΧΧ Χ©Χ§ΧΧ ΧΧͺ ΧΧͺΧ¨ΧΧΧ ΧΧΧΧ§ΧΧ. ΧͺΧΧΧ ΧΧΧ ΧΧΧΧ; ΧΧ©ΧΧ ΧΧΧͺΧ¨ Χ©ΧΧ€ΧΧ ΧΧ€ΧΧ‘ΧΧΧ ΧΧΧ©ΧΧ ΧΧ§ΧΧΧ ΧΧΧΧΧ ΧΧͺΧΧ¨ΧΧΧΧͺ. ΧΧ¦ΧΧ¨Χͺ ΧΧͺΧ¨ Χ¨Χ-ΧΧ©ΧΧ Χ Χ§Χ©Χ Χ¨Χ§ ΧΧ ΧΧͺΧ ΧΧΧ¨Χ©ΧΧ Χ©ΧΧΧΧ ΧΧͺΧΧ¨ΧΧ ΧΧ¦ΧΧ¨Χ ΧΧΧ©ΧΧΧͺ ΧΧΧΧͺΧΧΧ.
Χ¨ΧΧ©ΧΧͺ, ΧΧͺΧ (ΧΧΧ¦ΧΧΧͺ Χ©ΧΧΧ, ΧΧΧ ΧΧΧ ΧΧΧΧ Χ©ΧΧΧ ΧΧ ΧΧ© ΧΧΧ ΧΧΧ ΧΧΧΧ) Χ¦Χ¨ΧΧΧΧ ΧΧΧΧ ΧΧΧΧΧΧ¨ ΧΧΧΧ ΧͺΧΧΧ ΧΧͺΧ Χ¦Χ¨ΧΧΧΧ ΧΧͺΧ¨ΧΧ ΧΧΧͺΧ¨ ΧΧΧΧ©. Χ’ΧΧΧΧ ΧΧΧΧΧ¨ ΧΧͺ ΧΧͺΧΧΧ ΧΧΧ‘ΧΧ‘Χ ΧΧΧΧ’ΧΧ£ ΧΧͺΧ¨ΧΧΧ. Χ©Χ§ΧΧ ΧΧ ΧΧΧΧΧ§Χ‘, ΧΧ€ΧΧ ΧΧ€ΧΧ‘ΧΧΧ Χ€ΧΧ€ΧΧΧ¨ΧΧΧ, ΧΧΧ¨ΧΧΧͺ ΧΧΧ©ΧͺΧΧ©ΧΧ ΧΧ ΧΧΧΧΧΧ ΧΧΧ’ΧͺΧΧΧΧΧ ΧΧΧͺΧ¨ Χ©ΧΧΧ. ΧΧΧ©Χ¨ ΧΧ© Χ‘Χ€Χ§, ΧͺΧ’ΧΧΧ€Χ ΧΧ€ΧΧ Χ’Χ Χ€Χ Χ Χ€ΧΧ‘ΧΧΧ ΧΧ©Χ ΧΧ. ΧΧ ΧΧ ΧΧΧΧ¨ ΧΧΧ©ΧΧ§ Χ©Χ€Χ ΧΧΧ©Χ ΧΧΧ§ΧΧ ΧΧΧͺΧ¨, Χ€ΧΧ‘ΧΧΧ ΧΧ©Χ ΧΧ Χ’Χ©ΧΧΧΧ ΧΧΧ¨ΧΧ© ΧΧΧͺΧ¨ ΧΧΧΧ₯ ΧΧΧ Χ©ΧΧ Χ©ΧΧΧΧ ΧΧͺΧ¨ΧΧΧ.
Χ©Χ ΧΧͺ, Χ’ΧΧΧΧ (ΧΧ ΧΧΧΧΧ₯ ΧΧΧΧ) ΧΧ‘Χ€Χ§ ΧΧΧ‘ΧΧ Χ©Χ 100% ΧΧͺΧΧΧ Χ’Χ©ΧΧ¨ ΧΧ¨ΧΧΧ ΧΧΧͺΧ¨. ΧΧΧ ΧΧΧ¨ΧΧΧΧͺ Χ§ΧΧ ΧΧͺ ΧΧΧΧΧΧ’ΧΧͺ ΧΧΧ¨ΧΧΧ ΧΧΧ¨ΧΧΧΧͺ ΧΧΧͺΧ¨. ΧΧ©Χ Χ ΧΧ‘Χ€Χ¨ ΧΧ¨ΧΧΧ ΧΧ’ΧΧΧ¨ Χ’Χ ΧͺΧΧΧ Χ’Χ©ΧΧ¨. ΧΧΧ¨Χ, Χ’ΧΧΧΧ ΧΧͺΧΧΧ ΧΧΧ ΧΧΧΧ¨ΧΧΧΧͺ ΧΧ§ΧΧ ΧΧͺ ΧΧΧ ΧΧ©Χ€ΧΧͺ ΧΧͺΧΧΧ ΧΧ’Χ©ΧΧ¨ Χ©ΧΧΧ.
#### ΧͺΧΧΧ Χ¨Χ-ΧΧ©ΧΧ Χ
ΧͺΧΧΧ ΧΧΧͺΧ¨ ΧΧΧΧ’ ΧΧ©Χ Χ ΧΧ’ΧΧΧ: **ΧΧ‘ΧΧ‘Χ** Χ**Χ’Χ©ΧΧ¨**.
ΧͺΧΧΧ ΧΧ‘ΧΧ‘Χ ΧΧΧ ΧΧΧ§Χ‘Χ ΧΧ©ΧΧΧ Χ©Χ Χ€ΧΧ‘ΧΧΧ, ΧΧ€ΧΧ ΧΧͺΧΧΧ ΧΧ ΧΧΧ ΧΧ¨ΧΧ§ΧΧΧΧ. ΧΧ©ΧΧ Χ’Χ ΧΧ€ΧΧ ΧΧ€ΧΧ‘ΧΧΧ. ΧͺΧΧΧ ΧΧ‘ΧΧ‘Χ ΧΧΧ ΧΧΧΧ§ ΧΧΧΧΧ¦ΧΧͺ ΧΧΧͺΧ¨ Χ©ΧΧΧ. Polyglot Χ ΧΧͺΧ ΧΧͺΧΧΧ ΧΧ‘ΧΧ‘Χ ΧͺΧΧΧΧ ΧΧΧΧΧΧ.
ΧͺΧΧΧ Χ’Χ©ΧΧ¨ ΧΧΧ ΧΧΧ ΧΧ¨ΧΧ§ΧΧΧΧ, ΧΧ¨Χ©ΧΧ ΧΧΧΧ¨ΧΧ ΧΧΧΧ¨ΧΧΧΧͺ Χ§Χ¦Χ¨ΧΧͺ ΧΧΧͺΧ¨. ΧΧ©ΧΧ Χ’Χ Χ‘Χ¨ΧΧΧ Χ ΧΧΧΧ ΧΧͺΧ€Χ¨ΧΧΧΧ Χ Χ€ΧͺΧΧΧ. ΧͺΧΧΧ Χ’Χ©ΧΧ¨ ΧΧΧ ΧΧΧͺΧ¨ ΧΧΧ Χ, ΧΧ©ΧΧΧ¨ ΧΧͺ ΧΧΧΧ§Χ¨ΧΧ Χ©ΧΧΧ ΧΧΧͺΧ¨. _ΧΧΧ ΧͺΧΧΧΧ ΧΧΧΧΧΧ ΧΧͺΧΧΧ Χ’Χ©ΧΧ¨ ΧΧ‘Χ¨._
#### ΧΧΧ Liquid
ΧΧΧ Χ-Liquid ΧΧΧΧΧ ΧΧΧΧ ΧΧ ΧΧ©ΧΧΧΧ© Χ’Χ jekyll-polyglot:
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages` ΧΧ¦ΧΧΧ’ ΧΧ©ΧΧ¨ΧΧͺ ΧΧΧ’Χ¨Χ `languages` Χ-_config.yml. Χ ΧΧͺΧ ΧΧΧ©Χͺ ΧΧΧΧ ΧΧ¨Χ Liquid.
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang` ΧΧ¦ΧΧΧ’ ΧΧ©ΧΧ¨ΧΧͺ ΧΧΧΧ¨ΧΧΧͺ `default_lang` Χ-_config.yml. Χ ΧΧͺΧ ΧΧΧ©Χͺ ΧΧΧΧ ΧΧ¨Χ Liquid.
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang` ΧΧΧ Χ§ΧΧ ΧΧΧ§ΧΧ Χ©ΧΧΧ£ Χ ΧΧ Χ Χ’ΧΧΧ¨Χ. ΧΧ `"de"` Χ’ΧΧΧ¨ ΧΧΧ¨Χ‘Χ ΧΧΧ¨ΧΧ ΧΧͺ Χ©Χ ΧΧ£, `"es"` Χ’ΧΧΧ¨ ΧΧΧ¨Χ‘Χ ΧΧ‘Χ€Χ¨ΧΧΧͺ, ΧΧΧ ΧΧΧΧ. Χ ΧΧͺΧ ΧΧΧ©Χͺ ΧΧΧΧ ΧΧ¨Χ Liquid.
ΧΧΧΧ¦Χ’ΧΧͺ ΧΧΧΧ ΧΧΧ, ΧͺΧΧΧΧ ΧΧ¦ΧΧΧ ΧΧΧ¦Χ ΧΧ¦Χ¨Χ£ ΧΧͺ ΧΧͺΧΧΧ ΧΧ’Χ©ΧΧ¨ ΧΧ ΧΧΧ.
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
ΧΧΧ©ΧͺΧ Χ `page.rendered_lang` ΧΧ¦ΧΧΧ ΧΧͺ ΧΧ©Χ€Χ ΧΧ€ΧΧ’Χ Χ©Χ ΧͺΧΧΧ ΧΧΧ£, ΧΧ Χ©ΧΧΧ€Χ©Χ¨ ΧΧͺΧΧ ΧΧΧͺ ΧΧΧΧΧͺ ΧΧͺΧ ΧΧ£ ΧΧΧΧ© ΧΧͺΧΧΧ ΧΧΧΧΧ.
### ΧͺΧΧΧΧ Χ-Github Pages
ΧΧΧ¨ΧΧ¨Χͺ ΧΧΧΧ, Github ΧΧΧ Χ’ Χ[ΧΧΧΧΧΧ Χ©Χ Jekyll ΧΧΧ©ΧͺΧΧ© ΧΧͺΧΧ‘Χ€ΧΧ](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides). ΧΧ Χ Χ’Χ©Χ ΧΧΧΧΧ Χ ΧΧΧ ΧΧΧ ΧΧ’ ΧΧ§ΧΧ ΧΧΧΧ Χ ΧΧ¨ΧΧ₯ Χ’Χ Χ©Χ¨ΧͺΧ Github. ΧΧΧ¨ΧΧͺ Χ©ΧΧ ΧΧ§Χ©Χ Χ’Χ ΧΧ©ΧΧΧΧ© Χ-Polyglot (ΧΧͺΧΧ‘Χ€ΧΧ ΧΧΧ¨ΧΧ Χ©Χ Jekyll), ΧΧ Χ’ΧΧΧΧ ΧΧ€Χ©Χ¨Χ.
#### ΧΧ ΧΧΧͺ `_site/` Χ-gh-pages
ΧΧΧ§ΧΧ ΧΧΧ¨Χ ΧΧͺ ΧΧ ΧΧ’ ΧΧΧΧΧ Χ©Χ Jekyll Χ©ΧΧΧ Χ-Github, ΧͺΧΧΧΧ ΧΧ€ΧͺΧ ΧΧͺ ΧΧͺΧ¨ Jekyll Χ©ΧΧΧ ΧΧ’Χ Χ£ Χ Χ€Χ¨Χ, ΧΧΧ ΧΧΧΧΧ£ ΧΧͺ ΧͺΧΧΧ `_site/` ΧΧΧ ΧΧ ΧΧ’Χ Χ£ `gh-pages` Χ©ΧΧΧ. ΧΧ ΧΧΧ€Χ©Χ¨ ΧΧΧ ΧΧ ΧΧ ΧΧΧ©ΧΧΧ ΧΧΧ§ΧΧ¨ ΧΧ€ΧΧͺΧΧ ΧΧΧͺΧ¨ Χ©ΧΧΧ Χ’Χ Github *ΧΧΧΧ ΧΧΧ‘ΧͺΧΧ Χ’Χ Github ΧΧΧ ΧΧͺ ΧΧͺ ΧΧΧͺΧ¨ Χ©ΧΧΧ!*
ΧͺΧΧΧΧ ΧΧ’Χ©ΧΧͺ ΧΧΧͺ Χ’Χ ΧΧΧ Χ©ΧΧΧ¨Χͺ ΧͺΧΧΧ Jekyll Χ©ΧΧΧ ΧΧ’Χ Χ£ Χ Χ€Χ¨Χ, ΧΧΧ’ΧΧΧͺ Χ¨Χ§ ΧͺΧΧ§ΧΧΧͺ `_site/` ΧΧ’Χ Χ£ gh-pages Χ©ΧΧΧ. ΧΧΧΧΧΧ Χ©ΧΧΧ Χ¨Χ§ ΧΧ€Χ HTML Χ‘ΧΧΧΧΧ ΧΧͺΧΧ§ΧΧΧͺ, Github ΧΧΧ¨Χ ΧΧΧͺΧ ΧΧΧ ΧΧ ΧͺΧΧΧ [gh-pages](https://pages.github.com/) ΧΧΧ¨.
#### ΧΧΧΧΧΧ¦ΧΧ!
ΧͺΧΧΧΧ ΧΧ ΧΧͺΧΧΧ’Χ ΧΧΧΧ Χ’Χ Χ‘Χ§Χ¨ΧΧ€Χ Χ€Χ©ΧΧ Χ©ΧΧΧ Χ ΧΧͺ ΧΧΧͺΧ¨ Χ©ΧΧΧ ΧΧΧΧΧΧ£ ΧΧͺ ΧͺΧΧ§ΧΧΧͺ `_site/` Χ-gh-pages Χ©ΧΧΧ. ΧΧ¨ΧΧ ΧΧ Χ©ΧΧ ΧΧ© ΧΧΧ ΧΧΧ. [ΧΧ Χ ΧΧΧ](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/). [ΧΧ Χ Χ’ΧΧ ΧΧΧ](https://gist.github.com/cobyism/4730490). ΧΧ Χ [Χ‘Χ§Χ¨ΧΧ€Χ ΧΧ€Χ¨Χ‘ΧΧ Χ©ΧΧ](https://github.com/untra/polyglot/blob/main/publi.sh):
```bash
#! /bin/sh
# Χ©Χ Χ ΧΧͺ Χ©ΧΧΧͺ ΧΧ’Χ Χ€ΧΧ ΧΧΧͺΧΧ
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.hi.md 0000664 0000000 0000000 00000033430 15201735340 0020060 0 ustar 00root root 0000000 0000000 ---
layout: page
title: ΰ€ͺΰ€°ΰ€Ώΰ€ΰ€―
permalink: about/
lang: hi
---
Polyglot Jekyll ΰ€¬ΰ₯ΰ€²ΰ₯ΰ€ΰ₯ΰ€ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ ΰ€ΰ€ ΰ€ΰ€ͺΰ€¨ ΰ€Έΰ₯ΰ€°ΰ₯ΰ€Έ ΰ€
ΰ€ΰ€€ΰ€°ΰ₯ΰ€°ΰ€Ύΰ€·ΰ₯ΰ€ΰ₯ΰ€°ΰ₯ΰ€―ΰ€ΰ€°ΰ€£ ΰ€ͺΰ₯ΰ€²ΰ€ΰ€ΰ€¨ ΰ€Ήΰ₯ΰ₯€ Polyglot ΰ€ΰ€Ώΰ€Έΰ₯ ΰ€ΰ₯ ΰ€ͺΰ₯ΰ€°ΰ₯ΰ€ΰ₯ΰ€ΰ₯ΰ€ ΰ€ΰ₯ ΰ€Έΰ€Ύΰ€₯ ΰ€Έΰ₯ΰ€ΰ€
ΰ€ͺ ΰ€ΰ€° ΰ€ΰ€ͺΰ€―ΰ₯ΰ€ ΰ€ΰ€°ΰ€¨ΰ₯ ΰ€ΰ₯ΰ€ ΰ€ΰ€Έΰ€Ύΰ€¨ ΰ€Ήΰ₯, ΰ€ΰ€° ΰ€―ΰ€Ή ΰ€ΰ€¨ ΰ€ΰ€Ύΰ€·ΰ€Ύΰ€ΰ€ ΰ€€ΰ€ ΰ€Έΰ₯ΰ€ΰ₯ΰ€² ΰ€ΰ€°ΰ€€ΰ€Ύ ΰ€Ήΰ₯ ΰ€ΰ€Ώΰ€¨ΰ€ΰ€Ύ ΰ€ΰ€ͺ ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€¨ ΰ€ΰ€°ΰ€¨ΰ€Ύ ΰ€ΰ€Ύΰ€Ήΰ€€ΰ₯ ΰ€Ήΰ₯ΰ€ΰ₯€ ΰ€ΰ€Ύΰ€―ΰ€¬ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ ΰ€«ΰ₯ΰ€²ΰ€¬ΰ₯ΰ€ ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€¨, ΰ€Έΰ₯ΰ€΅ΰ€ΰ€Ύΰ€²ΰ€Ώΰ€€ url ΰ€Έΰ€Ύΰ€ͺΰ₯ΰ€ΰ₯ΰ€·ΰ₯ΰ€ΰ€°ΰ€£, ΰ€ΰ€° ΰ€Άΰ€ΰ₯ΰ€€ΰ€Ώΰ€Άΰ€Ύΰ€²ΰ₯ SEO ΰ€°ΰ₯ΰ€Έΰ€Ώΰ€ͺΰ₯ ΰ€ΰ₯ ΰ€Έΰ€Ύΰ€₯, Polyglot ΰ€ΰ€Ώΰ€Έΰ₯ ΰ€ΰ₯ ΰ€¬ΰ€Ήΰ₯-ΰ€ΰ€Ύΰ€·ΰ€Ύ ΰ€¬ΰ₯ΰ€²ΰ₯ΰ€ ΰ€ΰ₯ ΰ€
ΰ€¨ΰ€Ύΰ€΅ΰ€Άΰ₯ΰ€―ΰ€ ΰ€ΰ€Ύΰ€ ΰ€ΰ₯ ΰ€¬ΰ€Ώΰ€¨ΰ€Ύ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ͺΰ€° ΰ€§ΰ₯ΰ€―ΰ€Ύΰ€¨ ΰ€ΰ₯ΰ€ΰ€¦ΰ₯ΰ€°ΰ€Ώΰ€€ ΰ€ΰ€°ΰ€¨ΰ₯ ΰ€ΰ₯ ΰ€
ΰ€¨ΰ₯ΰ€ΰ€€ΰ€Ώ ΰ€¦ΰ₯ΰ€€ΰ€Ύ ΰ€Ήΰ₯ΰ₯€
_`jekyll-polyglot` ΰ€
ΰ€ΰ₯ ΰ€€ΰ€ github-actions ΰ€ΰ₯ΰ€ ΰ€¦ΰ₯ΰ€Άΰ₯ ΰ€°ΰ₯ΰ€ͺ ΰ€Έΰ₯ ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€Ώΰ€€ ΰ€¨ΰ€Ήΰ₯ΰ€ ΰ€Ήΰ₯_
### ΰ€Έΰ₯ΰ€₯ΰ€Ύΰ€ͺΰ€¨ΰ€Ύ
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€Ώΰ€€ ΰ€ΰ€Ύΰ€·ΰ€Ύΰ€ΰ€ ΰ€ΰ€Ύ ΰ€ͺΰ₯ΰ€°ΰ€¬ΰ€ΰ€§ΰ€¨
`_config.yml` ΰ€ΰ₯ΰ€, ΰ€¨ΰ€Ώΰ€ΰ₯ΰ€¨ΰ€²ΰ€Ώΰ€ΰ€Ώΰ€€ ΰ€ΰ₯ΰ€£ ΰ€ͺΰ₯ΰ€°ΰ€¬ΰ€ΰ€§ΰ€Ώΰ€€ ΰ€ΰ€°ΰ€€ΰ₯ ΰ€Ήΰ₯ΰ€ ΰ€ΰ€Ώ ΰ€ΰ€ͺΰ€ΰ₯ ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€¦ΰ₯ΰ€΅ΰ€Ύΰ€°ΰ€Ύ ΰ€ΰ₯ΰ€¨ ΰ€Έΰ₯ ΰ€ΰ€Ύΰ€·ΰ€Ύΰ€ΰ€ ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€Ώΰ€€ ΰ€Ήΰ₯ΰ€ΰ₯€ ΰ€ΰ€ͺ ΰ€ΰ€¨ ΰ€ΰ€Ύΰ€¨ΰ₯ΰ€ ΰ€ΰ₯ΰ€ ΰ€ΰ₯ΰ€‘ΰ€Όΰ€ΰ€° ΰ€ΰ€ ΰ€¨ΰ€ ΰ€ΰ€Ύΰ€·ΰ€Ύ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€¨ ΰ€ͺΰ₯ΰ€°ΰ€¦ΰ€Ύΰ€¨ ΰ€ΰ€° ΰ€Έΰ€ΰ€€ΰ₯ ΰ€Ήΰ₯ΰ€ (ΰ€¨ΰ₯ΰ€ΰ₯ ΰ€¦ΰ₯ΰ€ΰ₯ΰ€)ΰ₯€ ΰ€ΰ€Ύΰ€·ΰ€Ύΰ€ΰ€ ΰ€ΰ₯ ΰ€ͺΰ€Ήΰ€ΰ€Ύΰ€¨ ΰ€ΰ€¨ΰ€ΰ₯ ΰ€ΰ€§ΰ€Ώΰ€ΰ€Ύΰ€°ΰ€Ώΰ€ [ΰ€²ΰ₯ΰ€ΰ₯ΰ€² ΰ€ΰ₯ΰ€‘](https://developer.chrome.com/webstore/i18n) ΰ€¦ΰ₯ΰ€΅ΰ€Ύΰ€°ΰ€Ύ ΰ€ΰ₯ ΰ€ΰ€Ύΰ€€ΰ₯ ΰ€Ήΰ₯ΰ₯€
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` ΰ€²ΰ₯ΰ€ΰ₯ΰ€² ΰ€ΰ₯ΰ€‘ ΰ€ΰ€Ύ ΰ€ΰ€ ΰ€Έΰ€°ΰ€£ΰ₯ ΰ€ΰ₯ ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€¦ΰ₯ΰ€΅ΰ€Ύΰ€°ΰ€Ύ ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€Ώΰ€€ ΰ€ΰ€Ύΰ€·ΰ€Ύΰ€ΰ€ ΰ€ΰ₯ ΰ€ͺΰ€Ήΰ€ΰ€Ύΰ€¨ ΰ€ΰ€°ΰ€€ΰ₯ ΰ€Ήΰ₯ΰ₯€
* `default_lang:` ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ ΰ€‘ΰ€Ώΰ€«ΰ€Όΰ₯ΰ€²ΰ₯ΰ€ ΰ€ΰ€Ύΰ€·ΰ€Ύΰ₯€
* `exclude_from_localization:` ΰ€«ΰ€Όΰ₯ΰ€²ΰ₯ΰ€‘ΰ€° ΰ€ΰ€° ΰ€¨ΰ€Ώΰ€°ΰ₯ΰ€¦ΰ₯ΰ€Άΰ€Ώΰ€ΰ€Ύΰ€ΰ€ ΰ€ΰ₯ ΰ€¨ΰ€Ώΰ€°ΰ₯ΰ€ΰ€Ώΰ€€ ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€ΰ€Ύ ΰ€Ήΰ€Ώΰ€Έΰ₯ΰ€Έΰ€Ύ ΰ€Ήΰ₯ΰ€, ΰ€²ΰ₯ΰ€ΰ€Ώΰ€¨ ΰ€ΰ€¨ΰ₯ΰ€Ήΰ₯ΰ€ ΰ€Έΰ₯ΰ€₯ΰ€Ύΰ€¨ΰ₯ΰ€―ΰ€ΰ₯ΰ€€ ΰ€ΰ€°ΰ€¨ΰ₯ ΰ€ΰ₯ ΰ€ΰ€΅ΰ€Άΰ₯ΰ€―ΰ€ΰ€€ΰ€Ύ ΰ€¨ΰ€Ήΰ₯ΰ€ ΰ€Ήΰ₯ΰ₯€ ΰ€―ΰ€Ή ΰ€ΰ₯ΰ€ΰ₯ΰ€― ΰ€°ΰ₯ΰ€ͺ ΰ€Έΰ₯ ΰ€¬ΰ€Ώΰ€²ΰ₯ΰ€‘ ΰ€Έΰ€ΰ€― ΰ€ΰ₯ ΰ€ΰ€ ΰ€ΰ€°ΰ€¨ΰ₯ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ ΰ€Ήΰ₯, ΰ€ΰ€° ΰ€ΰ₯ΰ€―ΰ₯ΰ€ΰ€ΰ€Ώ ΰ€ΰ€΅ΰ€Ώΰ€―ΰ₯ΰ€ ΰ€ΰ€° ΰ€«ΰ€Όΰ₯ΰ€¨ΰ₯ΰ€ ΰ€ΰ₯ΰ€Έΰ₯ ΰ€ΰ€Έΰ₯ΰ€ ΰ€«ΰ€Όΰ€Ύΰ€ΰ€²ΰ₯ΰ€ ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€ΰ₯ ΰ€¬ΰ€‘ΰ€Όΰ₯ ΰ€Ήΰ€Ώΰ€Έΰ₯ΰ€Έΰ₯ ΰ€Ήΰ₯ΰ€, ΰ€―ΰ€Ή ΰ€Έΰ₯ΰ€¨ΰ€Ώΰ€Άΰ₯ΰ€ΰ€Ώΰ€€ ΰ€ΰ€°ΰ€€ΰ€Ύ ΰ€Ήΰ₯ ΰ€ΰ€Ώ ΰ€΅ΰ₯ ΰ€ΰ€ΰ€ΰ€ͺΰ₯ΰ€ ΰ€ΰ₯ΰ€ ΰ€
ΰ€¨ΰ€Ύΰ€΅ΰ€Άΰ₯ΰ€―ΰ€ ΰ€°ΰ₯ΰ€ͺ ΰ€Έΰ₯ "ΰ€
ΰ€¨ΰ₯ΰ€΅ΰ€Ύΰ€¦ΰ€Ώΰ€€" ΰ€―ΰ€Ύ ΰ€‘ΰ₯ΰ€ͺΰ₯ΰ€²ΰ€Ώΰ€ΰ₯ΰ€ ΰ€¨ ΰ€Ήΰ₯ΰ€ΰ₯€
* `url` ΰ€ΰ€ͺΰ€ΰ₯ ΰ€ͺΰ₯ΰ€°ΰ₯ΰ€‘ΰ€ΰ₯ΰ€Άΰ€¨ ΰ€Έΰ₯ΰ€ΰ₯ΰ€ΰ€Ώΰ€ ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€ΰ€Ύ urlΰ₯€
### ΰ€ΰ€ ΰ€¨ΰ€ ΰ€ΰ€Ύΰ€·ΰ€Ύ ΰ€ΰ₯ΰ€‘ΰ€Όΰ€¨ΰ€Ύ
ΰ€ΰ€Ύΰ€¨ΰ€€ΰ₯ ΰ€Ήΰ₯ΰ€ ΰ€ΰ€Ώ ΰ€ΰ€ͺΰ€ΰ₯ ΰ€ͺΰ€Ύΰ€Έ ΰ€ͺΰ€Ήΰ€²ΰ₯ ΰ€Έΰ₯ ΰ€Ήΰ₯ ΰ€ΰ€ ΰ€ΰ€Ύΰ€°ΰ₯ΰ€―ΰ€Ύΰ€€ΰ₯ΰ€ΰ€ ΰ€ΰ€ΰ€²-ΰ€ΰ€Ύΰ€·ΰ€Ύ ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€Ήΰ₯, ΰ€ΰ€ ΰ€¨ΰ€ ΰ€ΰ€Ύΰ€·ΰ€Ύ ΰ€ΰ₯ΰ€‘ΰ€Όΰ€¨ΰ€Ύ ΰ€€ΰ₯ΰ€ΰ₯ΰ€ ΰ€¨ΰ€Ήΰ₯ΰ€ ΰ€Ήΰ₯ΰ€ΰ€Ύΰ₯€ _ΰ€΅ΰ€Ύΰ€Έΰ₯ΰ€€ΰ€΅ ΰ€ΰ₯ΰ€ ΰ€ΰ€ ΰ€¬ΰ€Ήΰ₯ΰ€ΰ€Ύΰ€·ΰ₯ ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€¬ΰ€¨ΰ€Ύΰ€¨ΰ₯ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€, ΰ€ΰ€ͺΰ€ΰ₯ ΰ€
ΰ€ͺΰ€¨ΰ₯ ΰ€Έΰ€Ύΰ€°ΰ₯ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€¨ΰ€ ΰ€ΰ€Ύΰ€·ΰ€Ύ ΰ€ΰ₯ΰ€ ΰ€«ΰ€Ώΰ€° ΰ€Έΰ₯ ΰ€¬ΰ€¨ΰ€Ύΰ€¨ΰ₯ ΰ€ΰ₯ ΰ€ΰ€ΰ₯ΰ€ΰ₯ΰ€¦ ΰ€ΰ€°ΰ€¨ΰ₯ ΰ€ΰ€Ύΰ€Ήΰ€Ώΰ€ΰ₯€_ ΰ€―ΰ€Ή ΰ€ΰ€ ΰ€¬ΰ€‘ΰ€Όΰ€Ύ ΰ€ΰ€ͺΰ€ΰ₯ΰ€°ΰ€ ΰ€²ΰ€ ΰ€Έΰ€ΰ€€ΰ€Ύ ΰ€Ήΰ₯, ΰ€²ΰ₯ΰ€ΰ€Ώΰ€¨ ΰ€ΰ€Ύΰ€ΰ₯ΰ€ ΰ€ΰ₯ΰ€ ΰ€
ΰ€¨ΰ₯ΰ€΅ΰ€Ύΰ€¦ ΰ€ͺΰ€° ΰ€΅ΰ€Ώΰ€ΰ€Ύΰ€° ΰ€ΰ€°ΰ₯ΰ€ΰ₯€ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€°ΰ€Ύΰ€ΰ€Ύ ΰ€Ήΰ₯; ΰ€―ΰ€Ή ΰ€
ΰ€§ΰ€Ώΰ€ ΰ€ΰ€Ήΰ€€ΰ₯ΰ€΅ΰ€ͺΰ₯ΰ€°ΰ₯ΰ€£ ΰ€Ήΰ₯ ΰ€ΰ€Ώ ΰ€¨ΰ€ ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ ΰ€ΰ€° ΰ€ͺΰ₯ΰ€Έΰ₯ΰ€ ΰ€
ΰ€¨ΰ₯ΰ€΅ΰ€Ύΰ€¦ ΰ€ΰ₯ΰ€ ΰ€
ΰ€¦ΰ₯ΰ€―ΰ€€ΰ€¨ ΰ€Άΰ€¬ΰ₯ΰ€¦ ΰ€ͺΰ₯ΰ€°ΰ€Ύΰ€ͺΰ₯ΰ€€ ΰ€ΰ€°ΰ₯ΰ€ΰ₯€ ΰ€ΰ€ ΰ€¬ΰ€Ήΰ₯-ΰ€ΰ€Ύΰ€·ΰ€Ύ ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€¬ΰ€¨ΰ€Ύΰ€¨ΰ€Ύ ΰ€ΰ₯ΰ€΅ΰ€² ΰ€€ΰ€ΰ₯ ΰ€ΰ€ ΰ€Ώΰ€¨ ΰ€Ήΰ₯ ΰ€ΰ€¬ ΰ€ΰ€ͺΰ€ΰ₯ ΰ€ΰ€΅ΰ€Άΰ₯ΰ€―ΰ€ΰ€€ΰ€Ύ ΰ€Ήΰ₯ ΰ€ΰ€Ώ ΰ€―ΰ€Ή ΰ€Άΰ₯ΰ€°ΰ₯ ΰ€Έΰ₯ ΰ€Ήΰ₯ ΰ€ͺΰ₯ΰ€°ΰ₯ ΰ€€ΰ€°ΰ€Ή ΰ€Έΰ₯ ΰ€
ΰ€¨ΰ₯ΰ€΅ΰ€Ύΰ€¦ΰ€Ώΰ€€ ΰ€Ήΰ₯ΰ₯€
ΰ€Έΰ€¬ΰ€Έΰ₯ ΰ€ͺΰ€Ήΰ€²ΰ₯, ΰ€ΰ€ͺΰ€ΰ₯ (ΰ€ΰ€° ΰ€ΰ€ͺΰ€ΰ₯ ΰ€ΰ₯ΰ€, ΰ€ΰ€° ΰ€ΰ€ͺΰ€ΰ₯ ΰ€ͺΰ₯ΰ€°ΰ€¬ΰ€ΰ€§ΰ€ΰ₯ΰ€ ΰ€ΰ₯ ΰ€ΰ₯ ΰ€―ΰ€¦ΰ€Ώ ΰ€ΰ€ͺΰ€ΰ₯ ΰ€ͺΰ€Ύΰ€Έ ΰ€ΰ₯ΰ€ ΰ€Ήΰ₯ΰ€) ΰ€ΰ€°ΰ₯ΰ€ΰ€Ύ ΰ€ΰ€°ΰ€¨ΰ₯ ΰ€ΰ€Ύΰ€Ήΰ€Ώΰ€ ΰ€ΰ€° ΰ€ΰ₯ΰ€¨ΰ€¨ΰ€Ύ ΰ€ΰ€Ύΰ€Ήΰ€Ώΰ€ ΰ€ΰ€Ώ ΰ€ΰ€ͺΰ€ΰ₯ ΰ€¨ΰ€ ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€ΰ₯ΰ€ ΰ€ΰ€Ώΰ€Έ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ€Ύ ΰ€
ΰ€¨ΰ₯ΰ€΅ΰ€Ύΰ€¦ ΰ€ΰ€°ΰ€¨ΰ₯ ΰ€ΰ₯ ΰ€ΰ€΅ΰ€Άΰ₯ΰ€―ΰ€ΰ€€ΰ€Ύ ΰ€Ήΰ₯ΰ₯€ ΰ€ΰ€ͺΰ€ΰ₯ ΰ€
ΰ€¨ΰ₯ΰ€΅ΰ€Ύΰ€¦ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ ΰ€
ΰ€ͺΰ€¨ΰ₯ ΰ€ͺΰ€Έΰ€ΰ€¦ΰ₯ΰ€¦ΰ€Ύ ΰ€¬ΰ₯ΰ€¨ΰ€Ώΰ€―ΰ€Ύΰ€¦ΰ₯ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ₯ΰ€¨ΰ€¨ΰ₯ ΰ€Ήΰ₯ΰ€ΰ₯ΰ₯€ ΰ€ΰ€¨ΰ€Ύΰ€²ΰ€Ώΰ€ΰ€Ώΰ€ΰ₯ΰ€Έ, ΰ€²ΰ₯ΰ€ΰ€ͺΰ₯ΰ€°ΰ€Ώΰ€― ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ ΰ₯ΰ€ ΰ€ΰ€° ΰ€¬ΰ₯ΰ€²ΰ₯ΰ€ΰ€ͺΰ₯ΰ€Έΰ₯ΰ€, ΰ€ΰ€° ΰ€ΰ€ͺΰ€ΰ₯ ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€ͺΰ€° ΰ€΅ΰ€°ΰ₯ΰ€€ΰ€ΰ€Ύΰ€¨ ΰ€ΰ€° ΰ€ΰ€΅ΰ€Ώΰ€·ΰ₯ΰ€― ΰ€ΰ₯ ΰ€ΰ€ͺΰ€―ΰ₯ΰ€ΰ€ΰ€°ΰ₯ΰ€€ΰ€Ύΰ€ΰ€ ΰ€ΰ₯ ΰ€ͺΰ₯ΰ€°ΰ€΅ΰ€Ύΰ€Ή ΰ€ͺΰ€° ΰ€΅ΰ€Ώΰ€ΰ€Ύΰ€° ΰ€ΰ€°ΰ₯ΰ€ΰ₯€ ΰ€Έΰ€ΰ€¦ΰ₯ΰ€Ή ΰ€ΰ₯ΰ€, ΰ€΅ΰ€Ώΰ€°ΰ€Ύΰ€Έΰ€€ ΰ€¬ΰ₯ΰ€²ΰ₯ΰ€ΰ€ͺΰ₯ΰ€Έΰ₯ΰ€ ΰ€ͺΰ€° ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ ΰ₯ΰ€ ΰ€ΰ₯ ΰ€ͺΰ₯ΰ€°ΰ€Ύΰ€₯ΰ€ΰ€Ώΰ€ΰ€€ΰ€Ύ ΰ€¦ΰ₯ΰ€ΰ₯€ ΰ€―ΰ€¦ΰ€Ώ ΰ€ΰ€Έΰ€ΰ€Ύ ΰ€ΰ€€ΰ€²ΰ€¬ ΰ€Ήΰ₯ ΰ€ΰ€Ώ ΰ€ΰ€ ΰ€¨ΰ€ ΰ€ΰ€Ύΰ€·ΰ€Ύ ΰ€ΰ₯ ΰ€ΰ€²ΰ₯ΰ€¦ΰ₯ ΰ€²ΰ₯ΰ€¨ΰ₯ΰ€ ΰ€ΰ€°ΰ€¨ΰ€Ύ, ΰ€€ΰ₯ ΰ€΅ΰ€Ώΰ€°ΰ€Ύΰ€Έΰ€€ ΰ€ͺΰ₯ΰ€Έΰ₯ΰ€ ΰ€
ΰ€¨ΰ₯ΰ€΅ΰ€Ύΰ€¦ ΰ€ΰ₯ ΰ€²ΰ€Ύΰ€―ΰ€ ΰ€ͺΰ₯ΰ€°ΰ€―ΰ€Ύΰ€Έ ΰ€Έΰ₯ ΰ€
ΰ€§ΰ€Ώΰ€ ΰ€Ήΰ₯ ΰ€Έΰ€ΰ€€ΰ₯ ΰ€Ήΰ₯ΰ€ΰ₯€
ΰ€¦ΰ₯ΰ€Έΰ€°ΰ₯, ΰ€ΰ€ͺΰ€ΰ₯ ΰ€
ΰ€ͺΰ€¨ΰ₯ ΰ€Έΰ€Ύΰ€ΰ€ ΰ€ΰ₯ ΰ€ΰ€Ύΰ€§ΰ₯ΰ€―ΰ€ ΰ€Έΰ₯ ΰ€Έΰ€ΰ₯ΰ€¦ΰ₯ΰ€§ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ₯ 100% ΰ€ΰ€΅ΰ€°ΰ₯ΰ€ ΰ€ͺΰ₯ΰ€°ΰ€¦ΰ€Ύΰ€¨ ΰ€ΰ€°ΰ€¨ΰ₯ ΰ€ΰ€Ύΰ€Ήΰ€Ώΰ€ (ΰ€―ΰ€Ύ ΰ€ΰ₯ΰ€°ΰ€¦ΰ€Ύΰ€° ΰ€’ΰ€ΰ€ ΰ€Έΰ₯ ΰ€ΰ€Ύΰ€Ήΰ€Ώΰ€)ΰ₯€ ΰ€―ΰ₯ ΰ€
ΰ€§ΰ€Ώΰ€ ΰ€ΰ€ΰ€Ώΰ€² ΰ€€ΰ€°ΰ₯ΰ€ΰ₯ΰ€ ΰ€Έΰ₯ ΰ€ΰ€ΰ₯ΰ€¬ΰ₯ΰ€‘ΰ₯ΰ€‘ ΰ€ΰ₯ΰ€ΰ₯ ΰ€Έΰ₯ΰ€ΰ₯ΰ€°ΰ€Ώΰ€ΰ€ ΰ€Ήΰ₯ΰ€ΰ₯€ ΰ€Έΰ€ΰ₯ΰ€¦ΰ₯ΰ€§ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ͺΰ€° ΰ€ͺΰ₯ΰ€¨ΰ€°ΰ€Ύΰ€΅ΰ₯ΰ€€ΰ₯ΰ€€ΰ€Ώ ΰ€ΰ€°ΰ€¨ΰ₯ ΰ€ΰ₯ ΰ€ΰ€ ΰ€€ΰ€°ΰ₯ΰ€ΰ₯ ΰ€Ήΰ₯ΰ€ΰ₯€ ΰ€―ΰ€Ύΰ€¦ ΰ€°ΰ€ΰ₯ΰ€, ΰ€ΰ€ͺΰ€ΰ₯ ΰ€
ΰ€ͺΰ€¨ΰ₯ ΰ€Έΰ€ΰ₯ΰ€¦ΰ₯ΰ€§ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ₯ΰ€ ΰ€Έΰ€ΰ₯ ΰ€ΰ€Ύΰ€·ΰ€Ύ ΰ€ΰ₯ΰ€ΰ₯ ΰ€Έΰ₯ΰ€ΰ₯ΰ€°ΰ€Ώΰ€ΰ€ ΰ€ΰ€Ύ ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€¨ ΰ€ΰ€°ΰ€¨ΰ€Ύ ΰ€ΰ€Ύΰ€Ήΰ€Ώΰ€ΰ₯€
#### ΰ€¬ΰ€Ήΰ₯ΰ€ΰ€Ύΰ€·ΰ₯ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯
ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€¦ΰ₯ ΰ€Έΰ₯ΰ€΅ΰ€Ύΰ€¦ΰ₯ΰ€ ΰ€ΰ₯ΰ€ ΰ€ΰ€€ΰ₯ ΰ€Ήΰ₯: **ΰ€¬ΰ₯ΰ€¨ΰ€Ώΰ€―ΰ€Ύΰ€¦ΰ₯** ΰ€ΰ€° **ΰ€Έΰ€ΰ₯ΰ€¦ΰ₯ΰ€§**ΰ₯€
ΰ€¬ΰ₯ΰ€¨ΰ€Ώΰ€―ΰ€Ύΰ€¦ΰ₯ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€¬ΰ₯ΰ€²ΰ₯ΰ€ΰ€ͺΰ₯ΰ€Έΰ₯ΰ€, ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ ΰ₯ΰ€ ΰ€ΰ€° ΰ€ΰ₯ΰ€°-ΰ€ΰ€ΰ€ΰ€°ΰ₯ΰ€ΰ₯ΰ€ΰ€Ώΰ€΅ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ€Ύ ΰ€Έΰ€ͺΰ€Ύΰ€ ΰ€ͺΰ€Ύΰ€ ΰ€Ήΰ₯ΰ₯€ ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ ΰ₯ΰ€ ΰ€ΰ€° ΰ€ͺΰ₯ΰ€Έΰ₯ΰ€ ΰ€ΰ₯ ΰ€¬ΰ€Ύΰ€°ΰ₯ ΰ€ΰ₯ΰ€ ΰ€Έΰ₯ΰ€ΰ₯ΰ€ΰ₯€ ΰ€¬ΰ₯ΰ€¨ΰ€Ώΰ€―ΰ€Ύΰ€¦ΰ₯ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ€ͺΰ€ΰ₯ ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€ ΰ€ΰ₯ ΰ€ΰ₯ΰ€²ΰ€Ώΰ€ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ ΰ€ΰ€ΰ€§ΰ€¨ ΰ€Ήΰ₯ΰ₯€ Polyglot ΰ€¬ΰ₯ΰ€¨ΰ€Ώΰ€―ΰ€Ύΰ€¦ΰ₯ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ₯ ΰ€«ΰ₯ΰ€²ΰ€¬ΰ₯ΰ€ ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€¨ ΰ€¦ΰ₯ΰ€€ΰ€Ύ ΰ€Ήΰ₯ΰ₯€
ΰ€Έΰ€ΰ₯ΰ€¦ΰ₯ΰ€§ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ€ΰ€ΰ€°ΰ₯ΰ€ΰ₯ΰ€ΰ€Ώΰ€΅, ΰ€ΰ€ΰ€ΰ€¦ΰ€Ύΰ€° ΰ€Ήΰ₯, ΰ€ΰ€° ΰ€ΰ₯ΰ€ΰ₯ ΰ€Έΰ₯ΰ€ΰ₯ΰ€°ΰ€Ώΰ€ΰ€ ΰ€Έΰ₯ ΰ€¬ΰ€¨ΰ₯ ΰ€Ήΰ₯ΰ₯€ ΰ€¨ΰ€΅ΰ€¬ΰ€Ύΰ€° ΰ€ΰ€° ΰ€‘ΰ₯ΰ€°ΰ₯ΰ€ͺΰ€‘ΰ€Ύΰ€ΰ€¨ ΰ€ΰ₯ ΰ€¬ΰ€Ύΰ€°ΰ₯ ΰ€ΰ₯ΰ€ ΰ€Έΰ₯ΰ€ΰ₯ΰ€ΰ₯€ ΰ€Έΰ€ΰ₯ΰ€¦ΰ₯ΰ€§ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€
ΰ€§ΰ€Ώΰ€ ΰ€€ΰ€ΰ€¨ΰ₯ΰ€ΰ₯ ΰ€Ήΰ₯, ΰ€ΰ€° ΰ€ΰ€ͺΰ€ΰ₯ ΰ€ΰ€ΰ€ΰ€€ΰ₯ΰ€ΰ₯ΰ€ ΰ€ΰ₯ ΰ€Έΰ€Ύΰ€ΰ€ ΰ€ͺΰ€° ΰ€°ΰ€ΰ€€ΰ₯ ΰ€Ήΰ₯ΰ₯€ _ΰ€ΰ€Ύΰ€―ΰ€¬ ΰ€Έΰ€ΰ₯ΰ€¦ΰ₯ΰ€§ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ ΰ€ΰ₯ΰ€ ΰ€«ΰ₯ΰ€²ΰ€¬ΰ₯ΰ€ ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€¨ ΰ€¨ΰ€Ήΰ₯ΰ€ ΰ€Ήΰ₯ΰ₯€_
#### Liquid ΰ€ΰ₯ΰ€²ΰ₯ΰ€Έ
jekyll-polyglot ΰ€ΰ₯ ΰ€Έΰ€Ύΰ€₯ ΰ€ΰ€ͺΰ€―ΰ₯ΰ€ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ ΰ€¨ΰ€Ώΰ€ΰ₯ΰ€¨ΰ€²ΰ€Ώΰ€ΰ€Ώΰ€€ liquid ΰ€ΰ₯ΰ€²ΰ₯ΰ€Έ ΰ€ΰ€ͺΰ€²ΰ€¬ΰ₯ΰ€§ ΰ€Ήΰ₯ΰ€:
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages` _config.yml ΰ€ΰ₯ΰ€ `languages` ΰ€Έΰ€°ΰ€£ΰ₯ ΰ€ΰ₯ ΰ€ΰ€° ΰ€Έΰ₯ΰ€§ΰ₯ ΰ€ΰ€ΰ€ΰ€Ώΰ€€ ΰ€ΰ€°ΰ€€ΰ€Ύ ΰ€Ήΰ₯ΰ₯€ ΰ€ΰ€Έΰ₯ liquid ΰ€ΰ₯ ΰ€ΰ€Ύΰ€§ΰ₯ΰ€―ΰ€ ΰ€Έΰ₯ ΰ€ΰ€ΰ₯ΰ€Έΰ₯ΰ€Έ ΰ€ΰ€Ώΰ€―ΰ€Ύ ΰ€ΰ€Ύ ΰ€Έΰ€ΰ€€ΰ€Ύ ΰ€Ήΰ₯ΰ₯€
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang` _config.yml ΰ€ΰ₯ΰ€ `default_lang` ΰ€Έΰ₯ΰ€ΰ₯ΰ€°ΰ€Ώΰ€ΰ€ ΰ€ΰ₯ ΰ€ΰ€° ΰ€Έΰ₯ΰ€§ΰ₯ ΰ€ΰ€ΰ€ΰ€Ώΰ€€ ΰ€ΰ€°ΰ€€ΰ€Ύ ΰ€Ήΰ₯ΰ₯€ ΰ€ΰ€Έΰ₯ liquid ΰ€ΰ₯ ΰ€ΰ€Ύΰ€§ΰ₯ΰ€―ΰ€ ΰ€Έΰ₯ ΰ€ΰ€ΰ₯ΰ€Έΰ₯ΰ€Έ ΰ€ΰ€Ώΰ€―ΰ€Ύ ΰ€ΰ€Ύ ΰ€Έΰ€ΰ€€ΰ€Ύ ΰ€Ήΰ₯ΰ₯€
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang` ΰ€΅ΰ€Ή ΰ€²ΰ₯ΰ€ΰ₯ΰ€² ΰ€ΰ₯ΰ€‘ ΰ€Ήΰ₯ ΰ€ΰ€Ώΰ€Έΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ ΰ€¬ΰ€¨ΰ€Ύΰ€―ΰ€Ύ ΰ€ΰ€Ύ ΰ€°ΰ€Ήΰ€Ύ ΰ€Ήΰ₯ΰ₯€ ΰ€―ΰ€Ή ΰ€ΰ€°ΰ₯ΰ€ΰ€¨ ΰ€Έΰ€ΰ€Έΰ₯ΰ€ΰ€°ΰ€£ ΰ€ΰ₯ ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ `"de"` ΰ€Ήΰ₯, ΰ€Έΰ₯ΰ€ͺΰ₯ΰ€¨ΰ€Ώΰ€Ά ΰ€Έΰ€ΰ€Έΰ₯ΰ€ΰ€°ΰ€£ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ `"es"`, ΰ€ΰ€€ΰ₯ΰ€―ΰ€Ύΰ€¦ΰ€Ώΰ₯€ ΰ€ΰ€Έΰ₯ liquid ΰ€ΰ₯ ΰ€ΰ€Ύΰ€§ΰ₯ΰ€―ΰ€ ΰ€Έΰ₯ ΰ€ΰ€ΰ₯ΰ€Έΰ₯ΰ€Έ ΰ€ΰ€Ώΰ€―ΰ€Ύ ΰ€ΰ€Ύ ΰ€Έΰ€ΰ€€ΰ€Ύ ΰ€Ήΰ₯ΰ₯€
ΰ€ΰ€¨ ΰ€ΰ€ͺΰ€ΰ€°ΰ€£ΰ₯ΰ€ ΰ€ΰ€Ύ ΰ€ΰ€ͺΰ€―ΰ₯ΰ€ ΰ€ΰ€°ΰ€ΰ₯, ΰ€ΰ€ͺ ΰ€¨ΰ€Ώΰ€°ΰ₯ΰ€¦ΰ€Ώΰ€·ΰ₯ΰ€ ΰ€ΰ€° ΰ€Έΰ€ΰ€€ΰ₯ ΰ€Ήΰ₯ΰ€ ΰ€ΰ€Ώ ΰ€Έΰ€Ήΰ₯ ΰ€Έΰ€ΰ₯ΰ€¦ΰ₯ΰ€§ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ₯ΰ€Έΰ₯ ΰ€Έΰ€ΰ€²ΰ€ΰ₯ΰ€¨ ΰ€ΰ€°ΰ₯ΰ€ΰ₯€
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
`page.rendered_lang` ΰ€ΰ€° ΰ€ΰ₯ ΰ€ΰ€Ώΰ€Έΰ₯ ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ ΰ€ΰ₯ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ₯ ΰ€΅ΰ€Ύΰ€Έΰ₯ΰ€€ΰ€΅ΰ€Ώΰ€ ΰ€ΰ€Ύΰ€·ΰ€Ύ ΰ€ΰ₯ ΰ€ΰ€ΰ€ΰ€Ώΰ€€ ΰ€ΰ€°ΰ€€ΰ€Ύ ΰ€Ήΰ₯, ΰ€ΰ₯ΰ€ΰ₯ΰ€ͺΰ€²ΰ₯ΰ€ΰ₯ΰ€Έ ΰ€ΰ₯ ΰ€―ΰ€Ή ΰ€ͺΰ€€ΰ€Ύ ΰ€²ΰ€ΰ€Ύΰ€¨ΰ₯ ΰ€ΰ₯ ΰ€
ΰ€¨ΰ₯ΰ€ΰ€€ΰ€Ώ ΰ€¦ΰ₯ΰ€€ΰ€Ύ ΰ€Ήΰ₯ ΰ€ΰ€Ώ ΰ€ΰ₯ΰ€ ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ ΰ€«ΰ₯ΰ€²ΰ€¬ΰ₯ΰ€ ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ₯ ΰ€°ΰ₯ΰ€ͺ ΰ€ΰ₯ΰ€ ΰ€ͺΰ€°ΰ₯ΰ€Έΰ€Ύ ΰ€ΰ€Ύ ΰ€°ΰ€Ήΰ€Ύ ΰ€Ήΰ₯ΰ₯€
### Github Pages ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€¨
ΰ€‘ΰ€Ώΰ€«ΰ€Όΰ₯ΰ€²ΰ₯ΰ€ ΰ€°ΰ₯ΰ€ͺ ΰ€Έΰ₯ github [jekyll ΰ€¬ΰ₯ΰ€²ΰ₯ΰ€ΰ₯ΰ€ ΰ€ΰ₯ ΰ€ͺΰ₯ΰ€²ΰ€ΰ€ΰ€¨ΰ₯ΰ€Έ ΰ€ΰ€Ύ ΰ€ΰ€ͺΰ€―ΰ₯ΰ€ ΰ€ΰ€°ΰ€¨ΰ₯ ΰ€Έΰ₯ ΰ€°ΰ₯ΰ€ΰ€€ΰ€Ύ ΰ€Ήΰ₯](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides)ΰ₯€ ΰ€―ΰ€Ή ΰ€ΰ€Ύΰ€¨ΰ€¬ΰ₯ΰ€ΰ€ΰ€° github ΰ€Έΰ€°ΰ₯ΰ€΅ΰ€° ΰ€ͺΰ€° ΰ€¦ΰ₯ΰ€°ΰ₯ΰ€ΰ€Ύΰ€΅ΰ€¨ΰ€Ύΰ€ͺΰ₯ΰ€°ΰ₯ΰ€£ ΰ€ΰ₯ΰ€‘ ΰ€ΰ₯ ΰ€¨ΰ€Ώΰ€·ΰ₯ΰ€ͺΰ€Ύΰ€¦ΰ€Ώΰ€€ ΰ€Ήΰ₯ΰ€¨ΰ₯ ΰ€Έΰ₯ ΰ€°ΰ₯ΰ€ΰ€¨ΰ₯ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ ΰ€ΰ€Ώΰ€―ΰ€Ύ ΰ€ΰ€Ύΰ€€ΰ€Ύ ΰ€Ήΰ₯ΰ₯€ ΰ€―ΰ€¦ΰ₯ΰ€―ΰ€ͺΰ€Ώ ΰ€―ΰ€Ή Polyglot (ΰ€ΰ€° ΰ€
ΰ€¨ΰ₯ΰ€― jekyll ΰ€ͺΰ₯ΰ€²ΰ€ΰ€ΰ€¨ΰ₯ΰ€Έ) ΰ€ΰ€Ύ ΰ€ΰ€ͺΰ€―ΰ₯ΰ€ ΰ€ΰ€°ΰ€¨ΰ€Ύ ΰ€ΰ€ ΰ€Ώΰ€¨ ΰ€¬ΰ€¨ΰ€Ύΰ€€ΰ€Ύ ΰ€Ήΰ₯, ΰ€―ΰ€Ή ΰ€
ΰ€ΰ₯ ΰ€ΰ₯ ΰ€Έΰ€ΰ€ΰ€΅ ΰ€Ήΰ₯ΰ₯€
#### gh-pages ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ `_site/` ΰ€ΰ€Ύ ΰ€¨ΰ€Ώΰ€°ΰ₯ΰ€ΰ€Ύΰ€£
github ΰ€ͺΰ€° ΰ€
ΰ€ͺΰ€¨ΰ₯ Jekyll ΰ€¬ΰ₯ΰ€²ΰ₯ΰ€ΰ€Ώΰ€ΰ€ ΰ€ΰ€ΰ€ΰ€¨ ΰ€ΰ₯ ΰ€Ήΰ₯ΰ€Έΰ₯ΰ€ ΰ€ΰ€°ΰ€¨ΰ₯ ΰ€ΰ₯ ΰ€¬ΰ€ΰ€Ύΰ€―, ΰ€ΰ€ͺ ΰ€ΰ€ ΰ€
ΰ€²ΰ€ ΰ€Άΰ€Ύΰ€ΰ€Ύ ΰ€ͺΰ€° ΰ€
ΰ€ͺΰ€¨ΰ₯ jekyll ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€΅ΰ€Ώΰ€ΰ€Έΰ€Ώΰ€€ ΰ€ΰ€° ΰ€Έΰ€ΰ€€ΰ₯ ΰ€Ήΰ₯ΰ€, ΰ€ΰ€° ΰ€«ΰ€Ώΰ€° ΰ€¨ΰ€Ώΰ€°ΰ₯ΰ€ΰ€Ώΰ€€ `_site/` ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ₯ ΰ€
ΰ€ͺΰ€¨ΰ₯ `gh-pages` ΰ€Άΰ€Ύΰ€ΰ€Ύ ΰ€ͺΰ€° ΰ€ͺΰ₯ΰ€Ά ΰ€ΰ€° ΰ€Έΰ€ΰ€€ΰ₯ ΰ€Ήΰ₯ΰ€ΰ₯€ ΰ€―ΰ€Ή ΰ€ΰ€ͺΰ€ΰ₯ github ΰ€ΰ₯ ΰ€Έΰ€Ύΰ€₯ ΰ€
ΰ€ͺΰ€¨ΰ₯ ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€΅ΰ€Ώΰ€ΰ€Ύΰ€Έ ΰ€ΰ€Ύ ΰ€ͺΰ₯ΰ€°ΰ€¬ΰ€ΰ€§ΰ€¨ ΰ€ΰ€° ΰ€Έΰ₯ΰ€°ΰ₯ΰ€Έ-ΰ€ΰ€ΰ€ΰ₯ΰ€°ΰ₯ΰ€² ΰ€ΰ€°ΰ€¨ΰ₯ ΰ€ΰ₯ ΰ€
ΰ€¨ΰ₯ΰ€ΰ€€ΰ€Ώ ΰ€¦ΰ₯ΰ€€ΰ€Ύ ΰ€Ήΰ₯ *ΰ€ΰ€ͺΰ€ΰ₯ ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€¬ΰ€¨ΰ€Ύΰ€¨ΰ₯ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ github ΰ€ͺΰ€° ΰ€¨ΰ€Ώΰ€°ΰ₯ΰ€ΰ€° ΰ€Ήΰ₯ΰ€ ΰ€¬ΰ€Ώΰ€¨ΰ€Ύ!*
ΰ€ΰ€ͺ ΰ€―ΰ€Ή ΰ€ΰ€° ΰ€Έΰ€ΰ€€ΰ₯ ΰ€Ήΰ₯ΰ€ ΰ€
ΰ€ͺΰ€¨ΰ₯ Jekyll ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ₯ ΰ€ΰ€ ΰ€
ΰ€²ΰ€ ΰ€Άΰ€Ύΰ€ΰ€Ύ ΰ€ͺΰ€° ΰ€¬ΰ€¨ΰ€Ύΰ€ ΰ€°ΰ€ΰ€ΰ€°, ΰ€ΰ€° ΰ€ΰ₯ΰ€΅ΰ€² `_site/` ΰ€«ΰ€Όΰ₯ΰ€²ΰ₯ΰ€‘ΰ€° ΰ€ΰ₯ ΰ€
ΰ€ͺΰ€¨ΰ₯ gh-pages ΰ€Άΰ€Ύΰ€ΰ€Ύ ΰ€ΰ₯ΰ€ ΰ€ΰ€ΰ€Ώΰ€ ΰ€ΰ€°ΰ€ΰ₯ΰ₯€ ΰ€ΰ₯ΰ€ΰ€ΰ€Ώ ΰ€―ΰ₯ ΰ€ΰ₯ΰ€΅ΰ€² ΰ€«ΰ€Όΰ₯ΰ€²ΰ₯ΰ€‘ΰ€°ΰ₯ΰ€Έ ΰ€ΰ₯ΰ€ ΰ€Έΰ₯ΰ€ΰ₯ΰ€ΰ€Ώΰ€ html ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ ΰ€Ήΰ₯ΰ€, github ΰ€ΰ€¨ΰ₯ΰ€Ήΰ₯ΰ€ ΰ€ΰ€Ώΰ€Έΰ₯ ΰ€ΰ₯ ΰ€
ΰ€¨ΰ₯ΰ€― [gh-pages](https://pages.github.com/) ΰ€Έΰ€Ύΰ€ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ΰ₯ ΰ€€ΰ€°ΰ€Ή ΰ€Ήΰ₯ΰ€Έΰ₯ΰ€ ΰ€ΰ€°ΰ₯ΰ€ΰ€Ύΰ₯€
#### ΰ€ΰ€Έΰ₯ ΰ€Έΰ₯ΰ€΅ΰ€ΰ€Ύΰ€²ΰ€Ώΰ€€ ΰ€ΰ€°ΰ₯ΰ€!
ΰ€―ΰ€Ή ΰ€ͺΰ₯ΰ€°ΰ€ΰ₯ΰ€°ΰ€Ώΰ€―ΰ€Ύ ΰ€ΰ€ ΰ€Έΰ€°ΰ€² ΰ€Έΰ₯ΰ€ΰ₯ΰ€°ΰ€Ώΰ€ͺΰ₯ΰ€ ΰ€ΰ₯ ΰ€Έΰ€Ύΰ€₯ ΰ€¬ΰ€Ήΰ₯ΰ€€ ΰ€ΰ€Έΰ€Ύΰ€¨ ΰ€Ήΰ₯ ΰ€ΰ€Ύΰ€€ΰ₯ ΰ€Ήΰ₯ ΰ€ΰ₯ ΰ€ΰ€ͺΰ€ΰ₯ ΰ€΅ΰ₯ΰ€¬ΰ€Έΰ€Ύΰ€ΰ€ ΰ€ΰ€Ύ ΰ€¨ΰ€Ώΰ€°ΰ₯ΰ€ΰ€Ύΰ€£ ΰ€ΰ€°ΰ₯ΰ€ΰ€Ύ ΰ€ΰ€° `_site/` ΰ€«ΰ€Όΰ₯ΰ€²ΰ₯ΰ€‘ΰ€° ΰ€ΰ₯ ΰ€ΰ€ͺΰ€ΰ₯ gh-pages ΰ€ΰ₯ΰ€ ΰ€ΰ€ΰ€Ώΰ€ ΰ€ΰ€°ΰ₯ΰ€ΰ€Ύΰ₯€ ΰ€¬ΰ€Ήΰ₯ΰ€€ ΰ€Έΰ₯ ΰ€²ΰ₯ΰ€ΰ₯ΰ€ ΰ€ΰ₯ ΰ€ͺΰ€Ύΰ€Έ ΰ€ΰ€ ΰ€Ήΰ₯ΰ₯€ [ΰ€―ΰ€Ήΰ€Ύΰ€ ΰ€ΰ€ ΰ€Ήΰ₯](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/)ΰ₯€ [ΰ€―ΰ€Ήΰ€Ύΰ€ ΰ€ΰ€ ΰ€ΰ€° ΰ€Ήΰ₯](https://gist.github.com/cobyism/4730490)ΰ₯€ ΰ€―ΰ€Ήΰ€Ύΰ€ [ΰ€ΰ₯ΰ€°ΰ₯ ΰ€ͺΰ€¬ΰ₯ΰ€²ΰ€Ώΰ€Ά ΰ€Έΰ₯ΰ€ΰ₯ΰ€°ΰ€Ώΰ€ͺΰ₯ΰ€](https://github.com/untra/polyglot/blob/main/publi.sh) ΰ€Ήΰ₯:
```bash
#! /bin/sh
# change the branch names appropriately
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.it.md 0000664 0000000 0000000 00000015647 15201735340 0020106 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Chi siamo
permalink: about/
lang: it
---
Polyglot Γ¨ un plugin open source per l'internazionalizzazione dei blog Jekyll . Polyglot Γ¨ facile da configurare e utilizzare con qualsiasi progetto, e si adatta alle lingue che vuoi supportare. Con supporto di fallback per contenuti mancanti, relativizzazione automatica degli URL e potenti ricette SEO , Polyglot permette a qualsiasi blog multilingue di concentrarsi sui contenuti senza lavoro superfluo.
_`jekyll-polyglot` non Γ¨ ancora supportato nativamente in github-actions_
### Installazione
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### Gestione delle Lingue Supportate
In `_config.yml`, le seguenti proprietΓ gestiscono quali lingue sono supportate dal tuo sito web. Puoi aggiungere il supporto per una nuova lingua aggiungendola a questi valori (vedi sotto). Le lingue sono identificate dai loro [codici locale](https://developer.chrome.com/webstore/i18n) ufficiali.
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` un array di codici locale che identificano le lingue supportate dal sito web.
* `default_lang:` lingua predefinita per il sito web.
* `exclude_from_localization:` cartelle e directory che fanno parte del sito costruito, ma che non necessitano di localizzazione. Questo serve principalmente a ridurre i tempi di build, e poichΓ© i file asset come immagini e font sono parti importanti del sito, assicura che non vengano inutilmente "tradotti" o duplicati nell'output.
* `url` l'url del tuo sito web statico di produzione.
### Aggiungere una nuova lingua
Supponendo che tu abbia giΓ un sito web funzionante in una singola lingua, aggiungere una nuova lingua non sarΓ banale. _Per creare veramente un sito multilingue, dovresti aspettarti di dover ricreare tutti i tuoi contenuti nella nuova lingua._ Questo puΓ² sembrare un grande impegno, ma considera la traduzione in parti. Il contenuto Γ¨ sovrano; Γ¨ piΓΉ importante che le nuove pagine e i post vengano aggiornati con le parole tradotte. Creare un sito multilingue Γ¨ difficile solo se richiedi che sia perfettamente tradotto dall'inizio.
Prima di tutto, tu (e il tuo team, e anche i tuoi manager se ne hai qualcuno in giro) dovreste discutere e scegliere quali contenuti devono essere tradotti nel nuovo sito. Devi scegliere i tuoi contenuti di base preferiti da tradurre. Considera le analisi, le pagine e i post popolari, e il flusso degli utenti attuali e futuri verso il tuo sito. In caso di dubbio, dai prioritΓ alle pagine rispetto ai vecchi post del blog. Se significa lanciare una nuova lingua prima, i post legacy potrebbero richiedere piΓΉ sforzo di quanto valga tradurli.
In secondo luogo, devi (o dovresti fortemente) fornire una copertura del 100% dei contenuti ricchi attraverso il tuo sito. Queste sono piccole stringhe incorporate in modi piΓΉ complessi. Ci sono diversi modi per iterare sui contenuti ricchi. Ricorda, devi supportare tutte le piccole stringhe di lingua nei tuoi contenuti ricchi.
#### Contenuti Multilingue
I contenuti del sito web sono di due tipi: **base** e **ricchi**.
I contenuti base sono il testo semplice di post del blog, pagine e contenuti non interattivi. Pensa a pagine e post. I contenuti base sono il carburante per i click del tuo sito. Polyglot offre supporto di fallback per i contenuti base.
I contenuti ricchi sono interattivi, appariscenti e composti da stringhe piΓΉ brevi. Pensa a navbar e dropdown. I contenuti ricchi sono piΓΉ tecnici e mantengono i visitatori sul sito. _Non c'Γ¨ supporto di fallback per i contenuti ricchi mancanti._
#### Strumenti Liquid
I seguenti strumenti liquid sono disponibili per l'uso con jekyll-polyglot:
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages` punta direttamente all'array `languages` in _config.yml. PuΓ² essere accessibile tramite liquid.
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang` punta direttamente alla stringa `default_lang` in _config.yml. PuΓ² essere accessibile tramite liquid.
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang` è il codice locale per cui la pagina viene costruita. Questo è `"de"` per la versione tedesca di una pagina, `"es"` per la versione spagnola, e così via. Può essere accessibile tramite liquid.
Usando questi strumenti, puoi specificare come allegare i contenuti ricchi corretti.
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
La variabile `page.rendered_lang` indica la lingua effettiva del contenuto di una pagina, permettendo ai template di rilevare quando una pagina viene servita come contenuto di fallback.
### Supporto GitHub Pages
Per impostazione predefinita, GitHub impedisce ai [blog Jekyll di usare plugin](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides). Questo viene fatto intenzionalmente per prevenire l'esecuzione di codice malevolo sui server GitHub. Anche se questo rende l'uso di Polyglot (e altri plugin Jekyll) piΓΉ difficile, Γ¨ comunque fattibile.
#### Costruire `_site/` su gh-pages
Invece di ospitare il tuo motore di blogging Jekyll su GitHub, puoi sviluppare il tuo sito Jekyll su un branch separato, e poi pushare i contenuti costruiti di `_site/` sul tuo branch `gh-pages`. Questo ti permette di gestire e controllare la versione dello sviluppo del tuo sito con GitHub *senza dover fare affidamento su GitHub per costruire il tuo sito!*
Puoi farlo mantenendo i tuoi contenuti Jekyll su un branch separato, e committando solo la cartella `_site/` sul tuo branch gh-pages. PoichΓ© queste sono solo pagine HTML statiche in cartelle, GitHub le ospiterΓ come qualsiasi altro contenuto [gh-pages](https://pages.github.com/).
#### Automatizzalo!
Questo processo Γ¨ enormemente facilitato con un semplice script che costruirΓ il tuo sito e committa la cartella `_site/` sul tuo gh-pages. Molte persone ne hanno uno. [Eccone uno](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/). [Eccone un altro](https://gist.github.com/cobyism/4730490). Ecco il [mio script di pubblicazione](https://github.com/untra/polyglot/blob/main/publi.sh):
```bash
#! /bin/sh
# cambia i nomi dei branch appropriatamente
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.ja.md 0000664 0000000 0000000 00000020374 15201735340 0020055 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Polyglotγ«γ€γγ¦
permalink: about/
lang: ja
---
Polyglot γ―Jekyll γγγ°η¨γγͺγΌγγ³γ½γΌγΉε½ιεγγ©γ°γ€γ³γ§γγPolyglotγ―δ»»ζγγγγΈγ§γ―γγ§η°‘εγ«γ»γγγ’γγγγ¦δ½Ώη¨γ§γγγ΅γγΌγγγγθ¨θͺγ«ζ‘εΌ΅γ§γγΎγγζ¬ θ½γ³γ³γγ³γγγγ©γΌγ«γγγ―γ΅γγΌγγθͺεURLηΈε―ΎεγεΌ·εγͺSEOγ¬γ·γ γ«γγγPolyglotγ―δ»»ζγε€θ¨θͺγγγ°γθ€ιγͺδ½ζ₯γͺγγ«γ³γ³γγ³γγ«ιδΈγ§γγγγγ«γγΎγγ
_`jekyll-polyglot`γ―γΎγ github-actionsγ§γγ€γγ£γγ΅γγΌγγγγ¦γγΎγγ_
### γ€γ³γΉγγΌγ«
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### γ΅γγΌγθ¨θͺγη‘η
`_config.yml`γ§γδ»₯δΈγγγγγγ£γγ¦γ§γγ΅γ€γγ§γ΅γγΌγγγγθ¨θͺγη‘ηγγΎγγγγγγε€γ«ζ°γγθ¨θͺγθΏ½ε γγγγ¨γ§γ΅γγΌγγζδΎγ§γγΎγοΌδΈθ¨εη
§οΌγθ¨θͺγ―ε
¬εΌγ[γγ±γΌγ«γ³γΌγ](https://developer.chrome.com/webstore/i18n)γ§θε₯γγγΎγγ
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` γ¦γ§γγ΅γ€γγ§γ΅γγΌγγγγθ¨θͺγθε₯γγγγ±γΌγ«γ³γΌγγι
εγ
* `default_lang:` γ¦γ§γγ΅γ€γγγγγ©γ«γθ¨θͺγ
* `exclude_from_localization:` γγ«γγγγγ¦γ§γγ΅γ€γγδΈι¨γ§γγγγγγΌγ«γ©γ€γΊγγεΏ
θ¦γγͺγγγ©γ«γγ¨γγ£γ¬γ―γγͺγγγγ―δΈ»γ«γγ«γζιγηηΈγγγγγ§γγγη»εγγγ©γ³γγͺγ©γγ’γ»γγγγ‘γ€γ«γ―γ¦γ§γγ΅γ€γγ倧γγͺι¨εγε γγγγγεΊεγ§δΈεΏ
θ¦γ«γ翻訳γγγγγθ€θ£½γγγγγγͺγγγ¨γδΏθ¨ΌγγΎγγ
* `url` ζ¬ηͺιηγ¦γ§γγ΅γ€γγURLγ
### ζ°γγθ¨θͺγθΏ½ε
γγ§γ«ζ©θ½γγεδΈθ¨θͺγγ¦γ§γγ΅γ€γγγγγ¨δ»εγγγ¨γζ°γγθ¨θͺγθΏ½ε γ―η°‘εγ§γ―γγγΎγγγ_ηγε€θ¨θͺγ¦γ§γγ΅γ€γγδ½ζγγγ«γ―γγγΉγ¦γγ³γ³γγ³γγζ°γγθ¨θͺγ§εδ½ζγγεΏ
θ¦γγγγγ¨γδΊζγγΉγγ§γγ_ γγγ―倧γγͺδ½ζ₯γγγγ«ζγγγγγγγΎγγγγ翻訳γι¨εηγ«θγγ¦γγ γγγγ³γ³γγ³γγ―ηζ§γ§γγζ°γγγγΌγΈγ¨ζη¨Ώγζ΄ζ°γγγ翻訳γεεΎγγγγ¨γγγιθ¦γ§γγε€θ¨θͺγ¦γ§γγ΅γ€γγδ½ζγ―γζεγγεη§γ«ηΏ»θ¨³γγγγγ¨γθ¦ζ±γγε ΄εγ«γγΏε°ι£γ§γγ
γΎγγγγͺγοΌγ¨γγΌγ γγγγ¦γγγΌγΈγ£γΌγγγγ°ε½ΌγγοΌγ―γζ°γγγ¦γ§γγ΅γ€γγγγγ«γ©γγ³γ³γγ³γγ翻訳γγεΏ
θ¦γγγγγθ°θ«γγ¦ιΈζγγεΏ
θ¦γγγγΎγγ翻訳γγεͺε
ηγͺεΊζ¬γ³γ³γγ³γγιΈζγγεΏ
θ¦γγγγΎγγεζγδΊΊζ°γγγγγΌγΈγ¨γγγ°ζη¨Ώγγγγ¦ηΎε¨γγγ³ε°ζ₯γγ¦γΌγΆγΌγγ¦γ§γγ΅γ€γγΈγγγγΌγθζ
γγ¦γγ γγγηεγγγε ΄εγ―γε€γγγγ°ζη¨ΏγγγγγΌγΈγεͺε
γγ¦γγ γγγζ°γγθ¨θͺγγγζ©γγγΌγ³γγγγγ¨γζε³γγε ΄εγε€γζη¨Ώγ―翻訳γγδΎ‘ε€γγγε€γγε΄εγεΏ
θ¦γ¨γγγγγγγΎγγγ
欑γ«γγ΅γ€γε
¨δ½γ§γͺγγγ³γ³γγ³γγ100%γ«γγ¬γγΈγζδΎγγεΏ
θ¦γγγγΎγοΌγΎγγ―εΌ·γγε§γγγΎγοΌγγγγγ―γγθ€ιγͺζΉζ³γ§εγθΎΌγΎγγε°γγͺζεεγ§γγγͺγγγ³γ³γγ³γγεεΎ©ε¦ηγγζΉζ³γ―θ€ζ°γγγΎγγγͺγγγ³γ³γγ³γγγγΉγ¦γε°γγͺζεεγγγΉγ¦γθ¨θͺγ§γ΅γγΌγγγεΏ
θ¦γγγγγ¨γεΏγγͺγγ§γγ γγγ
#### ε€θ¨θͺγ³γ³γγ³γ
γ¦γ§γγ΅γ€γγγ³γ³γγ³γγ«γ―2η¨ι‘γγγΎγοΌ**εΊζ¬**γ¨**γͺγγ**γ
εΊζ¬γ³γ³γγ³γγ―γγγγ°ζη¨ΏγγγΌγΈγιγ€γ³γΏγ©γ―γγ£γγ³γ³γγ³γγγγ¬γΌγ³γγγΉγγ§γγγγΌγΈγ¨ζη¨Ώγθγγ¦γγ γγγεΊζ¬γ³γ³γγ³γγ―γ¦γ§γγ΅γ€γγγ―γͺγγ―γηζγ§γγPolyglotγ―εΊζ¬γ³γ³γγ³γγγγ©γΌγ«γγγ―γ΅γγΌγγζδΎγγΎγγ
γͺγγγ³γ³γγ³γγ―γ€γ³γΏγ©γ―γγ£γγ§ζ΄Ύζγ§γγγηγζεεγ§ζ§ζγγγ¦γγΎγγγγγ²γΌγ·γ§γ³γγΌγ¨γγγγγγ¦γ³γθγγ¦γγ γγγγͺγγγ³γ³γγ³γγ―γγζθ‘ηγ§γθ¨ͺεθ
γγ΅γ€γγ«ηγγΎγγ_ζ¬ θ½γγγͺγγγ³γ³γγ³γγγγ©γΌγ«γγγ―γ΅γγΌγγ―γγγΎγγγ_
#### LiquidγγΌγ«
δ»₯δΈγLiquidγγΌγ«γ―jekyll-polyglotγ§δ½Ώη¨γ§γγΎγοΌ
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages`γ―_config.ymlγ`languages`ι
εγη΄ζ₯ζγγΎγγLiquidγιγγ¦γ’γ―γ»γΉγ§γγΎγγ
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang`γ―_config.ymlγ`default_lang`ζεεγη΄ζ₯ζγγΎγγLiquidγιγγ¦γ’γ―γ»γΉγ§γγΎγγ
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang`γ―γγΌγΈγγγ«γγγγ¦γγγγ±γΌγ«γ³γΌγγ§γγγγΌγΈγγγ€γθͺηγ―`"de"`γγΉγγ€γ³θͺηγ―`"es"`γͺγ©γ§γγLiquidγιγγ¦γ’γ―γ»γΉγ§γγΎγγ
γγγγγγΌγ«γδ½Ώη¨γγ¦γζ£γγγͺγγγ³γ³γγ³γγζ·»δ»γγζΉζ³γζεγ§γγΎγγ
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
`page.rendered_lang`ε€ζ°γ―γγΌγΈγ³γ³γγ³γγειγθ¨θͺγη€Ίγγγγ³γγ¬γΌγγγγΌγΈγγγ©γΌγ«γγγ―γ³γ³γγ³γγ¨γγ¦ζδΎγγγ¦γγγγ©γγγζ€εΊγ§γγγγγ«γγΎγγ
### Github Pagesγ΅γγΌγ
γγγ©γ«γγ§γ―γGithubγ―[Jekyllγγγ°γγγ©γ°γ€γ³γδ½Ώη¨γγγγ¨γι²γγΎγ](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides)γγγγ―ζͺζγγγγ³γΌγγGithubγ΅γΌγγΌγ§εθ‘γγγγγ¨γι²γγγγ«ζε³ηγ«θ‘γγγ¦γγΎγγγγγ«γγPolyglotοΌγγγ³δ»γJekyllγγ©γ°γ€γ³οΌγδ½Ώη¨γ―ι£γγγͺγγΎγγγγγγ§γε―θ½γ§γγ
#### `_site/`γgh-pagesγ«γγ«γγγ
Jekyllγγγ°γ¨γ³γΈγ³γGithubγ§γγΉγγγ代γγγ«γε₯γγγ©γ³γγ§Jekyllγ¦γ§γγ΅γ€γγιηΊγγγγ«γγγγ`_site/`γ³γ³γγ³γγ`gh-pages`γγ©γ³γγ«γγγ·γ₯γ§γγΎγγγγγ«γγγ*Githubγ«γ¦γ§γγ΅γ€γγγγ«γγγγγγ¨γͺγ*γGithubγ§γ¦γ§γγ΅γ€γιηΊγη‘ηγγγ³γ½γΌγΉη‘ηγ§γγΎγοΌ
Jekyllγ³γ³γγ³γγε₯γγγ©γ³γγ§η‘ηγγ`_site/`γγ©γ«γγγΏγgh-pagesγγ©γ³γγ«γ³γγγγγγγ¨γ§γγγθ‘γγΎγγγγγγ―γγ©γ«γε
γιηHTMLγγΌγΈγ«ιγγͺγγγγGithubγ―δ»γ[gh-pages](https://pages.github.com/)γ³γ³γγ³γγ¨εζ§γ«γγΉγγγΎγγ
#### θͺεεγγΎγγγοΌ
γγγγγ»γΉγ―γγ¦γ§γγ΅γ€γγγγ«γγγ¦`_site/`γγ©γ«γγgh-pagesγ«γ³γγγγγγ·γ³γγ«γͺγΉγ―γͺγγγ§ε€§εΉ
γ«ζ―ζ΄γγγΎγγε€γγδΊΊγγγγζγ£γ¦γγΎγγ[γγ‘γγ«δΈγ€](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/)γ[γγ‘γγ«γγδΈγ€](https://gist.github.com/cobyism/4730490)γγγ‘γγ―[η§γε
¬ιγΉγ―γͺγγ](https://github.com/untra/polyglot/blob/main/publi.sh)γ§γοΌ
```bash
#! /bin/sh
# γγ©γ³γεγι©εε€ζ΄γγ¦γγ γγ
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.ko.md 0000664 0000000 0000000 00000017052 15201735340 0020073 0 ustar 00root root 0000000 0000000 ---
layout: page
title: μκ°
permalink: about/
lang: ko
---
Polyglot μ Jekyll λΈλ‘κ·Έλ₯Ό μν μ€νμμ€ νμ§ν νλ¬κ·ΈμΈμ
λλ€. Polyglotμ λͺ¨λ νλ‘μ νΈμ μ μ© λ° μ¬μ©νκΈ°κ° μ¬μ°λ©°, μ¬λ¬λΆμ΄ μ§μνκ³ μ νλ μΈμ΄ μμ λ§μΆ° νμ₯λ©λλ€. λλ½λ 컨ν
μΈ μ λν ν΄λ°± μ§μ, μλ url μλν, κ·Έλ¦¬κ³ κ°λ ₯ν SEO λ μνΌ λ‘, Polyglotμ κ·Έ μ΄λ€ λ€κ΅μ΄ λΈλ‘κ·ΈλΌλ κ·μ°μ μμμ
λμ 컨ν
μΈ μ μ§μ€ν μ μλλ‘ λμμ€λλ€.
_`jekyll-polyglot`μ μμ§ github-actionsμμ κΈ°λ³Έμ μΌλ‘ μ§μλμ§ μμ΅λλ€_
### μ€μΉ
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### μ§μ μΈμ΄ κ΄λ¦¬
`_config.yml`μμ λ€μ μμ±λ€μ΄ μΉμ¬μ΄νΈμμ μ§μνλ μΈμ΄λ₯Ό κ΄λ¦¬ν©λλ€. μλ κ°μ μ μΈμ΄λ₯Ό μΆκ°νμ¬ μ§μν μ μμ΅λλ€(μλ μ°Έμ‘°). μΈμ΄λ 곡μ [λ‘μΌμΌ μ½λ](https://developer.chrome.com/webstore/i18n)λ‘ μλ³λ©λλ€.
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` μΉμ¬μ΄νΈμμ μ§μνλ μΈμ΄λ₯Ό μλ³νλ λ‘μΌμΌ μ½λ λ°°μ΄μ
λλ€.
* `default_lang:` μΉμ¬μ΄νΈμ κΈ°λ³Έ μΈμ΄μ
λλ€.
* `exclude_from_localization:` λΉλλ μΉμ¬μ΄νΈμ μΌλΆμ΄μ§λ§ νμ§νκ° νμ μλ ν΄λμ λλ ν 리μ
λλ€. μ΄λ μ£Όλ‘ λΉλ μκ°μ λ¨μΆνκΈ° μν κ²μ΄λ©°, μ΄λ―Έμ§μ ν°νΈ κ°μ μμ
νμΌμ΄ μΉμ¬μ΄νΈμ ν° λΆλΆμ μ°¨μ§νλ―λ‘ μΆλ ₯μμ λΆνμνκ² "λ²μ"λκ±°λ 볡μ λμ§ μλλ‘ ν©λλ€.
* `url` νλ‘λμ
μ μ μΉμ¬μ΄νΈμ URLμ
λλ€.
### μ μΈμ΄ μΆκ°
μ΄λ―Έ κΈ°λ₯νλ λ¨μΌ μΈμ΄ μΉμ¬μ΄νΈκ° μλ€κ³ κ°μ νλ©΄, μ μΈμ΄λ₯Ό μΆκ°νλ κ²μ κ°λ¨νμ§ μμ κ²μ
λλ€. _μ§μ ν λ€κ΅μ΄ μΉμ¬μ΄νΈλ₯Ό λ§λ€λ €λ©΄ λͺ¨λ 컨ν
μΈ λ₯Ό μ μΈμ΄λ‘ λ€μ λ§λ€μ΄μΌ ν κ²μΌλ‘ μμν΄μΌ ν©λλ€._ μ΄κ²μ΄ ν° μμ
μ²λΌ λ³΄μΌ μ μμ§λ§, λ²μμ λΆλΆμ μΌλ‘ κ³ λ €νμΈμ. 컨ν
μΈ κ° μμ
λλ€; μ νμ΄μ§μ κ²μλ¬Όμ΄ λ²μλ ν
μ€νΈλ₯Ό λ°λ κ²μ΄ λ μ€μν©λλ€. λ€κ΅μ΄ μΉμ¬μ΄νΈλ₯Ό λ§λλ κ²μ μ²μλΆν° μλ²½νκ² λ²μλκΈ°λ₯Ό μꡬνλ κ²½μ°μλ§ μ΄λ ΅μ΅λλ€.
첫째, μ¬λ¬λΆ(κ·Έλ¦¬κ³ ν, κ·Έλ¦¬κ³ λ§€λμ κ° μλ€λ©΄ 맀λμ λ)μ μ μΉμ¬μ΄νΈλ₯Ό μν΄ μ΄λ€ 컨ν
μΈ λ₯Ό λ²μν΄μΌ νλμ§ λ
Όμνκ³ μ νν΄μΌ ν©λλ€. λ²μν κΈ°λ³Έ 컨ν
μΈ μ μ°μ μμλ₯Ό μ νν΄μΌ ν©λλ€. λΆμ λ°μ΄ν°, μΈκΈ° μλ νμ΄μ§μ λΈλ‘κ·Έ κ²μλ¬Ό, κ·Έλ¦¬κ³ νμ¬μ λ―Έλ μ¬μ©μμ μΉμ¬μ΄νΈ μ μ
νλ¦μ κ³ λ €νμΈμ. μμ¬μ€λ¬μΈ λλ μ€λλ λΈλ‘κ·Έ κ²μλ¬Όλ³΄λ€ νμ΄μ§λ₯Ό μ°μ μνμΈμ. μ μΈμ΄λ₯Ό λ 빨리 μΆμνλ€λ κ²μ μ€λλ κ²μλ¬Όμ΄ λ²μν κ°μΉλ³΄λ€ λ λ§μ λ
Έλ ₯μ΄ νμν μ μλ€λ κ²μ μλ―Έν©λλ€.
λμ§Έ, μ¬μ΄νΈ μ 체μμ λ¦¬μΉ μ»¨ν
μΈ μ 100% 컀λ²λ¦¬μ§λ₯Ό μ 곡ν΄μΌ ν©λλ€(λλ κ°λ ₯ν κΆμ₯λ©λλ€). μ΄κ²λ€μ λ 볡μ‘ν λ°©μμΌλ‘ μλ² λλ μμ λ¬Έμμ΄λ€μ
λλ€. λ¦¬μΉ μ»¨ν
μΈ λ₯Ό λ°λ³΅νλ μ¬λ¬ κ°μ§ λ°©λ²μ΄ μμ΅λλ€. λ¦¬μΉ μ»¨ν
μΈ μ λͺ¨λ μμ λ¬Έμμ΄μ λͺ¨λ μΈμ΄λ‘ μ§μν΄μΌ νλ€λ κ²μ κΈ°μ΅νμΈμ.
#### λ€κ΅μ΄ 컨ν
μΈ
μΉμ¬μ΄νΈ 컨ν
μΈ λ λ κ°μ§ μ’
λ₯κ° μμ΅λλ€: **κΈ°λ³Έ** κ³Ό **리μΉ**.
κΈ°λ³Έ 컨ν
μΈ λ λΈλ‘κ·Έ κ²μλ¬Ό, νμ΄μ§, λΉλνν 컨ν
μΈ μ νλ« ν
μ€νΈμ
λλ€. νμ΄μ§μ κ²μλ¬Όμ μκ°νμΈμ. κΈ°λ³Έ 컨ν
μΈ λ μΉμ¬μ΄νΈ ν΄λ¦μ μ°λ£μ
λλ€. Polyglotμ κΈ°λ³Έ 컨ν
μΈ μ ν΄λ°± μ§μμ μ 곡ν©λλ€.
λ¦¬μΉ μ»¨ν
μΈ λ λννμ΄κ³ , νλ €νλ©°, λ 짧μ λ¬Έμμ΄λ‘ ꡬμ±λ©λλ€. λ΄λΉκ²μ΄μ
λ°μ λλ‘λ€μ΄μ μκ°νμΈμ. λ¦¬μΉ μ»¨ν
μΈ λ λ κΈ°μ μ μ΄λ©°, λ°©λ¬Έμλ₯Ό μ¬μ΄νΈμ λ¨Έλ¬Όκ² ν©λλ€. _λλ½λ λ¦¬μΉ μ»¨ν
μΈ μ λν ν΄λ°± μ§μμ μμ΅λλ€._
#### Liquid λꡬ
λ€μ Liquid λꡬλ€μ jekyll-polyglotκ³Ό ν¨κ» μ¬μ©ν μ μμ΅λλ€:
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages`λ _config.ymlμ `languages` λ°°μ΄μ μ§μ κ°λ¦¬ν΅λλ€. Liquidλ₯Ό ν΅ν΄ μ κ·Όν μ μμ΅λλ€.
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang`μ _config.ymlμ `default_lang` λ¬Έμμ΄μ μ§μ κ°λ¦¬ν΅λλ€. Liquidλ₯Ό ν΅ν΄ μ κ·Όν μ μμ΅λλ€.
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang`μ νμ΄μ§κ° λΉλλλ λ‘μΌμΌ μ½λμ
λλ€. νμ΄μ§μ λ
μΌμ΄ λ²μ μ `"de"`, μ€νμΈμ΄ λ²μ μ `"es"` λ±μ
λλ€. Liquidλ₯Ό ν΅ν΄ μ κ·Όν μ μμ΅λλ€.
μ΄ λꡬλ€μ μ¬μ©νμ¬ μ¬λ°λ₯Έ λ¦¬μΉ μ»¨ν
μΈ λ₯Ό 첨λΆνλ λ°©λ²μ μ§μ ν μ μμ΅λλ€.
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
`page.rendered_lang` λ³μλ νμ΄μ§ 컨ν
μΈ μ μ€μ μΈμ΄λ₯Ό λνλ΄λ©°, ν
νλ¦Ώμ΄ νμ΄μ§κ° ν΄λ°± 컨ν
μΈ λ‘ μ 곡λκ³ μλμ§ κ°μ§ν μ μκ² ν©λλ€.
### Github Pages μ§μ
κΈ°λ³Έμ μΌλ‘ Githubμ [Jekyll λΈλ‘κ·Έκ° νλ¬κ·ΈμΈμ μ¬μ©νλ κ²μ λ°©μ§](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides)ν©λλ€. μ΄κ²μ μ
μ± μ½λκ° Github μλ²μμ μ€νλλ κ²μ λ°©μ§νκΈ° μν΄ μλμ μΌλ‘ μνλ©λλ€. μ΄κ²μ΄ Polyglot(λ° λ€λ₯Έ Jekyll νλ¬κ·ΈμΈ) μ¬μ©μ λ μ΄λ ΅κ² λ§λ€μ§λ§, μ¬μ ν κ°λ₯ν©λλ€.
#### `_site/`λ₯Ό gh-pagesλ‘ λΉλνκΈ°
Githubμμ Jekyll λΈλ‘κΉ
μμ§μ νΈμ€ν
νλ λμ , λ³λμ λΈλμΉμμ Jekyll μΉμ¬μ΄νΈλ₯Ό κ°λ°ν λ€μ λΉλλ `_site/` 컨ν
μΈ λ₯Ό `gh-pages` λΈλμΉλ‘ νΈμν μ μμ΅λλ€. μ΄λ κ² νλ©΄ *Githubμ μμ‘΄νμ§ μκ³ λ* GithubμΌλ‘ μΉμ¬μ΄νΈ κ°λ°μ κ΄λ¦¬νκ³ μμ€ μ μ΄ν μ μμ΅λλ€!
λ³λμ λΈλμΉμμ Jekyll 컨ν
μΈ λ₯Ό μ μ§νκ³ `_site/` ν΄λλ§ gh-pages λΈλμΉμ 컀λ°νλ©΄ λ©λλ€. μ΄κ²λ€μ ν΄λ μμ μ μ HTML νμ΄μ§μ λΆκ³Όνλ―λ‘ Githubμ λ€λ₯Έ [gh-pages](https://pages.github.com/) 컨ν
μΈ μ λ§μ°¬κ°μ§λ‘ νΈμ€ν
ν©λλ€.
#### μλννμΈμ!
μ΄ νλ‘μΈμ€λ μΉμ¬μ΄νΈλ₯Ό λΉλνκ³ `_site/` ν΄λλ₯Ό gh-pagesμ 컀λ°νλ κ°λ¨ν μ€ν¬λ¦½νΈλ‘ ν¬κ² λμμ΄ λ©λλ€. λ§μ μ¬λλ€μ΄ νλμ© κ°μ§κ³ μμ΅λλ€. [μ¬κΈ° νλ μμ΅λλ€](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/). [μ¬κΈ° λ νλ μμ΅λλ€](https://gist.github.com/cobyism/4730490). μ¬κΈ° [μ κ²μ μ€ν¬λ¦½νΈ](https://github.com/untra/polyglot/blob/main/publi.sh)κ° μμ΅λλ€:
```bash
#! /bin/sh
# λΈλμΉ μ΄λ¦μ μ μ νκ² λ³κ²½νμΈμ
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.nl.md 0000664 0000000 0000000 00000015561 15201735340 0020076 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Over
permalink: about/
lang: nl
---
Polyglot is een open source plugin-in voor internationalisering van Jekyll -blogs. Polyglot is eenvoudig te installeren en te gebruiken, en het schaalt met de taal die je wil aanbieden. Het biedt fallback voor ontbrekende inhoud, automatische URL-relativering en krachtige SEO-recepten . Polyglot geeft je de mogelijkheid bij een meertalige blog op de inhoud te richten en niet bezig te zijn met technische details.
_`jekyll-polyglot` wordt nog niet native ondersteund in github-actions_
### Installatie
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### Ondersteunde talen beheren
In `_config.yml` beheren de volgende eigenschappen welke talen door je website worden ondersteund. Je kunt ondersteuning voor een nieuwe taal toevoegen door deze aan deze waarden toe te voegen (zie hieronder). Talen worden geΓ―dentificeerd door hun officiΓ«le [locale codes](https://developer.chrome.com/webstore/i18n).
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` een array van locale codes die de door de website ondersteunde talen identificeren.
* `default_lang:` standaardtaal voor de website.
* `exclude_from_localization:` mappen en directories die deel uitmaken van de gebouwde website, maar niet gelokaliseerd hoeven te worden. Dit is voornamelijk om bouwtijden te verkorten, en omdat asset-bestanden zoals afbeeldingen en lettertypen grote delen van de website zijn, zorgt dit ervoor dat ze niet onnodig worden "vertaald" of gedupliceerd in de output.
* `url` de url van je productie statische website.
### Een nieuwe taal toevoegen
Ervan uitgaande dat je al een functionele eentalige website hebt, zal het toevoegen van een nieuwe taal niet triviaal zijn. _Om echt een meertalige website te maken, moet je verwachten dat je al je content in de nieuwe taal opnieuw moet maken._ Dit lijkt misschien een grote onderneming, maar beschouw de vertaling in delen. Content is koning; het is belangrijker dat nieuwe pagina's en berichten bijgewerkte vertalingen krijgen. Het maken van een meertalige website is alleen moeilijk als je eist dat het vanaf het begin perfect vertaald is.
Ten eerste moeten jij (en je team, en ook je managers als je die hebt) bespreken en kiezen welke content je moet vertalen voor de nieuwe website. Je moet je gewenste basiscontent kiezen om te vertalen. Overweeg analytics, populaire pagina's en blogberichten, en de stroom van huidige en toekomstige gebruikers naar je website. Bij twijfel, geef prioriteit aan pagina's boven oude blogberichten. Als het betekent dat je een nieuwe taal eerder kunt lanceren, zijn oude berichten misschien meer moeite waard dan ze waard zijn om te vertalen.
Ten tweede moet je (of zou je sterk moeten) 100% dekking van rijke content over je site bieden. Dit zijn kleine strings die op complexere manieren zijn ingebed. Er zijn meerdere manieren om door rijke content te itereren. Vergeet niet dat je alle kleine strings in alle talen in je rijke content moet ondersteunen.
#### Meertalige content
Website-content komt in twee smaken: **basis** en **rijk**.
Basiscontent is de platte tekst van blogberichten, pagina's en niet-interactieve content. Denk aan pagina's en berichten. Basiscontent is de brandstof voor de klikken op je website. Polyglot biedt fallback-ondersteuning voor basiscontent.
Rijke content is interactief, flitsend en bestaat uit kortere strings. Denk aan navigatiebalken en dropdown-menu's. Rijke content is meer technisch en houdt je bezoekers op de site. _Er is geen fallback-ondersteuning voor ontbrekende rijke content._
#### Liquid-tools
De volgende Liquid-tools zijn beschikbaar voor gebruik met jekyll-polyglot:
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages` wijst direct naar de `languages` array in _config.yml. Het kan worden benaderd via Liquid.
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang` wijst direct naar de `default_lang` string in _config.yml. Het kan worden benaderd via Liquid.
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang` is de locale code waarvoor de pagina wordt gebouwd. Dit is `"de"` voor de Duitse versie van een pagina, `"es"` voor de Spaanse versie, enzovoort. Het kan worden benaderd via Liquid.
Met behulp van deze tools kun je specificeren hoe de juiste rijke content moet worden gekoppeld.
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
De variabele `page.rendered_lang` geeft de werkelijke taal van de pagina-inhoud aan, waardoor templates kunnen detecteren wanneer een pagina als fallback-content wordt weergegeven.
### Github Pages-ondersteuning
Standaard voorkomt Github dat [Jekyll-blogs plugins gebruiken](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides). Dit wordt opzettelijk gedaan om te voorkomen dat kwaadaardige code op Github-servers wordt uitgevoerd. Hoewel dit het gebruik van Polyglot (en andere Jekyll-plugins) moeilijker maakt, is het nog steeds mogelijk.
#### `_site/` bouwen naar gh-pages
In plaats van je Jekyll-blogging-engine op Github te hosten, kun je je Jekyll-website op een aparte branch ontwikkelen en vervolgens de gebouwde `_site/`-inhoud naar je `gh-pages`-branch pushen. Dit stelt je in staat om je websiteontwikkeling te beheren en te versiebeheren met Github *zonder te hoeven vertrouwen op Github om je website te bouwen!*
Je kunt dit doen door je Jekyll-content op een aparte branch te onderhouden en alleen de `_site/`-map naar je gh-pages-branch te committen. Omdat dit gewoon statische HTML-pagina's in mappen zijn, zal Github ze hosten zoals elke andere [gh-pages](https://pages.github.com/)-content.
#### Automatiseer het!
Dit proces wordt enorm geholpen met een eenvoudig script dat je website bouwt en de `_site/`-map naar je gh-pages commit. Veel mensen hebben er een. [Hier is er een](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/). [Hier is er nog een](https://gist.github.com/cobyism/4730490). Hier is [mijn publicatiescript](https://github.com/untra/polyglot/blob/main/publi.sh):
```bash
#! /bin/sh
# verander de branch-namen naar behoren
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.pt-BR.md 0000664 0000000 0000000 00000015655 15201735340 0020415 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Sobre
permalink: about/
lang: pt-BR
---
Polyglot Γ© um plugin de cΓ³digo aberto de internacionalização para blogs Jekyll . Polyglot Γ© fΓ‘cil de configurar e usar com qualquer projeto e adapta para os idiomas que vocΓͺ deseja dar suporte. Com redirecionamento para a lΓngua principal em caso de conteΓΊdo ausente, relativização automΓ‘tica de url e receitas poderosas de SEO , Polyglot permite que qualquer blog multilΓngue se concentre no conteΓΊdo sem o trabalho braΓ§al.
_`jekyll-polyglot` ainda nΓ£o Γ© suportado nativamente no github-actions_
### Instalação
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### Gerenciando idiomas suportados
No `_config.yml`, as seguintes propriedades gerenciam quais idiomas sΓ£o suportados pelo seu site. VocΓͺ pode fornecer suporte para um novo idioma adicionando-o a esses valores (veja abaixo). Os idiomas sΓ£o identificados pelos seus [cΓ³digos de localidade](https://developer.chrome.com/webstore/i18n) oficiais.
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` um array de cΓ³digos de localidade identificando os idiomas suportados pelo site.
* `default_lang:` idioma padrΓ£o do site.
* `exclude_from_localization:` pastas e diretΓ³rios que fazem parte do site construΓdo, mas nΓ£o precisam ser localizados. Isso Γ© principalmente para reduzir os tempos de build, e como arquivos de assets como imagens e fontes sΓ£o grandes partes do site, garante que eles nΓ£o sejam desnecessariamente "traduzidos" ou duplicados na saΓda.
* `url` a url do seu site estÑtico de produção.
### Adicionando um novo idioma
Assumindo que vocΓͺ jΓ‘ tem um site funcional em um ΓΊnico idioma, adicionar um novo idioma nΓ£o serΓ‘ trivial. _Para realmente criar um site multilΓngue, vocΓͺ deve esperar ter que recriar todo o seu conteΓΊdo no novo idioma._ Isso pode parecer uma grande tarefa, mas considere a tradução em partes. ConteΓΊdo Γ© rei; Γ© mais importante que novas pΓ‘ginas e posts recebam traduçáes atualizadas. Criar um site multilΓngue sΓ³ Γ© difΓcil se vocΓͺ exigir que ele seja perfeitamente traduzido desde o inΓcio.
Primeiro, vocΓͺ (e sua equipe, e seus gerentes tambΓ©m, se vocΓͺ tiver alguns) devem discutir e escolher qual conteΓΊdo vocΓͺ precisa traduzir para o novo site. VocΓͺ deve escolher seu conteΓΊdo bΓ‘sico preferido para traduzir. Considere anΓ‘lises, pΓ‘ginas e posts populares, e o fluxo de usuΓ‘rios atuais e futuros para o seu site. Em caso de dΓΊvida, priorize pΓ‘ginas sobre posts de blog antigos. Se isso significa lanΓ§ar um novo idioma mais cedo, posts antigos podem exigir mais esforΓ§o do que valem para traduzir.
Segundo, vocΓͺ deve (ou deveria fortemente) fornecer 100% de cobertura de conteΓΊdo rico em todo o seu site. Essas sΓ£o pequenas strings incorporadas de maneiras mais complexas. Existem vΓ‘rias maneiras de iterar sobre conteΓΊdo rico. Lembre-se, vocΓͺ deve suportar todas as pequenas strings em todos os idiomas no seu conteΓΊdo rico.
#### ConteΓΊdo multilΓngue
O conteΓΊdo do site vem em dois sabores: **bΓ‘sico** e **rico**.
ConteΓΊdo bΓ‘sico Γ© o texto simples de posts de blog, pΓ‘ginas e conteΓΊdo nΓ£o interativo. Pense em pΓ‘ginas e posts. ConteΓΊdo bΓ‘sico Γ© o combustΓvel para os cliques do seu site. Polyglot fornece suporte de fallback para conteΓΊdo bΓ‘sico.
Conteúdo rico é interativo, chamativo e composto de strings mais curtas. Pense em barras de navegação e dropdowns. Conteúdo rico é mais técnico e mantém seus visitantes no site. _Não hÑ suporte de fallback para conteúdo rico ausente._
#### Ferramentas Liquid
As seguintes ferramentas Liquid estΓ£o disponΓveis para uso com jekyll-polyglot:
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages` aponta diretamente para o array `languages` no _config.yml. Pode ser acessado atravΓ©s do Liquid.
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang` aponta diretamente para a string `default_lang` no _config.yml. Pode ser acessado atravΓ©s do Liquid.
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang` Γ© o cΓ³digo de localidade para o qual a pΓ‘gina estΓ‘ sendo construΓda. Isso Γ© `"de"` para a versΓ£o alemΓ£ de uma pΓ‘gina, `"es"` para a versΓ£o espanhola, e assim por diante. Pode ser acessado atravΓ©s do Liquid.
Usando essas ferramentas, vocΓͺ pode especificar como anexar o conteΓΊdo rico correto.
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
A variΓ‘vel `page.rendered_lang` indica o idioma real do conteΓΊdo de uma pΓ‘gina, permitindo que os templates detectem quando uma pΓ‘gina estΓ‘ sendo servida como conteΓΊdo de fallback.
### Suporte ao Github Pages
Por padrΓ£o, o Github impede que [blogs Jekyll usem plugins](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides). Isso Γ© feito intencionalmente para evitar que cΓ³digo malicioso seja executado nos servidores do Github. Embora isso torne o uso do Polyglot (e outros plugins Jekyll) mais difΓcil, ainda Γ© possΓvel.
#### Construindo `_site/` para gh-pages
Em vez de hospedar seu mecanismo de blog Jekyll no Github, vocΓͺ pode desenvolver seu site Jekyll em um branch separado e entΓ£o fazer push do conteΓΊdo construΓdo `_site/` para seu branch `gh-pages`. Isso permite que vocΓͺ gerencie e controle a versΓ£o do desenvolvimento do seu site com o Github *sem ter que depender do Github para construir seu site!*
VocΓͺ pode fazer isso mantendo seu conteΓΊdo Jekyll em um branch separado, e apenas fazendo commit da pasta `_site/` para seu branch gh-pages. Como essas sΓ£o apenas pΓ‘ginas HTML estΓ‘ticas em pastas, o Github as hospedarΓ‘ como qualquer outro conteΓΊdo [gh-pages](https://pages.github.com/).
#### Automatize!
Esse processo Γ© muito ajudado com um script simples que construirΓ‘ seu site e farΓ‘ commit da pasta `_site/` para seu gh-pages. Muitas pessoas tΓͺm um. [Aqui estΓ‘ um](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/). [Aqui estΓ‘ outro](https://gist.github.com/cobyism/4730490). Aqui estΓ‘ [meu script de publicação](https://github.com/untra/polyglot/blob/main/publi.sh):
```bash
#! /bin/sh
# mude os nomes dos branches apropriadamente
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.ru.md 0000664 0000000 0000000 00000025043 15201735340 0020107 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Π ΠΏΡΠΎΠ΅ΠΊΡΠ΅
permalink: about/
lang: ru
---
Polyglot β ΠΏΠ»Π°Π³ΠΈΠ½ ΠΈΠ½ΡΠ΅ΡΠ½Π°ΡΠΈΠΎΠ½Π°Π»ΠΈΠ·Π°ΡΠΈΠΈ Ρ ΠΎΡΠΊΡΡΡΡΠΌ ΠΈΡΡ
ΠΎΠ΄Π½ΡΠΌ ΠΊΠΎΠ΄ΠΎΠΌ Π΄Π»Ρ Π±Π»ΠΎΠ³ΠΎΠ² Jekyll . Polyglot Π»Π΅Π³ΠΊΠΎ Π½Π°ΡΡΡΠΎΠΈΡΡ ΠΈ ΠΈΡΠΏΠΎΠ»ΡΠ·ΠΎΠ²Π°ΡΡ Ρ Π»ΡΠ±ΡΠΌ ΠΏΡΠΎΠ΅ΠΊΡΠΎΠΌ, ΠΈ ΠΎΠ½ ΠΌΠ°ΡΡΡΠ°Π±ΠΈΡΡΠ΅ΡΡΡ Π΄ΠΎ ΡΠ·ΡΠΊΠΎΠ², ΠΊΠΎΡΠΎΡΡΠ΅ Π²Ρ Ρ
ΠΎΡΠΈΡΠ΅ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΈΠ²Π°ΡΡ. Π‘ ΡΠ΅Π·Π΅ΡΠ²Π½ΠΎΠΉ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΊΠΎΠΉ ΠΎΡΡΡΡΡΡΠ²ΡΡΡΠ΅Π³ΠΎ ΠΊΠΎΠ½ΡΠ΅Π½ΡΠ°, Π°Π²ΡΠΎΠΌΠ°ΡΠΈΡΠ΅ΡΠΊΠΎΠΉ ΡΠ΅Π»ΡΡΠΈΠ²ΠΈΠ·Π°ΡΠΈΠ΅ΠΉ URL-Π°Π΄ΡΠ΅ΡΠΎΠ² ΠΈ ΠΌΠΎΡΠ½ΡΠΌΠΈ ΡΠ΅ΡΠ΅ΠΏΡΠ°ΠΌΠΈ SEO , Polyglot ΠΏΠΎΠ·Π²ΠΎΠ»ΡΠ΅Ρ Π»ΡΠ±ΠΎΠΌΡ ΠΌΠ½ΠΎΠ³ΠΎΡΠ·ΡΡΠ½ΠΎΠΌΡ Π±Π»ΠΎΠ³Ρ ΡΠΎΡΡΠ΅Π΄ΠΎΡΠΎΡΠΈΡΡΡΡ Π½Π° ΡΠΎΠ΄Π΅ΡΠΆΠ°Π½ΠΈΠΈ Π±Π΅Π· Π³ΡΡΠ·Π½ΠΎΠΉ ΡΠ°Π±ΠΎΡΡ.
_`jekyll-polyglot` ΠΏΠΎΠΊΠ° Π½Π΅ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΈΠ²Π°Π΅ΡΡΡ Π½Π°ΡΠΈΠ²Π½ΠΎ Π² github-actions_
### Π£ΡΡΠ°Π½ΠΎΠ²ΠΊΠ°
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### Π£ΠΏΡΠ°Π²Π»Π΅Π½ΠΈΠ΅ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΈΠ²Π°Π΅ΠΌΡΠΌΠΈ ΡΠ·ΡΠΊΠ°ΠΌΠΈ
Π `_config.yml` ΡΠ»Π΅Π΄ΡΡΡΠΈΠ΅ ΡΠ²ΠΎΠΉΡΡΠ²Π° ΡΠΏΡΠ°Π²Π»ΡΡΡ ΡΠ΅ΠΌ, ΠΊΠ°ΠΊΠΈΠ΅ ΡΠ·ΡΠΊΠΈ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΈΠ²Π°ΡΡΡΡ Π²Π°ΡΠΈΠΌ ΡΠ°ΠΉΡΠΎΠΌ. ΠΡ ΠΌΠΎΠΆΠ΅ΡΠ΅ Π΄ΠΎΠ±Π°Π²ΠΈΡΡ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΊΡ Π½ΠΎΠ²ΠΎΠ³ΠΎ ΡΠ·ΡΠΊΠ°, Π΄ΠΎΠ±Π°Π²ΠΈΠ² Π΅Π³ΠΎ Π² ΡΡΠΈ Π·Π½Π°ΡΠ΅Π½ΠΈΡ (ΡΠΌ. Π½ΠΈΠΆΠ΅). Π―Π·ΡΠΊΠΈ ΠΈΠ΄Π΅Π½ΡΠΈΡΠΈΡΠΈΡΡΡΡΡΡ ΠΏΠΎ ΠΈΡ
ΠΎΡΠΈΡΠΈΠ°Π»ΡΠ½ΡΠΌ [ΠΊΠΎΠ΄Π°ΠΌ Π»ΠΎΠΊΠ°Π»ΠΈ](https://developer.chrome.com/webstore/i18n).
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` ΠΌΠ°ΡΡΠΈΠ² ΠΊΠΎΠ΄ΠΎΠ² Π»ΠΎΠΊΠ°Π»ΠΈ, ΠΈΠ΄Π΅Π½ΡΠΈΡΠΈΡΠΈΡΡΡΡΠΈΡ
ΡΠ·ΡΠΊΠΈ, ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΈΠ²Π°Π΅ΠΌΡΠ΅ ΡΠ°ΠΉΡΠΎΠΌ.
* `default_lang:` ΡΠ·ΡΠΊ ΠΏΠΎ ΡΠΌΠΎΠ»ΡΠ°Π½ΠΈΡ Π΄Π»Ρ ΡΠ°ΠΉΡΠ°.
* `exclude_from_localization:` ΠΏΠ°ΠΏΠΊΠΈ ΠΈ ΠΊΠ°ΡΠ°Π»ΠΎΠ³ΠΈ, ΠΊΠΎΡΠΎΡΡΠ΅ ΡΠ²Π»ΡΡΡΡΡ ΡΠ°ΡΡΡΡ ΠΏΠΎΡΡΡΠΎΠ΅Π½Π½ΠΎΠ³ΠΎ ΡΠ°ΠΉΡΠ°, Π½ΠΎ Π½Π΅ Π½ΡΠΆΠ΄Π°ΡΡΡΡ Π² Π»ΠΎΠΊΠ°Π»ΠΈΠ·Π°ΡΠΈΠΈ. ΠΡΠΎ Π² ΠΎΡΠ½ΠΎΠ²Π½ΠΎΠΌ Π΄Π»Ρ ΡΠΎΠΊΡΠ°ΡΠ΅Π½ΠΈΡ Π²ΡΠ΅ΠΌΠ΅Π½ΠΈ ΡΠ±ΠΎΡΠΊΠΈ, ΠΈ ΠΏΠΎΡΠΊΠΎΠ»ΡΠΊΡ ΡΠ°ΠΉΠ»Ρ ΡΠ΅ΡΡΡΡΠΎΠ², ΡΠ°ΠΊΠΈΠ΅ ΠΊΠ°ΠΊ ΠΈΠ·ΠΎΠ±ΡΠ°ΠΆΠ΅Π½ΠΈΡ ΠΈ ΡΡΠΈΡΡΡ, ΡΠ²Π»ΡΡΡΡΡ Π±ΠΎΠ»ΡΡΠΈΠΌΠΈ ΡΠ°ΡΡΡΠΌΠΈ ΡΠ°ΠΉΡΠ°, ΡΡΠΎ Π³Π°ΡΠ°Π½ΡΠΈΡΡΠ΅Ρ, ΡΡΠΎ ΠΎΠ½ΠΈ Π½Π΅ Π±ΡΠ΄ΡΡ Π±Π΅Π· Π½Π΅ΠΎΠ±Ρ
ΠΎΠ΄ΠΈΠΌΠΎΡΡΠΈ "ΠΏΠ΅ΡΠ΅Π²Π΅Π΄Π΅Π½Ρ" ΠΈΠ»ΠΈ Π΄ΡΠ±Π»ΠΈΡΠΎΠ²Π°Π½Ρ Π² Π²ΡΠ²ΠΎΠ΄Π΅.
* `url` URL Π²Π°ΡΠ΅Π³ΠΎ ΡΡΠ°ΡΠΈΡΠ΅ΡΠΊΠΎΠ³ΠΎ ΡΠ°ΠΉΡΠ° Π² ΠΏΡΠΎΠ΄Π°ΠΊΡΠ΅Π½Π΅.
### ΠΠΎΠ±Π°Π²Π»Π΅Π½ΠΈΠ΅ Π½ΠΎΠ²ΠΎΠ³ΠΎ ΡΠ·ΡΠΊΠ°
ΠΡΠ΅Π΄ΠΏΠΎΠ»Π°Π³Π°Ρ, ΡΡΠΎ Ρ Π²Π°Ρ ΡΠΆΠ΅ Π΅ΡΡΡ ΡΡΠ½ΠΊΡΠΈΠΎΠ½ΠΈΡΡΡΡΠΈΠΉ ΠΎΠ΄Π½ΠΎΡΠ·ΡΡΠ½ΡΠΉ ΡΠ°ΠΉΡ, Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ΠΈΠ΅ Π½ΠΎΠ²ΠΎΠ³ΠΎ ΡΠ·ΡΠΊΠ° Π½Π΅ Π±ΡΠ΄Π΅Ρ ΡΡΠΈΠ²ΠΈΠ°Π»ΡΠ½ΡΠΌ. _Π§ΡΠΎΠ±Ρ Π΄Π΅ΠΉΡΡΠ²ΠΈΡΠ΅Π»ΡΠ½ΠΎ ΡΠΎΠ·Π΄Π°ΡΡ ΠΌΠ½ΠΎΠ³ΠΎΡΠ·ΡΡΠ½ΡΠΉ ΡΠ°ΠΉΡ, Π²Ρ Π΄ΠΎΠ»ΠΆΠ½Ρ ΠΎΠΆΠΈΠ΄Π°ΡΡ, ΡΡΠΎ Π²Π°ΠΌ ΠΏΡΠΈΠ΄Π΅ΡΡΡ ΠΏΠ΅ΡΠ΅ΡΠΎΠ·Π΄Π°ΡΡ Π²Π΅ΡΡ Π²Π°Ρ ΠΊΠΎΠ½ΡΠ΅Π½Ρ Π½Π° Π½ΠΎΠ²ΠΎΠΌ ΡΠ·ΡΠΊΠ΅._ ΠΡΠΎ ΠΌΠΎΠΆΠ΅Ρ ΠΏΠΎΠΊΠ°Π·Π°ΡΡΡΡ Π±ΠΎΠ»ΡΡΠΎΠΉ Π·Π°Π΄Π°ΡΠ΅ΠΉ, Π½ΠΎ ΡΠ°ΡΡΠΌΠΎΡΡΠΈΡΠ΅ ΠΏΠ΅ΡΠ΅Π²ΠΎΠ΄ ΠΏΠΎ ΡΠ°ΡΡΡΠΌ. ΠΠΎΠ½ΡΠ΅Π½Ρ β ΠΊΠΎΡΠΎΠ»Ρ; Π²Π°ΠΆΠ½Π΅Π΅, ΡΡΠΎΠ±Ρ Π½ΠΎΠ²ΡΠ΅ ΡΡΡΠ°Π½ΠΈΡΡ ΠΈ ΠΏΠΎΡΡΡ ΠΏΠΎΠ»ΡΡΠΈΠ»ΠΈ ΠΎΠ±Π½ΠΎΠ²Π»Π΅Π½Π½ΡΠ΅ ΠΏΠ΅ΡΠ΅Π²ΠΎΠ΄Ρ. Π‘ΠΎΠ·Π΄Π°Π½ΠΈΠ΅ ΠΌΠ½ΠΎΠ³ΠΎΡΠ·ΡΡΠ½ΠΎΠ³ΠΎ ΡΠ°ΠΉΡΠ° ΡΠ»ΠΎΠΆΠ½ΠΎ ΡΠΎΠ»ΡΠΊΠΎ Π² ΡΠΎΠΌ ΡΠ»ΡΡΠ°Π΅, Π΅ΡΠ»ΠΈ Π²Ρ ΡΡΠ΅Π±ΡΠ΅ΡΠ΅, ΡΡΠΎΠ±Ρ ΠΎΠ½ Π±ΡΠ» ΠΈΠ΄Π΅Π°Π»ΡΠ½ΠΎ ΠΏΠ΅ΡΠ΅Π²Π΅Π΄Π΅Π½ Ρ ΡΠ°ΠΌΠΎΠ³ΠΎ Π½Π°ΡΠ°Π»Π°.
ΠΠΎ-ΠΏΠ΅ΡΠ²ΡΡ
, Π²Ρ (ΠΈ Π²Π°ΡΠ° ΠΊΠΎΠΌΠ°Π½Π΄Π°, ΠΈ Π²Π°ΡΠΈ ΠΌΠ΅Π½Π΅Π΄ΠΆΠ΅ΡΡ ΡΠΎΠΆΠ΅, Π΅ΡΠ»ΠΈ ΠΎΠ½ΠΈ Ρ Π²Π°Ρ Π΅ΡΡΡ) Π΄ΠΎΠ»ΠΆΠ½Ρ ΠΎΠ±ΡΡΠ΄ΠΈΡΡ ΠΈ Π²ΡΠ±ΡΠ°ΡΡ, ΠΊΠ°ΠΊΠΎΠΉ ΠΊΠΎΠ½ΡΠ΅Π½Ρ Π²Π°ΠΌ Π½ΡΠΆΠ½ΠΎ ΠΏΠ΅ΡΠ΅Π²Π΅ΡΡΠΈ Π΄Π»Ρ Π½ΠΎΠ²ΠΎΠ³ΠΎ ΡΠ°ΠΉΡΠ°. ΠΡ Π΄ΠΎΠ»ΠΆΠ½Ρ Π²ΡΠ±ΡΠ°ΡΡ ΠΏΡΠ΅Π΄ΠΏΠΎΡΡΠΈΡΠ΅Π»ΡΠ½ΡΠΉ Π±Π°Π·ΠΎΠ²ΡΠΉ ΠΊΠΎΠ½ΡΠ΅Π½Ρ Π΄Π»Ρ ΠΏΠ΅ΡΠ΅Π²ΠΎΠ΄Π°. Π£ΡΠΈΡΡΠ²Π°ΠΉΡΠ΅ Π°Π½Π°Π»ΠΈΡΠΈΠΊΡ, ΠΏΠΎΠΏΡΠ»ΡΡΠ½ΡΠ΅ ΡΡΡΠ°Π½ΠΈΡΡ ΠΈ ΠΏΠΎΡΡΡ Π±Π»ΠΎΠ³Π°, Π° ΡΠ°ΠΊΠΆΠ΅ ΠΏΠΎΡΠΎΠΊ ΡΠ΅ΠΊΡΡΠΈΡ
ΠΈ Π±ΡΠ΄ΡΡΠΈΡ
ΠΏΠΎΠ»ΡΠ·ΠΎΠ²Π°ΡΠ΅Π»Π΅ΠΉ Π½Π° Π²Π°Ρ ΡΠ°ΠΉΡ. Π ΡΠ»ΡΡΠ°Π΅ ΡΠΎΠΌΠ½Π΅Π½ΠΈΠΉ ΠΏΡΠΈΠΎΡΠΈΡΠΈΠ·ΠΈΡΡΠΉΡΠ΅ ΡΡΡΠ°Π½ΠΈΡΡ Π½Π°Π΄ ΡΡΠ°ΡΡΠΌΠΈ ΠΏΠΎΡΡΠ°ΠΌΠΈ Π±Π»ΠΎΠ³Π°. ΠΡΠ»ΠΈ ΡΡΠΎ ΠΎΠ·Π½Π°ΡΠ°Π΅Ρ Π·Π°ΠΏΡΡΡΠΈΡΡ Π½ΠΎΠ²ΡΠΉ ΡΠ·ΡΠΊ ΡΠ°Π½ΡΡΠ΅, ΡΡΠ°ΡΡΠ΅ ΠΏΠΎΡΡΡ ΠΌΠΎΠ³ΡΡ ΠΏΠΎΡΡΠ΅Π±ΠΎΠ²Π°ΡΡ Π±ΠΎΠ»ΡΡΠ΅ ΡΡΠΈΠ»ΠΈΠΉ, ΡΠ΅ΠΌ ΠΎΠ½ΠΈ ΡΠΎΠ³ΠΎ ΡΡΠΎΡΡ Π΄Π»Ρ ΠΏΠ΅ΡΠ΅Π²ΠΎΠ΄Π°.
ΠΠΎ-Π²ΡΠΎΡΡΡ
, Π²Ρ Π΄ΠΎΠ»ΠΆΠ½Ρ (ΠΈΠ»ΠΈ Π½Π°ΡΡΠΎΡΡΠ΅Π»ΡΠ½ΠΎ ΡΠ΅ΠΊΠΎΠΌΠ΅Π½Π΄ΡΠ΅ΡΡΡ) ΠΎΠ±Π΅ΡΠΏΠ΅ΡΠΈΡΡ 100% ΠΏΠΎΠΊΡΡΡΠΈΠ΅ Π±ΠΎΠ³Π°ΡΠΎΠ³ΠΎ ΠΊΠΎΠ½ΡΠ΅Π½ΡΠ° Π½Π° Π²Π°ΡΠ΅ΠΌ ΡΠ°ΠΉΡΠ΅. ΠΡΠΎ Π½Π΅Π±ΠΎΠ»ΡΡΠΈΠ΅ ΡΡΡΠΎΠΊΠΈ, Π²ΡΡΡΠΎΠ΅Π½Π½ΡΠ΅ Π±ΠΎΠ»Π΅Π΅ ΡΠ»ΠΎΠΆΠ½ΡΠΌΠΈ ΡΠΏΠΎΡΠΎΠ±Π°ΠΌΠΈ. ΠΡΡΡ Π½Π΅ΡΠΊΠΎΠ»ΡΠΊΠΎ ΡΠΏΠΎΡΠΎΠ±ΠΎΠ² ΠΈΡΠ΅ΡΠ°ΡΠΈΠΈ ΠΏΠΎ Π±ΠΎΠ³Π°ΡΠΎΠΌΡ ΠΊΠΎΠ½ΡΠ΅Π½ΡΡ. ΠΠΎΠΌΠ½ΠΈΡΠ΅, Π²Ρ Π΄ΠΎΠ»ΠΆΠ½Ρ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΈΠ²Π°ΡΡ Π²ΡΠ΅ ΠΌΠ°Π»Π΅Π½ΡΠΊΠΈΠ΅ ΡΡΡΠΎΠΊΠΈ Π½Π° Π²ΡΠ΅Ρ
ΡΠ·ΡΠΊΠ°Ρ
Π² Π²Π°ΡΠ΅ΠΌ Π±ΠΎΠ³Π°ΡΠΎΠΌ ΠΊΠΎΠ½ΡΠ΅Π½ΡΠ΅.
#### ΠΠ½ΠΎΠ³ΠΎΡΠ·ΡΡΠ½ΡΠΉ ΠΊΠΎΠ½ΡΠ΅Π½Ρ
ΠΠΎΠ½ΡΠ΅Π½Ρ ΡΠ°ΠΉΡΠ° Π±ΡΠ²Π°Π΅Ρ Π΄Π²ΡΡ
Π²ΠΈΠ΄ΠΎΠ²: **Π±Π°Π·ΠΎΠ²ΡΠΉ** ΠΈ **Π±ΠΎΠ³Π°ΡΡΠΉ**.
ΠΠ°Π·ΠΎΠ²ΡΠΉ ΠΊΠΎΠ½ΡΠ΅Π½Ρ β ΡΡΠΎ ΠΏΠ»ΠΎΡΠΊΠΈΠΉ ΡΠ΅ΠΊΡΡ ΠΏΠΎΡΡΠΎΠ² Π±Π»ΠΎΠ³Π°, ΡΡΡΠ°Π½ΠΈΡ ΠΈ Π½Π΅ΠΈΠ½ΡΠ΅ΡΠ°ΠΊΡΠΈΠ²Π½ΠΎΠ³ΠΎ ΠΊΠΎΠ½ΡΠ΅Π½ΡΠ°. ΠΡΠΌΠ°ΠΉΡΠ΅ ΠΎ ΡΡΡΠ°Π½ΠΈΡΠ°Ρ
ΠΈ ΠΏΠΎΡΡΠ°Ρ
. ΠΠ°Π·ΠΎΠ²ΡΠΉ ΠΊΠΎΠ½ΡΠ΅Π½Ρ β ΡΡΠΎ ΡΠΎΠΏΠ»ΠΈΠ²ΠΎ Π΄Π»Ρ ΠΊΠ»ΠΈΠΊΠΎΠ² Π½Π° Π²Π°ΡΠ΅ΠΌ ΡΠ°ΠΉΡΠ΅. Polyglot ΠΏΡΠ΅Π΄ΠΎΡΡΠ°Π²Π»ΡΠ΅Ρ ΡΠ΅Π·Π΅ΡΠ²Π½ΡΡ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΊΡ Π΄Π»Ρ Π±Π°Π·ΠΎΠ²ΠΎΠ³ΠΎ ΠΊΠΎΠ½ΡΠ΅Π½ΡΠ°.
ΠΠΎΠ³Π°ΡΡΠΉ ΠΊΠΎΠ½ΡΠ΅Π½Ρ ΠΈΠ½ΡΠ΅ΡΠ°ΠΊΡΠΈΠ²Π΅Π½, ΡΡΠΎΠΊ ΠΈ ΡΠΎΡΡΠΎΠΈΡ ΠΈΠ· Π±ΠΎΠ»Π΅Π΅ ΠΊΠΎΡΠΎΡΠΊΠΈΡ
ΡΡΡΠΎΠΊ. ΠΡΠΌΠ°ΠΉΡΠ΅ ΠΎ Π½Π°Π²ΠΈΠ³Π°ΡΠΈΠΎΠ½Π½ΡΡ
ΠΏΠ°Π½Π΅Π»ΡΡ
ΠΈ Π²ΡΠΏΠ°Π΄Π°ΡΡΠΈΡ
ΠΌΠ΅Π½Ρ. ΠΠΎΠ³Π°ΡΡΠΉ ΠΊΠΎΠ½ΡΠ΅Π½Ρ Π±ΠΎΠ»Π΅Π΅ ΡΠ΅Ρ
Π½ΠΈΡΠ΅ΡΠΊΠΈΠΉ ΠΈ ΡΠ΄Π΅ΡΠΆΠΈΠ²Π°Π΅Ρ Π²Π°ΡΠΈΡ
ΠΏΠΎΡΠ΅ΡΠΈΡΠ΅Π»Π΅ΠΉ Π½Π° ΡΠ°ΠΉΡΠ΅. _ΠΠ΅Ρ ΡΠ΅Π·Π΅ΡΠ²Π½ΠΎΠΉ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΊΠΈ Π΄Π»Ρ ΠΎΡΡΡΡΡΡΠ²ΡΡΡΠ΅Π³ΠΎ Π±ΠΎΠ³Π°ΡΠΎΠ³ΠΎ ΠΊΠΎΠ½ΡΠ΅Π½ΡΠ°._
#### ΠΠ½ΡΡΡΡΠΌΠ΅Π½ΡΡ Liquid
Π‘Π»Π΅Π΄ΡΡΡΠΈΠ΅ ΠΈΠ½ΡΡΡΡΠΌΠ΅Π½ΡΡ Liquid Π΄ΠΎΡΡΡΠΏΠ½Ρ Π΄Π»Ρ ΠΈΡΠΏΠΎΠ»ΡΠ·ΠΎΠ²Π°Π½ΠΈΡ Ρ jekyll-polyglot:
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages` ΡΠΊΠ°Π·ΡΠ²Π°Π΅Ρ Π½Π°ΠΏΡΡΠΌΡΡ Π½Π° ΠΌΠ°ΡΡΠΈΠ² `languages` Π² _config.yml. Π Π½Π΅ΠΌΡ ΠΌΠΎΠΆΠ½ΠΎ ΠΏΠΎΠ»ΡΡΠΈΡΡ Π΄ΠΎΡΡΡΠΏ ΡΠ΅ΡΠ΅Π· Liquid.
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang` ΡΠΊΠ°Π·ΡΠ²Π°Π΅Ρ Π½Π°ΠΏΡΡΠΌΡΡ Π½Π° ΡΡΡΠΎΠΊΡ `default_lang` Π² _config.yml. Π Π½Π΅ΠΌΡ ΠΌΠΎΠΆΠ½ΠΎ ΠΏΠΎΠ»ΡΡΠΈΡΡ Π΄ΠΎΡΡΡΠΏ ΡΠ΅ΡΠ΅Π· Liquid.
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang` β ΡΡΠΎ ΠΊΠΎΠ΄ Π»ΠΎΠΊΠ°Π»ΠΈ, Π΄Π»Ρ ΠΊΠΎΡΠΎΡΠΎΠΉ ΡΡΡΠΎΠΈΡΡΡ ΡΡΡΠ°Π½ΠΈΡΠ°. ΠΡΠΎ `"de"` Π΄Π»Ρ Π½Π΅ΠΌΠ΅ΡΠΊΠΎΠΉ Π²Π΅ΡΡΠΈΠΈ ΡΡΡΠ°Π½ΠΈΡΡ, `"es"` Π΄Π»Ρ ΠΈΡΠΏΠ°Π½ΡΠΊΠΎΠΉ Π²Π΅ΡΡΠΈΠΈ ΠΈ ΡΠ°ΠΊ Π΄Π°Π»Π΅Π΅. Π Π½Π΅ΠΌΡ ΠΌΠΎΠΆΠ½ΠΎ ΠΏΠΎΠ»ΡΡΠΈΡΡ Π΄ΠΎΡΡΡΠΏ ΡΠ΅ΡΠ΅Π· Liquid.
ΠΡΠΏΠΎΠ»ΡΠ·ΡΡ ΡΡΠΈ ΠΈΠ½ΡΡΡΡΠΌΠ΅Π½ΡΡ, Π²Ρ ΠΌΠΎΠΆΠ΅ΡΠ΅ ΡΠΊΠ°Π·Π°ΡΡ, ΠΊΠ°ΠΊ ΠΏΡΠΈΠΊΡΠ΅ΠΏΠΈΡΡ ΠΏΡΠ°Π²ΠΈΠ»ΡΠ½ΡΠΉ Π±ΠΎΠ³Π°ΡΡΠΉ ΠΊΠΎΠ½ΡΠ΅Π½Ρ.
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
ΠΠ΅ΡΠ΅ΠΌΠ΅Π½Π½Π°Ρ `page.rendered_lang` ΡΠΊΠ°Π·ΡΠ²Π°Π΅Ρ ΡΠ°ΠΊΡΠΈΡΠ΅ΡΠΊΠΈΠΉ ΡΠ·ΡΠΊ ΡΠΎΠ΄Π΅ΡΠΆΠΈΠΌΠΎΠ³ΠΎ ΡΡΡΠ°Π½ΠΈΡΡ, ΠΏΠΎΠ·Π²ΠΎΠ»ΡΡ ΡΠ°Π±Π»ΠΎΠ½Π°ΠΌ ΠΎΠΏΡΠ΅Π΄Π΅Π»ΡΡΡ, ΠΊΠΎΠ³Π΄Π° ΡΡΡΠ°Π½ΠΈΡΠ° ΠΎΡΠΎΠ±ΡΠ°ΠΆΠ°Π΅ΡΡΡ ΠΊΠ°ΠΊ ΡΠ΅Π·Π΅ΡΠ²Π½ΡΠΉ ΠΊΠΎΠ½ΡΠ΅Π½Ρ.
### ΠΠΎΠ΄Π΄Π΅ΡΠΆΠΊΠ° Github Pages
ΠΠΎ ΡΠΌΠΎΠ»ΡΠ°Π½ΠΈΡ Github Π½Π΅ ΠΏΠΎΠ·Π²ΠΎΠ»ΡΠ΅Ρ [Π±Π»ΠΎΠ³Π°ΠΌ Jekyll ΠΈΡΠΏΠΎΠ»ΡΠ·ΠΎΠ²Π°ΡΡ ΠΏΠ»Π°Π³ΠΈΠ½Ρ](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides). ΠΡΠΎ ΡΠ΄Π΅Π»Π°Π½ΠΎ Π½Π°ΠΌΠ΅ΡΠ΅Π½Π½ΠΎ, ΡΡΠΎΠ±Ρ ΠΏΡΠ΅Π΄ΠΎΡΠ²ΡΠ°ΡΠΈΡΡ Π²ΡΠΏΠΎΠ»Π½Π΅Π½ΠΈΠ΅ Π²ΡΠ΅Π΄ΠΎΠ½ΠΎΡΠ½ΠΎΠ³ΠΎ ΠΊΠΎΠ΄Π° Π½Π° ΡΠ΅ΡΠ²Π΅ΡΠ°Ρ
Github. Π₯ΠΎΡΡ ΡΡΠΎ ΡΡΠ»ΠΎΠΆΠ½ΡΠ΅Ρ ΠΈΡΠΏΠΎΠ»ΡΠ·ΠΎΠ²Π°Π½ΠΈΠ΅ Polyglot (ΠΈ Π΄ΡΡΠ³ΠΈΡ
ΠΏΠ»Π°Π³ΠΈΠ½ΠΎΠ² Jekyll), ΡΡΠΎ Π²ΡΠ΅ Π΅ΡΠ΅ Π²ΠΎΠ·ΠΌΠΎΠΆΠ½ΠΎ.
#### Π‘Π±ΠΎΡΠΊΠ° `_site/` Π² gh-pages
ΠΠΌΠ΅ΡΡΠΎ ΡΠΎΠ³ΠΎ ΡΡΠΎΠ±Ρ ΡΠ°Π·ΠΌΠ΅ΡΠ°ΡΡ Π²Π°Ρ Π΄Π²ΠΈΠΆΠΎΠΊ Π±Π»ΠΎΠ³Π° Jekyll Π½Π° Github, Π²Ρ ΠΌΠΎΠΆΠ΅ΡΠ΅ ΡΠ°Π·ΡΠ°Π±Π°ΡΡΠ²Π°ΡΡ Π²Π°Ρ ΡΠ°ΠΉΡ Jekyll Π½Π° ΠΎΡΠ΄Π΅Π»ΡΠ½ΠΎΠΉ Π²Π΅ΡΠΊΠ΅, Π° Π·Π°ΡΠ΅ΠΌ ΠΏΡΡΠΈΡΡ ΠΏΠΎΡΡΡΠΎΠ΅Π½Π½ΠΎΠ΅ ΡΠΎΠ΄Π΅ΡΠΆΠΈΠΌΠΎΠ΅ `_site/` Π² Π²Π°ΡΡ Π²Π΅ΡΠΊΡ `gh-pages`. ΠΡΠΎ ΠΏΠΎΠ·Π²ΠΎΠ»ΡΠ΅Ρ Π²Π°ΠΌ ΡΠΏΡΠ°Π²Π»ΡΡΡ ΠΈ ΠΊΠΎΠ½ΡΡΠΎΠ»ΠΈΡΠΎΠ²Π°ΡΡ Π²Π΅ΡΡΠΈΠΈ Π²Π°ΡΠ΅ΠΉ ΡΠ°Π·ΡΠ°Π±ΠΎΡΠΊΠΈ ΡΠ°ΠΉΡΠ° Ρ ΠΏΠΎΠΌΠΎΡΡΡ Github *Π±Π΅Π· Π½Π΅ΠΎΠ±Ρ
ΠΎΠ΄ΠΈΠΌΠΎΡΡΠΈ ΠΏΠΎΠ»Π°Π³Π°ΡΡΡΡ Π½Π° Github Π΄Π»Ρ ΡΠ±ΠΎΡΠΊΠΈ Π²Π°ΡΠ΅Π³ΠΎ ΡΠ°ΠΉΡΠ°!*
ΠΡ ΠΌΠΎΠΆΠ΅ΡΠ΅ ΡΠ΄Π΅Π»Π°ΡΡ ΡΡΠΎ, ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΈΠ²Π°Ρ Π²Π°Ρ ΠΊΠΎΠ½ΡΠ΅Π½Ρ Jekyll Π½Π° ΠΎΡΠ΄Π΅Π»ΡΠ½ΠΎΠΉ Π²Π΅ΡΠΊΠ΅ ΠΈ ΠΊΠΎΠΌΠΌΠΈΡΡ ΡΠΎΠ»ΡΠΊΠΎ ΠΏΠ°ΠΏΠΊΡ `_site/` Π² Π²Π°ΡΡ Π²Π΅ΡΠΊΡ gh-pages. ΠΠΎΡΠΊΠΎΠ»ΡΠΊΡ ΡΡΠΎ ΠΏΡΠΎΡΡΠΎ ΡΡΠ°ΡΠΈΡΠ΅ΡΠΊΠΈΠ΅ HTML-ΡΡΡΠ°Π½ΠΈΡΡ Π² ΠΏΠ°ΠΏΠΊΠ°Ρ
, Github Π±ΡΠ΄Π΅Ρ ΡΠ°Π·ΠΌΠ΅ΡΠ°ΡΡ ΠΈΡ
ΠΊΠ°ΠΊ Π»ΡΠ±ΠΎΠΉ Π΄ΡΡΠ³ΠΎΠΉ ΠΊΠΎΠ½ΡΠ΅Π½Ρ [gh-pages](https://pages.github.com/).
#### ΠΠ²ΡΠΎΠΌΠ°ΡΠΈΠ·ΠΈΡΡΠΉΡΠ΅ ΡΡΠΎ!
ΠΡΠΎΡ ΠΏΡΠΎΡΠ΅ΡΡ Π·Π½Π°ΡΠΈΡΠ΅Π»ΡΠ½ΠΎ ΡΠΏΡΠΎΡΠ°Π΅ΡΡΡ Ρ ΠΏΠΎΠΌΠΎΡΡΡ ΠΏΡΠΎΡΡΠΎΠ³ΠΎ ΡΠΊΡΠΈΠΏΡΠ°, ΠΊΠΎΡΠΎΡΡΠΉ ΡΠΎΠ±Π΅ΡΠ΅Ρ Π²Π°Ρ ΡΠ°ΠΉΡ ΠΈ Π·Π°ΠΊΠΎΠΌΠΌΠΈΡΠΈΡ ΠΏΠ°ΠΏΠΊΡ `_site/` Π² Π²Π°Ρ gh-pages. Π£ ΠΌΠ½ΠΎΠ³ΠΈΡ
Π»ΡΠ΄Π΅ΠΉ Π΅ΡΡΡ ΡΠ°ΠΊΠΎΠΉ. [ΠΠΎΡ ΠΎΠ΄ΠΈΠ½](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/). [ΠΠΎΡ Π΄ΡΡΠ³ΠΎΠΉ](https://gist.github.com/cobyism/4730490). ΠΠΎΡ [ΠΌΠΎΠΉ ΡΠΊΡΠΈΠΏΡ ΠΏΡΠ±Π»ΠΈΠΊΠ°ΡΠΈΠΈ](https://github.com/untra/polyglot/blob/main/publi.sh):
```bash
#! /bin/sh
# ΠΈΠ·ΠΌΠ΅Π½ΠΈΡΠ΅ ΠΈΠΌΠ΅Π½Π° Π²Π΅ΡΠΎΠΊ ΡΠΎΠΎΡΠ²Π΅ΡΡΡΠ²Π΅Π½Π½ΠΎ
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.tr.md 0000664 0000000 0000000 00000016050 15201735340 0020104 0 ustar 00root root 0000000 0000000 ---
layout: page
title: HakkΔ±nda
permalink: about/
lang: tr
---
Polyglot , Jekyll bloglarΔ± iΓ§in aΓ§Δ±k kaynaklΔ± bir uluslararasΔ±laΕtΔ±rma eklentisidir. Polyglot'u herhangi bir projeyle kurmak ve kullanmak kolaydΔ±r ve desteklemek istediΔiniz dillere gΓΆre ΓΆlΓ§eklenir. Eksik iΓ§erik iΓ§in yedek destek, otomatik URL gΓΆreceliΕtirme ve gΓΌΓ§lΓΌ SEO tarifleri ile Polyglot, herhangi bir Γ§ok dilli blogun gereksiz iΕler olmadan iΓ§eriΔe odaklanmasΔ±nΔ± saΔlar.
_`jekyll-polyglot` henΓΌz github-actions'da yerel olarak desteklenmiyor_
### Kurulum
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### Desteklenen Dilleri YΓΆnetme
`_config.yml` dosyasΔ±nda, aΕaΔΔ±daki ΓΆzellikler web sitenizin hangi dilleri desteklediΔini yΓΆnetir. Bu deΔerlere ekleyerek yeni bir dil iΓ§in destek saΔlayabilirsiniz (aΕaΔΔ±ya bakΔ±n). Diller, resmi [yerel ayar kodlarΔ±](https://developer.chrome.com/webstore/i18n) ile tanΔ±mlanΔ±r.
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` web sitesi tarafΔ±ndan desteklenen dilleri tanΔ±mlayan yerel ayar kodlarΔ± dizisi.
* `default_lang:` web sitesi için varsayılan dil.
* `exclude_from_localization:` oluΕturulan web sitesinin parΓ§asΔ± olan ancak yerelleΕtirilmesi gerekmeyen klasΓΆrler ve dizinler. Bu ΓΆncelikle derleme sΓΌrelerini kΔ±saltmak iΓ§indir ve resimler ve yazΔ± tipleri gibi varlΔ±k dosyalarΔ± web sitesinin bΓΌyΓΌk bΓΆlΓΌmlerini oluΕturduΔundan, bunlarΔ±n gereksiz yere "Γ§evrilmemesini" veya Γ§Δ±ktΔ±da Γ§oΔaltΔ±lmamasΔ±nΔ± saΔlar.
* `url` ΓΌretim statik web sitenizin url'si.
### Yeni Bir Dil Ekleme
Zaten Γ§alΔ±Εan tek dilli bir web siteniz olduΔunu varsayarsak, yeni bir dil eklemek ΓΆnemsiz olmayacaktΔ±r. _GerΓ§ekten Γ§ok dilli bir web sitesi yapmak iΓ§in tΓΌm iΓ§eriΔinizi yeni dilde yeniden oluΕturmanΔ±z gerekecektir._ Bu bΓΌyΓΌk bir giriΕim gibi gΓΆrΓΌnebilir, ancak Γ§eviriyi parΓ§alar halinde dΓΌΕΓΌnΓΌn. Δ°Γ§erik kraldΔ±r; yeni sayfalarΔ±n ve gΓΆnderilerin Γ§eviride gΓΌncellenmesi daha ΓΆnemlidir. Γok dilli bir web sitesi yapmak, yalnΔ±zca baΕtan mΓΌkemmel Γ§evrilmesini gerektirirseniz zordur.
Δ°lk olarak, siz (ve ekibiniz ve etrafΔ±nΔ±zda varsa yΓΆneticileriniz de) yeni web sitesine hangi iΓ§eriΔin Γ§evrilmesi gerektiΔini tartΔ±ΕmalΔ± ve seΓ§melisiniz. Γevirilecek tercih ettiΔiniz temel iΓ§eriΔi seΓ§melisiniz. Analizleri, popΓΌler sayfalarΔ± ve blog gΓΆnderilerini ve mevcut ve gelecekteki kullanΔ±cΔ±larΔ±n web sitenize akΔ±ΕΔ±nΔ± gΓΆz ΓΆnΓΌnde bulundurun. ΕΓΌphe durumunda, sayfalara eski blog gΓΆnderilerinden ΓΆncelik verin. Yeni bir dili daha erken baΕlatmak anlamΔ±na geliyorsa, eski gΓΆnderileri Γ§evirmek iΓ§in harcanan Γ§aba, deΔerine deΔmeyebilir.
Δ°kinci olarak, siteniz boyunca zengin iΓ§eriΔin %100 kapsamΔ±nΔ± saΔlamalΔ±sΔ±nΔ±z (veya gΓΌΓ§lΓΌ bir Εekilde saΔlamalΔ±sΔ±nΔ±z). Bunlar daha karmaΕΔ±k Εekillerde gΓΆmΓΌlΓΌ küçük dizelerdir. Zengin iΓ§erik ΓΌzerinde yinelemenin birden fazla yolu vardΔ±r. UnutmayΔ±n, zengin iΓ§eriΔinizdeki tΓΌm dil küçük dizelerini desteklemelisiniz.
#### Γok Dilli Δ°Γ§erik
Web sitesi iΓ§eriΔi iki Γ§eΕittir: **temel** ve **zengin**.
Temel iΓ§erik, blog gΓΆnderilerinin, sayfalarΔ±n ve etkileΕimli olmayan iΓ§eriΔin dΓΌz metnidir. SayfalarΔ± ve gΓΆnderileri dΓΌΕΓΌnΓΌn. Temel iΓ§erik, web sitelerinizin tΔ±klamalarΔ± iΓ§in yakΔ±ttΔ±r. Polyglot, temel iΓ§erik iΓ§in yedek destek saΔlar.
Zengin iΓ§erik etkileΕimli, gΓΆsteriΕli ve daha kΔ±sa dizelerden oluΕur. Gezinme Γ§ubuklarΔ±nΔ± ve aΓ§Δ±lΔ±r menΓΌleri dΓΌΕΓΌnΓΌn. Zengin iΓ§erik daha tekniktir ve ziyaretΓ§ilerinizi sitede tutar. _Eksik zengin iΓ§erik iΓ§in yedek destek yoktur._
#### Liquid Araçları
AΕaΔΔ±daki liquid araΓ§larΔ± jekyll-polyglot ile kullanΔ±labilir:
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages` doΔrudan _config.yml'deki `languages` dizisine iΕaret eder. Liquid aracΔ±lΔ±ΔΔ±yla eriΕilebilir.
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang` doΔrudan _config.yml'deki `default_lang` dizesine iΕaret eder. Liquid aracΔ±lΔ±ΔΔ±yla eriΕilebilir.
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang`, sayfanΔ±n oluΕturulduΔu yerel ayar kodudur. Bu, bir sayfanΔ±n Almanca sΓΌrΓΌmΓΌ iΓ§in `"de"`, Δ°spanyolca sΓΌrΓΌmΓΌ iΓ§in `"es"` vb. Εeklindedir. Liquid aracΔ±lΔ±ΔΔ±yla eriΕilebilir.
Bu araΓ§larΔ± kullanarak, doΔru zengin iΓ§eriΔi nasΔ±l ekleyeceΔinizi belirleyebilirsiniz.
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
`page.rendered_lang` deΔiΕkeni, bir sayfanΔ±n iΓ§eriΔinin gerΓ§ek dilini belirtir ve ΕablonlarΔ±n bir sayfanΔ±n yedek iΓ§erik olarak sunulup sunulmadΔ±ΔΔ±nΔ± algΔ±lamasΔ±nΔ± saΔlar.
### GitHub Pages DesteΔi
VarsayΔ±lan olarak GitHub, [Jekyll bloglarΔ±nΔ±n eklenti kullanmasΔ±nΔ±](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides) engeller. Bu, GitHub sunucularΔ±nda kΓΆtΓΌ amaΓ§lΔ± kodun Γ§alΔ±ΕtΔ±rΔ±lmasΔ±nΔ± ΓΆnlemek iΓ§in kasΔ±tlΔ± olarak yapΔ±lΔ±r. Bu, Polyglot'u (ve diΔer Jekyll eklentilerini) kullanmayΔ± zorlaΕtΔ±rsa da, yine de yapΔ±labilir.
#### `_site/`'Δ± gh-pages'e OluΕturma
Jekyll blog motorunuzu GitHub'da barΔ±ndΔ±rmak yerine, Jekyll web sitenizi ayrΔ± bir dalda geliΕtirebilir ve ardΔ±ndan oluΕturulan `_site/` iΓ§eriklerini `gh-pages` dalΔ±nΔ±za itebilirsiniz. Bu, web sitesi geliΕtirmenizi GitHub ile yΓΆnetmenize ve sΓΌrΓΌm kontrolΓΌ yapmanΔ±za olanak tanΔ±r *GitHub'Δ±n web sitenizi oluΕturmasΔ±na gΓΌvenmek zorunda kalmadan!*
Bunu, Jekyll iΓ§eriΔinizi ayrΔ± bir dalda tutarak ve yalnΔ±zca `_site/` klasΓΆrΓΌnΓΌ gh-pages dalΔ±nΔ±za iΕleyerek yapabilirsiniz. Bunlar klasΓΆrlerdeki statik HTML sayfalarΔ± olduΔundan, GitHub bunlarΔ± diΔer [gh-pages](https://pages.github.com/) iΓ§erikleri gibi barΔ±ndΔ±racaktΔ±r.
#### OtomatikleΕtirin!
Bu sΓΌreΓ§, web sitenizi oluΕturacak ve `_site/` klasΓΆrΓΌnΓΌ gh-pages'inize iΕleyecek basit bir komut dosyasΔ±yla bΓΌyΓΌk ΓΆlçüde kolaylaΕtΔ±rΔ±lΔ±r. BirΓ§ok kiΕinin bΓΆyle bir komut dosyasΔ± var. [Δ°Εte biri](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/). [Δ°Εte baΕka biri](https://gist.github.com/cobyism/4730490). Δ°Εte [benim yayΔ±nlama komut dosyam](https://github.com/untra/polyglot/blob/main/publi.sh):
```bash
#! /bin/sh
# dal adlarΔ±nΔ± uygun Εekilde deΔiΕtirin
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.uk.md 0000664 0000000 0000000 00000024404 15201735340 0020100 0 ustar 00root root 0000000 0000000 ---
layout: page
title: ΠΡΠΎ
permalink: about/
lang: uk
---
Polyglot β ΡΠ΅ ΠΏΠ»Π°Π³ΡΠ½ ΡΠ½ΡΠ΅ΡΠ½Π°ΡΡΠΎΠ½Π°Π»ΡΠ·Π°ΡΡΡ Π· Π²ΡΠ΄ΠΊΡΠΈΡΠΈΠΌ ΠΊΠΎΠ΄ΠΎΠΌ Π΄Π»Ρ Π±Π»ΠΎΠ³ΡΠ² Jekyll . Polyglot ΠΏΡΠΎΡΡΠΈΠΉ Ρ Π½Π°Π»Π°ΡΡΡΠ²Π°Π½Π½Ρ ΡΠ° Π²ΠΈΠΊΠΎΡΠΈΡΡΠ°Π½Π½Ρ Π· Π±ΡΠ΄Ρ-ΡΠΊΠΈΠΌ ΠΏΡΠΎΡΠΊΡΠΎΠΌ, Ρ Π²ΡΠ½ ΠΌΠ°ΡΡΡΠ°Π±ΡΡΡΡΡΡ Π²ΡΠ΄ΠΏΠΎΠ²ΡΠ΄Π½ΠΎ Π΄ΠΎ ΠΌΠΎΠ², ΡΠΊΡ Π²ΠΈ Ρ
ΠΎΡΠ΅ΡΠ΅ ΠΏΡΠ΄ΡΡΠΈΠΌΡΠ²Π°ΡΠΈ. ΠΠ°Π²Π΄ΡΠΊΠΈ ΡΠ΅Π·Π΅ΡΠ²Π½ΡΠΉ ΠΏΡΠ΄ΡΡΠΈΠΌΡΡ Π²ΡΠ΄ΡΡΡΠ½ΡΠΎΠ³ΠΎ Π²ΠΌΡΡΡΡ, Π°Π²ΡΠΎΠΌΠ°ΡΠΈΡΠ½ΡΠΉ ΡΠ΅Π»ΡΡΠΈΠ²ΡΠ·Π°ΡΡΡ URL ΡΠ° ΠΏΠΎΡΡΠΆΠ½ΠΈΠΌ ΡΠ΅ΡΠ΅ΠΏΡΠ°ΠΌ SEO , Polyglot Π΄ΠΎΠ·Π²ΠΎΠ»ΡΡ Π±ΡΠ΄Ρ-ΡΠΊΠΎΠΌΡ Π±Π°Π³Π°ΡΠΎΠΌΠΎΠ²Π½ΠΎΠΌΡ Π±Π»ΠΎΠ³Ρ Π·ΠΎΡΠ΅ΡΠ΅Π΄ΠΈΡΠΈΡΡ Π½Π° Π²ΠΌΡΡΡΡ Π±Π΅Π· Π·Π°ΠΉΠ²ΠΎΡ ΠΌΠ΅ΡΡΡΠ½Ρ.
_`jekyll-polyglot` ΡΠ΅ Π½Π΅ ΠΏΡΠ΄ΡΡΠΈΠΌΡΡΡΡΡΡ Π½Π°ΡΠΈΠ²Π½ΠΎ Π² github-actions_
### ΠΡΡΠ°Π½ΠΎΠ²Π»Π΅Π½Π½Ρ
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### ΠΠ΅ΡΡΠ²Π°Π½Π½Ρ ΠΏΡΠ΄ΡΡΠΈΠΌΡΠ²Π°Π½ΠΈΠΌΠΈ ΠΌΠΎΠ²Π°ΠΌΠΈ
Ρ `_config.yml` Π½Π°ΡΡΡΠΏΠ½Ρ Π²Π»Π°ΡΡΠΈΠ²ΠΎΡΡΡ ΠΊΠ΅ΡΡΡΡΡ ΡΠΈΠΌ, ΡΠΊΡ ΠΌΠΎΠ²ΠΈ ΠΏΡΠ΄ΡΡΠΈΠΌΡΡ Π²Π°Ρ Π²Π΅Π±ΡΠ°ΠΉΡ. ΠΠΈ ΠΌΠΎΠΆΠ΅ΡΠ΅ Π½Π°Π΄Π°ΡΠΈ ΠΏΡΠ΄ΡΡΠΈΠΌΠΊΡ Π½ΠΎΠ²ΡΠΉ ΠΌΠΎΠ²Ρ, Π΄ΠΎΠ΄Π°Π²ΡΠΈ ΡΡ Π΄ΠΎ ΡΠΈΡ
Π·Π½Π°ΡΠ΅Π½Ρ (Π΄ΠΈΠ². Π½ΠΈΠΆΡΠ΅). ΠΠΎΠ²ΠΈ ΡΠ΄Π΅Π½ΡΠΈΡΡΠΊΡΡΡΡΡΡ Π·Π° ΡΡ
Π½ΡΠΌΠΈ ΠΎΡΡΡΡΠΉΠ½ΠΈΠΌΠΈ [ΠΊΠΎΠ΄Π°ΠΌΠΈ Π»ΠΎΠΊΠ°Π»Ρ](https://developer.chrome.com/webstore/i18n).
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` ΠΌΠ°ΡΠΈΠ² ΠΊΠΎΠ΄ΡΠ² Π»ΠΎΠΊΠ°Π»Π΅ΠΉ, ΡΠΎ ΡΠ΄Π΅Π½ΡΠΈΡΡΠΊΡΡΡΡ ΠΌΠΎΠ²ΠΈ, ΡΠΊΡ ΠΏΡΠ΄ΡΡΠΈΠΌΡΡ Π²Π΅Π±ΡΠ°ΠΉΡ.
* `default_lang:` ΠΌΠΎΠ²Π° Π·Π° Π·Π°ΠΌΠΎΠ²ΡΡΠ²Π°Π½Π½ΡΠΌ Π΄Π»Ρ Π²Π΅Π±ΡΠ°ΠΉΡΡ.
* `exclude_from_localization:` ΡΠ΅ΠΊΠΈ ΡΠ° ΠΊΠ°ΡΠ°Π»ΠΎΠ³ΠΈ, ΡΠΎ Ρ ΡΠ°ΡΡΠΈΠ½ΠΎΡ ΠΏΠΎΠ±ΡΠ΄ΠΎΠ²Π°Π½ΠΎΠ³ΠΎ Π²Π΅Π±ΡΠ°ΠΉΡΡ, Π°Π»Π΅ Π½Π΅ ΠΏΠΎΡΡΠ΅Π±ΡΡΡΡ Π»ΠΎΠΊΠ°Π»ΡΠ·Π°ΡΡΡ. Π¦Π΅ Π½Π°ΡΠ°ΠΌΠΏΠ΅ΡΠ΅Π΄ Π·Π°Π΄Π»Ρ ΡΠΊΠΎΡΠΎΡΠ΅Π½Π½Ρ ΡΠ°ΡΡ ΠΏΠΎΠ±ΡΠ΄ΠΎΠ²ΠΈ, Π° ΡΠ°ΠΊΠΎΠΆ ΡΠΎΠΌΡ, ΡΠΎ ΡΠ°ΠΉΠ»ΠΈ Π°ΠΊΡΠΈΠ²ΡΠ², ΡΠ°ΠΊΡ ΡΠΊ Π·ΠΎΠ±ΡΠ°ΠΆΠ΅Π½Π½Ρ ΡΠ° ΡΡΠΈΡΡΠΈ, Ρ Π²Π΅Π»ΠΈΠΊΠΈΠΌΠΈ ΡΠ°ΡΡΠΈΠ½Π°ΠΌΠΈ Π²Π΅Π±ΡΠ°ΠΉΡΡ, ΡΠΎ Π³Π°ΡΠ°Π½ΡΡΡ, ΡΠΎ Π²ΠΎΠ½ΠΈ Π½Π΅ Β«ΠΏΠ΅ΡΠ΅ΠΊΠ»Π°Π΄Π°ΡΠΈΠΌΡΡΡΡΡΒ» Π°Π±ΠΎ Π½Π΅ Π΄ΡΠ±Π»ΡΠ²Π°ΡΠΈΠΌΡΡΡΡΡ Ρ Π²ΠΈΡ
ΡΠ΄Π½ΠΈΡ
Π΄Π°Π½ΠΈΡ
Π±Π΅Π· ΠΏΠΎΡΡΠ΅Π±ΠΈ.
* `url` URL Π²Π°ΡΠΎΠ³ΠΎ ΠΏΡΠΎΠ΄Π°ΠΊΡΠ½-Π²Π΅Π±ΡΠ°ΠΉΡΡ.
### ΠΠΎΠ΄Π°Π²Π°Π½Π½Ρ Π½ΠΎΠ²ΠΎΡ ΠΌΠΎΠ²ΠΈ
Π―ΠΊΡΠΎ Ρ Π²Π°Ρ Π²ΠΆΠ΅ Ρ ΡΡΠ½ΠΊΡΡΠΎΠ½Π°Π»ΡΠ½ΠΈΠΉ ΠΎΠ΄Π½ΠΎΠΌΠΎΠ²Π½ΠΈΠΉ Π²Π΅Π±ΡΠ°ΠΉΡ, Π΄ΠΎΠ΄Π°Π²Π°Π½Π½Ρ Π½ΠΎΠ²ΠΎΡ ΠΌΠΎΠ²ΠΈ Π½Π΅ Π±ΡΠ΄Π΅ ΡΡΠΈΠ²ΡΠ°Π»ΡΠ½ΠΈΠΌ. _Π©ΠΎΠ± ΡΠΏΡΠ°Π²Π΄Ρ ΡΡΠ²ΠΎΡΠΈΡΠΈ Π±Π°Π³Π°ΡΠΎΠΌΠΎΠ²Π½ΠΈΠΉ Π²Π΅Π±ΡΠ°ΠΉΡ, ΠΎΡΡΠΊΡΠΉΡΠ΅, ΡΠΎ Π²Π°ΠΌ Π΄ΠΎΠ²Π΅Π΄Π΅ΡΡΡΡ ΠΏΠ΅ΡΠ΅ΡΠΎΠ±ΠΈΡΠΈ Π²Π΅ΡΡ ΡΠ²ΡΠΉ Π²ΠΌΡΡΡ Π½ΠΎΠ²ΠΎΡ ΠΌΠΎΠ²ΠΎΡ._ Π¦Π΅ ΠΌΠΎΠΆΠ΅ Π·Π΄Π°ΡΠΈΡΡ Π²Π΅Π»ΠΈΠΊΠΎΡ ΡΠΏΡΠ°Π²ΠΎΡ, Π°Π»Π΅ ΡΠΎΠ·Π³Π»ΡΠ½ΡΡΠ΅ ΠΏΠ΅ΡΠ΅ΠΊΠ»Π°Π΄ ΡΠ°ΡΡΠΈΠ½Π°ΠΌΠΈ. ΠΠΎΠ½ΡΠ΅Π½Ρ β ΠΊΠΎΡΠΎΠ»Ρ; Π²Π°ΠΆΠ»ΠΈΠ²ΡΡΠ΅, ΡΠΎΠ± Π½ΠΎΠ²Ρ ΡΡΠΎΡΡΠ½ΠΊΠΈ ΡΠ° Π΄ΠΎΠΏΠΈΡΠΈ ΠΎΡΡΠΈΠΌΡΠ²Π°Π»ΠΈ ΠΎΠ½ΠΎΠ²Π»Π΅Π½Ρ ΡΠ»ΠΎΠ²Π° Π² ΠΏΠ΅ΡΠ΅ΠΊΠ»Π°Π΄Ρ. Π‘ΡΠ²ΠΎΡΠ΅Π½Π½Ρ Π±Π°Π³Π°ΡΠΎΠΌΠΎΠ²Π½ΠΎΠ³ΠΎ Π²Π΅Π±ΡΠ°ΠΉΡΡ ΡΠΊΠ»Π°Π΄Π½ΠΎ Π»ΠΈΡΠ΅ ΡΠΎΠ΄Ρ, ΠΊΠΎΠ»ΠΈ Π²ΠΈ Π²ΠΈΠΌΠ°Π³Π°ΡΡΠ΅, ΡΠΎΠ± Π²ΡΠ½ Π±ΡΠ² ΡΠ΄Π΅Π°Π»ΡΠ½ΠΎ ΠΏΠ΅ΡΠ΅ΠΊΠ»Π°Π΄Π΅Π½ΠΈΠΉ Π· ΡΠ°ΠΌΠΎΠ³ΠΎ ΠΏΠΎΡΠ°ΡΠΊΡ.
ΠΠΎ-ΠΏΠ΅ΡΡΠ΅, Π²ΠΈ (Ρ Π²Π°ΡΠ° ΠΊΠΎΠΌΠ°Π½Π΄Π°, Ρ Π²Π°ΡΡ ΠΌΠ΅Π½Π΅Π΄ΠΆΠ΅ΡΠΈ ΡΠ΅ΠΆ, ΡΠΊΡΠΎ Ρ Π²Π°Ρ Ρ Π΄Π΅ΠΊΡΠ»ΡΠΊΠ° Π² Π½Π°ΡΠ²Π½ΠΎΡΡΡ) ΠΏΠΎΠ²ΠΈΠ½Π½Ρ ΠΎΠ±Π³ΠΎΠ²ΠΎΡΠΈΡΠΈ ΡΠ° Π²ΠΈΠ±ΡΠ°ΡΠΈ, ΡΠΊΠΈΠΉ Π²ΠΌΡΡΡ ΠΏΠΎΡΡΡΠ±Π½ΠΎ ΠΏΠ΅ΡΠ΅ΠΊΠ»Π°ΡΡΠΈ Π½Π° Π½ΠΎΠ²ΠΈΠΉ Π²Π΅Π±ΡΠ°ΠΉΡ. ΠΠΈ ΠΌΠ°ΡΡΠ΅ Π²ΠΈΠ±ΡΠ°ΡΠΈ ΡΠ²ΡΠΉ Π±Π°ΠΆΠ°Π½ΠΈΠΉ Π±Π°Π·ΠΎΠ²ΠΈΠΉ Π²ΠΌΡΡΡ Π΄Π»Ρ ΠΏΠ΅ΡΠ΅ΠΊΠ»Π°Π΄Ρ. Π ΠΎΠ·Π³Π»ΡΠ½ΡΡΠ΅ Π°Π½Π°Π»ΡΡΠΈΠΊΡ, ΠΏΠΎΠΏΡΠ»ΡΡΠ½Ρ ΡΡΠΎΡΡΠ½ΠΊΠΈ ΡΠ° Π±Π»ΠΎΠ³-Π΄ΠΎΠΏΠΈΡΠΈ, Π° ΡΠ°ΠΊΠΎΠΆ ΠΏΠΎΡΡΠΊ ΠΏΠΎΡΠΎΡΠ½ΠΈΡ
Ρ ΠΌΠ°ΠΉΠ±ΡΡΠ½ΡΡ
ΠΊΠΎΡΠΈΡΡΡΠ²Π°ΡΡΠ² Π²Π°ΡΠΎΠ³ΠΎ Π²Π΅Π±ΡΠ°ΠΉΡΡ. Π―ΠΊΡΠΎ ΡΡΠΌΠ½ΡΠ²Π°ΡΡΠ΅ΡΡ, Π½Π°Π΄Π°Π²Π°ΠΉΡΠ΅ ΠΏΠ΅ΡΠ΅Π²Π°Π³Ρ ΡΡΠΎΡΡΠ½ΠΊΠ°ΠΌ ΠΏΠ΅ΡΠ΅Π΄ Π·Π°ΡΡΠ°ΡΡΠ»ΠΈΠΌΠΈ Π±Π»ΠΎΠ³-Π΄ΠΎΠΏΠΈΡΠ°ΠΌΠΈ. Π―ΠΊΡΠΎ ΡΠ΅ ΠΎΠ·Π½Π°ΡΠ°Ρ ΡΠ²ΠΈΠ΄ΡΠΈΠΉ Π·Π°ΠΏΡΡΠΊ Π½ΠΎΠ²ΠΎΡ ΠΌΠΎΠ²ΠΈ, Π·Π°ΡΡΠ°ΡΡΠ»Ρ Π΄ΠΎΠΏΠΈΡΠΈ ΠΌΠΎΠΆΡΡΡ Π±ΡΡΠΈ Π½Π΅ Π²Π°ΡΡΠΈΠΌΠΈ Π·ΡΡΠΈΠ»Ρ ΠΏΠ΅ΡΠ΅ΠΊΠ»Π°Π΄Ρ.
ΠΠΎ-Π΄ΡΡΠ³Π΅, Π²ΠΈ ΠΏΠΎΠ²ΠΈΠ½Π½Ρ (Π°Π±ΠΎ Π½Π°ΠΏΠΎΠ»Π΅Π³Π»ΠΈΠ²ΠΎ ΡΠ΅ΠΊΠΎΠΌΠ΅Π½Π΄ΡΡΡΡΡΡ) Π·Π°Π±Π΅Π·ΠΏΠ΅ΡΠΈΡΠΈ 100% ΠΏΠΎΠΊΡΠΈΡΡΡ Π½Π°ΡΠΈΡΠ΅Π½ΠΎΠ³ΠΎ Π²ΠΌΡΡΡΡ Π²Π°ΡΠΎΠ³ΠΎ ΡΠ°ΠΉΡΡ. Π¦Π΅ ΠΌΠ°Π»Π΅Π½ΡΠΊΡ ΡΡΠ΄ΠΊΠΈ, Π²Π±ΡΠ΄ΠΎΠ²Π°Π½Ρ ΡΠΊΠ»Π°Π΄Π½ΡΡΠΈΠΌΠΈ ΡΠΏΠΎΡΠΎΠ±Π°ΠΌΠΈ. ΠΡΠ½ΡΡ ΠΊΡΠ»ΡΠΊΠ° ΡΠΏΠΎΡΠΎΠ±ΡΠ² ΡΡΠ΅ΡΡΠ²Π°ΡΠΈ Π½Π°ΡΠΈΡΠ΅Π½ΠΈΠΉ Π²ΠΌΡΡΡ. ΠΠ°ΠΌ'ΡΡΠ°ΠΉΡΠ΅, Π²ΠΈ ΠΏΠΎΠ²ΠΈΠ½Π½Ρ ΠΏΡΠ΄ΡΡΠΈΠΌΡΠ²Π°ΡΠΈ Π²ΡΡ ΠΌΠ°Π»Π΅Π½ΡΠΊΡ ΡΡΠ΄ΠΊΠΈ ΠΌΠΎΠ²ΠΈ Ρ ΡΠ²ΠΎΡΠΌΡ Π½Π°ΡΠΈΡΠ΅Π½ΠΎΠΌΡ Π²ΠΌΡΡΡΡ.
#### ΠΠ°Π³Π°ΡΠΎΠΌΠΎΠ²Π½ΠΈΠΉ Π²ΠΌΡΡΡ
ΠΠΌΡΡΡ Π²Π΅Π±ΡΠ°ΠΉΡΡ Π½Π°Π΄Ρ
ΠΎΠ΄ΠΈΡΡ Ρ Π΄Π²ΠΎΡ
Π²Π°ΡΡΠ°Π½ΡΠ°Ρ
: **Π±Π°Π·ΠΎΠ²ΠΈΠΉ** ΡΠ° **Π½Π°ΡΠΈΡΠ΅Π½ΠΈΠΉ**.
ΠΠ°Π·ΠΎΠ²ΠΈΠΉ Π²ΠΌΡΡΡ β ΡΠ΅ ΠΏΠ»ΠΎΡΠΊΠΈΠΉ ΡΠ΅ΠΊΡΡ Π±Π»ΠΎΠ³-Π΄ΠΎΠΏΠΈΡΡΠ², ΡΡΠΎΡΡΠ½ΠΎΠΊ Ρ Π½Π΅ΡΠ½ΡΠ΅ΡΠ°ΠΊΡΠΈΠ²Π½ΠΎΠ³ΠΎ Π²ΠΌΡΡΡΡ. ΠΠΎΠ΄ΡΠΌΠ°ΠΉΡΠ΅ ΠΏΡΠΎ ΡΡΠΎΡΡΠ½ΠΊΠΈ ΡΠ° Π΄ΠΎΠΏΠΈΡΠΈ. ΠΠ°Π·ΠΎΠ²ΠΈΠΉ Π²ΠΌΡΡΡ β ΡΠ΅ ΠΏΠ°Π»ΠΈΠ²ΠΎ Π΄Π»Ρ ΠΊΠ»ΡΠΊΡΠ² Π²Π°ΡΠΎΠ³ΠΎ Π²Π΅Π±ΡΠ°ΠΉΡΡ. Polyglot Π½Π°Π΄Π°Ρ Π±Π°Π·ΠΎΠ²ΠΎΠΌΡ Π²ΠΌΡΡΡΡ ΡΠ΅Π·Π΅ΡΠ²Π½Ρ ΠΏΡΠ΄ΡΡΠΈΠΌΠΊΡ.
ΠΠ°ΡΠΈΡΠ΅Π½ΠΈΠΉ Π²ΠΌΡΡΡ Ρ ΡΠ½ΡΠ΅ΡΠ°ΠΊΡΠΈΠ²Π½ΠΈΠΌ, Π΅ΡΠ΅ΠΊΡΠ½ΠΈΠΌ Ρ ΡΠΊΠ»Π°Π΄Π°ΡΡΡΡΡ Π· ΠΊΠΎΡΠΎΡΡΠΈΡ
ΡΡΠ΄ΠΊΡΠ². ΠΠΎΠ΄ΡΠΌΠ°ΠΉΡΠ΅ ΠΏΡΠΎ Π½Π°Π²ΡΠ³Π°ΡΡΠΉΠ½Ρ ΠΏΠ°Π½Π΅Π»Ρ ΡΠ° Π²ΠΈΠΏΠ°Π΄Π½Ρ ΠΌΠ΅Π½Ρ. ΠΠ°ΡΠΈΡΠ΅Π½ΠΈΠΉ Π²ΠΌΡΡΡ Ρ Π±ΡΠ»ΡΡ ΡΠ΅Ρ
Π½ΡΡΠ½ΠΈΠΌ Ρ ΡΡΡΠΈΠΌΡΡ Π²Π°ΡΠΈΡ
Π²ΡΠ΄Π²ΡΠ΄ΡΠ²Π°ΡΡΠ² Π½Π° ΡΠ°ΠΉΡΡ. _ΠΠ΅ΠΌΠ°Ρ ΡΠ΅Π·Π΅ΡΠ²Π½ΠΎΡ ΠΏΡΠ΄ΡΡΠΈΠΌΠΊΠΈ Π΄Π»Ρ Π²ΡΠ΄ΡΡΡΠ½ΡΠΎΠ³ΠΎ Π½Π°ΡΠΈΡΠ΅Π½ΠΎΠ³ΠΎ Π²ΠΌΡΡΡΡ._
#### ΠΠ½ΡΡΡΡΠΌΠ΅Π½ΡΠΈ Liquid
ΠΠ°ΡΡΡΠΏΠ½Ρ ΡΠ½ΡΡΡΡΠΌΠ΅Π½ΡΠΈ liquid Π΄ΠΎΡΡΡΠΏΠ½Ρ Π΄Π»Ρ Π²ΠΈΠΊΠΎΡΠΈΡΡΠ°Π½Π½Ρ Π· jekyll-polyglot:
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages` Π²ΠΊΠ°Π·ΡΡ Π±Π΅Π·ΠΏΠΎΡΠ΅ΡΠ΅Π΄Π½ΡΠΎ Π½Π° ΠΌΠ°ΡΠΈΠ² `languages` Ρ _config.yml. ΠΠΎ Π½ΡΠΎΠ³ΠΎ ΠΌΠΎΠΆΠ½Π° ΠΎΡΡΠΈΠΌΠ°ΡΠΈ Π΄ΠΎΡΡΡΠΏ ΡΠ΅ΡΠ΅Π· liquid.
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang` Π²ΠΊΠ°Π·ΡΡ Π±Π΅Π·ΠΏΠΎΡΠ΅ΡΠ΅Π΄Π½ΡΠΎ Π½Π° ΡΡΠ΄ΠΎΠΊ `default_lang` Ρ _config.yml. ΠΠΎ Π½ΡΠΎΠ³ΠΎ ΠΌΠΎΠΆΠ½Π° ΠΎΡΡΠΈΠΌΠ°ΡΠΈ Π΄ΠΎΡΡΡΠΏ ΡΠ΅ΡΠ΅Π· liquid.
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang` β ΡΠ΅ ΠΊΠΎΠ΄ Π»ΠΎΠΊΠ°Π»Ρ, Π΄Π»Ρ ΡΠΊΠΎΠ³ΠΎ ΡΡΠ²ΠΎΡΡΡΡΡΡΡ ΡΡΠΎΡΡΠ½ΠΊΠ°. Π¦Π΅ `"de"` Π΄Π»Ρ Π½ΡΠΌΠ΅ΡΡΠΊΠΎΡ Π²Π΅ΡΡΡΡ ΡΡΠΎΡΡΠ½ΠΊΠΈ, `"es"` Π΄Π»Ρ ΡΡΠΏΠ°Π½ΡΡΠΊΠΎΡ Π²Π΅ΡΡΡΡ Ρ ΡΠ°ΠΊ Π΄Π°Π»Ρ. ΠΠΎ Π½ΡΠΎΠ³ΠΎ ΠΌΠΎΠΆΠ½Π° ΠΎΡΡΠΈΠΌΠ°ΡΠΈ Π΄ΠΎΡΡΡΠΏ ΡΠ΅ΡΠ΅Π· liquid.
ΠΠΈΠΊΠΎΡΠΈΡΡΠΎΠ²ΡΡΡΠΈ ΡΡ ΡΠ½ΡΡΡΡΠΌΠ΅Π½ΡΠΈ, Π²ΠΈ ΠΌΠΎΠΆΠ΅ΡΠ΅ Π²ΠΊΠ°Π·Π°ΡΠΈ, ΡΠΊ ΠΏΡΠΈΡΠ΄Π½Π°ΡΠΈ ΠΏΡΠ°Π²ΠΈΠ»ΡΠ½ΠΈΠΉ Π½Π°ΡΠΈΡΠ΅Π½ΠΈΠΉ Π²ΠΌΡΡΡ.
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
ΠΠΌΡΠ½Π½Π° `page.rendered_lang` Π²ΠΊΠ°Π·ΡΡ ΡΠ°ΠΊΡΠΈΡΠ½Ρ ΠΌΠΎΠ²Ρ Π²ΠΌΡΡΡΡ ΡΡΠΎΡΡΠ½ΠΊΠΈ, Π΄ΠΎΠ·Π²ΠΎΠ»ΡΡΡΠΈ ΡΠ°Π±Π»ΠΎΠ½Π°ΠΌ Π²ΠΈΠ·Π½Π°ΡΠ°ΡΠΈ, ΠΊΠΎΠ»ΠΈ ΡΡΠΎΡΡΠ½ΠΊΠ° ΠΎΠ±ΡΠ»ΡΠ³ΠΎΠ²ΡΡΡΡΡΡ ΡΠΊ ΡΠ΅Π·Π΅ΡΠ²Π½ΠΈΠΉ Π²ΠΌΡΡΡ.
### ΠΡΠ΄ΡΡΠΈΠΌΠΊΠ° Github Pages
ΠΠ° Π·Π°ΠΌΠΎΠ²ΡΡΠ²Π°Π½Π½ΡΠΌ github Π½Π΅ Π΄ΠΎΠ·Π²ΠΎΠ»ΡΡ [Π±Π»ΠΎΠ³Π°ΠΌ jekyll Π²ΠΈΠΊΠΎΡΠΈΡΡΠΎΠ²ΡΠ²Π°ΡΠΈ ΠΏΠ»Π°Π³ΡΠ½ΠΈ](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides). Π¦Π΅ Π·ΡΠΎΠ±Π»Π΅Π½ΠΎ Π½Π°Π²ΠΌΠΈΡΠ½ΠΎ, ΡΠΎΠ± Π·Π°ΠΏΠΎΠ±ΡΠ³ΡΠΈ Π²ΠΈΠΊΠΎΠ½Π°Π½Π½Ρ ΡΠΊΡΠ΄Π»ΠΈΠ²ΠΎΠ³ΠΎ ΠΊΠΎΠ΄Ρ Π½Π° ΡΠ΅ΡΠ²Π΅ΡΠ°Ρ
github. Π₯ΠΎΡΠ° ΡΠ΅ ΡΡΠΊΠ»Π°Π΄Π½ΡΡ Π²ΠΈΠΊΠΎΡΠΈΡΡΠ°Π½Π½Ρ Polyglot (ΡΠ° ΡΠ½ΡΠΈΡ
ΠΏΠ»Π°Π³ΡΠ½ΡΠ² jekyll), ΡΠ΅ Π²ΡΠ΅ ΡΠ΅ ΠΌΠΎΠΆΠ»ΠΈΠ²ΠΎ.
#### ΠΠΎΠ±ΡΠ΄ΠΎΠ²Π° `_site/` Ρ gh-pages
ΠΠ°ΠΌΡΡΡΡ ΡΠΎΠ³ΠΎ, ΡΠΎΠ± ΡΠΎΠ·ΠΌΡΡΡΠΈΡΠΈ ΡΠ²ΡΠΉ Π±Π»ΠΎΠ³ΠΎΠ²ΠΈΠΉ ΡΡΡΡΠΉ Jekyll Π½Π° github, Π²ΠΈ ΠΌΠΎΠΆΠ΅ΡΠ΅ ΡΠΎΠ·ΡΠΎΠ±Π»ΡΡΠΈ ΡΠ²ΡΠΉ Π²Π΅Π±ΡΠ°ΠΉΡ jekyll Π½Π° ΠΎΠΊΡΠ΅ΠΌΡΠΉ Π³ΡΠ»ΡΡ, Π° ΠΏΠΎΡΡΠΌ Π½Π°Π΄ΡΠΈΠ»Π°ΡΠΈ ΠΏΠΎΠ±ΡΠ΄ΠΎΠ²Π°Π½ΠΈΠΉ Π²ΠΌΡΡΡ `_site/` Ρ Π²Π°ΡΡ Π³ΡΠ»ΠΊΡ `gh-pages`. Π¦Π΅ Π΄ΠΎΠ·Π²ΠΎΠ»ΡΡ ΠΊΠ΅ΡΡΠ²Π°ΡΠΈ ΡΠ° ΠΊΠΎΠ½ΡΡΠΎΠ»ΡΠ²Π°ΡΠΈ Π΄ΠΆΠ΅ΡΠ΅Π»ΠΎ ΡΠΎΠ·ΡΠΎΠ±ΠΊΠΈ Π²Π°ΡΠΎΠ³ΠΎ Π²Π΅Π±ΡΠ°ΠΉΡΡ Π·Π° Π΄ΠΎΠΏΠΎΠΌΠΎΠ³ΠΎΡ github *Π±Π΅Π· Π½Π΅ΠΎΠ±Ρ
ΡΠ΄Π½ΠΎΡΡΡ ΠΏΠΎΠΊΠ»Π°Π΄Π°ΡΠΈΡΡ Π½Π° github Π΄Π»Ρ ΠΏΠΎΠ±ΡΠ΄ΠΎΠ²ΠΈ Π²Π°ΡΠΎΠ³ΠΎ Π²Π΅Π±ΡΠ°ΠΉΡΡ!*
ΠΠΈ ΠΌΠΎΠΆΠ΅ΡΠ΅ Π·ΡΠΎΠ±ΠΈΡΠΈ ΡΠ΅, Π·Π±Π΅ΡΡΠ³Π°ΡΡΠΈ ΡΠ²ΡΠΉ Π²ΠΌΡΡΡ Jekyll Π½Π° ΠΎΠΊΡΠ΅ΠΌΡΠΉ Π³ΡΠ»ΡΡ ΡΠ° ΡΡΠΊΡΡΡΡΠΈ Π»ΠΈΡΠ΅ ΡΠ΅ΠΊΡ `_site/` Ρ ΡΠ²ΠΎΡΠΉ Π³ΡΠ»ΡΡ gh-pages. ΠΡΠΊΡΠ»ΡΠΊΠΈ ΡΠ΅ Π»ΠΈΡΠ΅ ΡΡΠ°ΡΠΈΡΠ½Ρ html-ΡΡΠΎΡΡΠ½ΠΊΠΈ Π² ΡΠ΅ΠΊΠ°Ρ
, github Π±ΡΠ΄Π΅ Ρ
ΠΎΡΡΠΈΡΠΈ ΡΡ
ΡΠΊ Π±ΡΠ΄Ρ-ΡΠΊΠΈΠΉ ΡΠ½ΡΠΈΠΉ Π²ΠΌΡΡΡ [gh-pages](https://pages.github.com/).
#### ΠΠ²ΡΠΎΠΌΠ°ΡΠΈΠ·ΡΠΉΡΠ΅ ΡΠ΅!
Π¦Π΅ΠΉ ΠΏΡΠΎΡΠ΅Ρ Π·Π½Π°ΡΠ½ΠΎ ΠΏΠΎΠ»Π΅Π³ΡΡΡΡΡΡΡ ΠΏΡΠΎΡΡΠΈΠΌ ΡΠΊΡΠΈΠΏΡΠΎΠΌ, ΡΠΊΠΈΠΉ ΡΡΠ²ΠΎΡΠΈΡΡ Π²Π°Ρ Π²Π΅Π±ΡΠ°ΠΉΡ Ρ Π·Π°ΡΡΠΊΡΡΡ ΡΠ΅ΠΊΡ `_site/` Ρ Π²Π°ΡΠΎΠΌΡ gh-pages. Π£ Π±Π°Π³Π°ΡΡΠΎΡ
Π»ΡΠ΄Π΅ΠΉ ΡΠ°ΠΊΠΈΠΉ Ρ. [ΠΡΡ ΠΎΠ΄ΠΈΠ½](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/). [ΠΡΡ ΡΠ΅ ΠΎΠ΄ΠΈΠ½](https://gist.github.com/cobyism/4730490). ΠΡΡ [ΠΌΡΠΉ ΡΠΊΡΠΈΠΏΡ ΠΏΡΠ±Π»ΡΠΊΠ°ΡΡΡ](https://github.com/untra/polyglot/blob/main/publi.sh):
```bash
#! /bin/sh
# change the branch names appropriately
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/about.zh-CN.md 0000664 0000000 0000000 00000013633 15201735340 0020402 0 ustar 00root root 0000000 0000000 ---
layout: page
title: ε
³δΊ
permalink: about/
lang: zh-CN
---
Polyglot ζ―δΈζ¬ΎδΈε±δΊ Jekyll εε’ηε½ι
εζδ»ΆγPolyglot ζδΊεθ£
οΌδΈιη¨δΊδ»»δ½ι‘ΉηοΌδ»₯εδ»»δ½δ½ ζιθ¦ηθ―θ¨γζδΊ Polyglot ηε―ΉηΌΊε€±ε
εΉηεΊεζ―ζγURL θͺε¨ηΈε―Ήεε€ηοΌδ»₯ε强倧η SEO δΌε οΌζ¨ε―δ»₯ε¨εδ½ε€θ―θ¨εε’ζΆζ΄ε δΈζ³¨δΊε
εΉοΌθιε€ηζζ―δΈηθζ΄»η΄―ζ΄»γ
_`jekyll-polyglot` ε°ζͺε¨ github-actions δΈεηζ―ζ_
### εθ£
{% highlight bash %}
gem install jekyll-polyglot
{% endhighlight %}
### η‘ηζ―ζηθ―θ¨
ε¨ `_config.yml` δΈοΌδ»₯δΈε±ζ§η‘ηζ¨η½η«ζ―ζηθ―θ¨γζ¨ε―δ»₯ιθΏε°ζ°θ―θ¨ζ·»ε ε°θΏδΊεΌζ₯ζδΎζ―ζοΌθ§δΈζοΌγθ―θ¨ιθΏε
ΆεζΉ[εΊε代η ](https://developer.chrome.com/webstore/i18n)ζ₯θ―ε«γ
```yml
languages: ["en", "es", "fr", "de"]
default_lang: "en"
exclude_from_localization: ["images", "fonts", "sitemap"]
url: https://polyglot.untra.io
```
* `languages:` ζ θ―η½η«ζ―ζηθ―θ¨ηεΊε代η ζ°η»γ
* `default_lang:` η½η«ηι»θ€θ―θ¨γ
* `exclude_from_localization:` ε±δΊζε»Ίη½η«δ½δΈιθ¦ζ¬ε°εηζδ»Άε€Ήεηε½γθΏδΈ»θ¦ζ―δΈΊδΊηΌ©ηζε»ΊζΆι΄οΌη±δΊεΎηεεδ½ηθ΅ζΊζδ»Άζ―η½η«ηιθ¦ι¨εοΌθΏη‘δΏε们δΈδΌε¨θΎεΊδΈθ’«δΈεΏ
θ¦ε°"ηΏ»θ―"ζε€εΆγ
* `url` ζ¨ηηδΊ§ιζη½η«η URLγ
### ζ·»ε ζ°θ―θ¨
εθΎζ¨ε·²η»ζδΈδΈͺεθ½ζ£εΈΈηεθ―θ¨η½η«οΌζ·»ε ζ°θ―θ¨εΉΆδΈηεγ_θ¦ηζ£εε»ΊδΈδΈͺε€θ―θ¨η½η«οΌζ¨εΊθ―₯ι’ζιθ¦η¨ζ°θ―θ¨ιζ°εε»Ίζζε
εΉγ_ θΏε―θ½ηθ΅·ζ₯ζ―δΈι‘Ήθ°ε·¨ηδ»»ε‘οΌδ½θ―·ει¨εθθηΏ»θ―γε
εΉδΈΊηοΌζ°ι‘΅ι’εεΈεθ·εΎζ΄ζ°ηηΏ»θ―ζ΄δΈΊιθ¦γεͺζε½ζ¨θ¦ζ±δ»δΈεΌε§ε°±εηΎηΏ»θ―ζΆοΌεε»Ίε€θ―θ¨η½η«ζδΌε°ιΎγ
ι¦ε
οΌζ¨οΌεζ¨ηε’ιοΌδ»₯εζ¨ηη»ηοΌε¦ζζηθ―οΌεΊθ―₯θ¨θΊεΉΆιζ©ιθ¦δΈΊζ°η½η«ηΏ»θ―εͺδΊε
εΉγζ¨εΏ
ι‘»ιζ©ι¦ιηεΊη‘ε
εΉθΏθ‘ηΏ»θ―γθθεζζ°ζγηι¨ι‘΅ι’εεε’εΈεοΌδ»₯εε½εεζͺζ₯η¨ζ·θΏιζ¨η½η«ηζ΅ιγε¦ζηιοΌδΌε
θθι‘΅ι’θιζ§εε’εΈεγε¦ζθΏζε³ηε―δ»₯ζ΄ζ©ζ¨εΊζ°θ―θ¨οΌζ§εΈεηηΏ»θ―ε―θ½δΈεΌεΎδ»εΊι£δΉε€εͺεγ
ε
Άζ¬‘οΌζ¨εΏ
ι‘»οΌζεΌΊηε»ΊθοΌε¨ζ΄δΈͺη½η«ζδΎ100%ηε―ε
εΉθ¦ηγθΏδΊζ―δ»₯ζ΄ε€ζζΉεΌε΅ε
₯ηε°ε符串γζε€η§ζΉζ³ε―δ»₯ιεε―ε
εΉγθ―·θ°δ½οΌζ¨εΏ
ι‘»ε¨ε―ε
εΉδΈζ―ζζζθ―θ¨ηζζε°ε符串γ
#### ε€θ―θ¨ε
εΉ
η½η«ε
εΉεδΈΊδΈ€η§η±»εοΌ**εΊη‘**ε**ε―ε
εΉ**γ
εΊη‘ε
εΉζ―εε’εΈεγι‘΅ι’ειδΊ€δΊεΌε
εΉηηΊ―ζζ¬γζ³ζ³ι‘΅ι’εεΈεγεΊη‘ε
εΉζ―η½η«ηΉε»ηηζγPolyglot δΈΊεΊη‘ε
εΉζδΎειζ―ζγ
ε―ε
εΉζ―δΊ€δΊεΌηγεδΈ½ηοΌη±θΎηηε符串η»ζγζ³ζ³ε―Όθͺζ εδΈζθεγε―ε
εΉζ΄ε
·ζζ―ζ§οΌθ©θΏε’ηε¨η½η«δΈγ_ηΌΊε€±ηε―ε
εΉζ²‘ζειζ―ζγ_
#### Liquid ε·₯ε
·
δ»₯δΈ Liquid ε·₯ε
·ε―δΈ jekyll-polyglot δΈθ΅·δ½Ώη¨οΌ
* **site.languages**
{% highlight html %}
{% raw %}
{% for lang in site.languages %}
{{lang}}
{% endfor %}
{% endraw %}
{% endhighlight %}
`site.languages` η΄ζ₯ζε _config.yml δΈη `languages` ζ°η»γε―δ»₯ιθΏ Liquid θΏιγ
* **site.default_lang**
{% highlight html %}
{% raw %}
{{site.default_lang}}
{% endraw %}
{% endhighlight %}
`site.default_lang` η΄ζ₯ζε _config.yml δΈη `default_lang` ε符串γε―δ»₯ιθΏ Liquid θΏιγ
* **site.active_lang**
{% highlight html %}
{% raw %}
{% if site.active_lang == "es" %}
Hola! Como estas?
{% endif %}
{% endraw %}
{% endhighlight %}
`site.active_lang` ζ―ζ£ε¨ζε»Ίι‘΅ι’ηεΊε代η γεΎ·θ―ηι‘΅ι’ζ― `"de"`οΌθ₯Ώηηθ―ηζ― `"es"`οΌδΎζ€η±»ζ¨γε―δ»₯ιθΏ Liquid θΏιγ
δ½Ώη¨θΏδΊε·₯ε
·οΌζ¨ε―δ»₯ζεε¦δ½ιε ζ£η‘ηε―ε
εΉγ
* **page.rendered_lang**
{% highlight html %}
{% raw %}
{% if page.rendered_lang == site.active_lang %}
Welcome to our {{ site.active_lang }} webpage!
{% else %}
webpage available in {{ page.rendered_lang }} only.
{% endif %}
{% endraw %}
{% endhighlight %}
`page.rendered_lang` ει葨瀺鑡ι’ε
εΉηει
θ―θ¨οΌε
θΈζ¨‘ζΏζ£ζ΅ι‘΅ι’δ½ζΆδ½δΈΊειε
εΉζδΎγ
### Github Pages ζ―ζ
ι»θ€ζ
ε΅δΈοΌGithub ι»ζ’ [Jekyll εε’δ½Ώη¨ζδ»Ά](https://help.github.com/articles/using-jekyll-with-pages/#configuration-overrides)γθΏζ―ζ
ζηοΌδ»₯ι²ζ’ζΆζ代η ε¨ Github ζε‘ε¨δΈζ§θ‘γθ½ηΆθΏδ½ΏεΎδ½Ώη¨ PolyglotοΌεε
Άδ» Jekyll ζδ»ΆοΌζ΄ε ε°ιΎοΌδ½δ»ηΆε―θ‘γ
#### ε° `_site/` ζε»Ίε° gh-pages
ζ¨ε―δ»₯ε¨εη¬ηεζ―δΈεΌε Jekyll η½η«οΌηΆεε°ζε»Ίη `_site/` ε
εΉζ¨ιε° `gh-pages` εζ―οΌθδΈζ―ε¨ Github δΈζη‘ Jekyll εε’εΌζγθΏε
θΈζ¨δ½Ώη¨ Github η‘ηεζΊδ»£η ζ§εΆζ¨ηη½η«εΌεοΌ*θζ ιδΎθ΅ Github ζ₯ζε»Ίζ¨ηη½η«οΌ*
ζ¨ε―δ»₯ιθΏε¨εη¬ηεζ―δΈη»΄ζ€ Jekyll ε
εΉοΌεͺε° `_site/` ζδ»Άε€ΉζδΊ€ε° gh-pages εζ―ζ₯εη°γε δΈΊθΏδΊεͺζ―ζδ»Άε€ΉδΈηιζ HTML ι‘΅ι’οΌGithub δΌεε
Άδ»δ»»δ½ [gh-pages](https://pages.github.com/) ε
εΉδΈζ ·ζη‘ε们γ
#### θͺε¨εοΌ
θΏδΈͺθΏη¨ιθΏδΈδΈͺηεηθζ¬ε€§ε€§ηεοΌθ―₯θζ¬ε°ζε»Ίζ¨ηη½η«εΉΆε° `_site/` ζδ»Άε€ΉζδΊ€ε°ζ¨η gh-pagesγεΎε€δΊΊι½ζδΈδΈͺγ[θΏιζδΈδΈͺ](http://www.jokecamp.com/blog/Simple-jekyll-deployment-with-a-shell-script-and-github/)γ[θΏιθΏζδΈδΈͺ](https://gist.github.com/cobyism/4730490)γθΏζ―[ζηεεΈθζ¬](https://github.com/untra/polyglot/blob/main/publi.sh)οΌ
```bash
#! /bin/sh
# ηΈεΊε°ζ΄ζΉεζ―εη§°
rm -rf site/_site/
cd site && bundle exec jekyll build && cd ..
git add site/_site/ && git commit -m "$(date)"
git subtree push --prefix site/_site origin gh-pages
```
untra-polyglot-e688c05/site/complex-permalink-he.md 0000664 0000000 0000000 00000001304 15201735340 0022363 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Χ§ΧΧ©ΧΧ¨ Χ§ΧΧΧ’ ΧΧΧ© ΧΧ¨ΧΧ
permalink: a-really-long-hebrew/permalink/
lang: he
page_id: complex-permalink
description: ΧΧ£ ΧΧ ΧΧΧΧΧ ΧΧΧ¦Χ Jekyll Polyglot ΧΧΧΧ ΧΧΧ¦ΧΧ¨ ΧΧΧͺΧΧΧ§ Χ§ΧΧ©ΧΧ¨ΧΧ Χ§ΧΧΧ’ΧΧ ΧΧΧͺΧΧΧΧ ΧΧΧ©ΧΧͺ ΧͺΧΧ Χ©ΧΧΧ¨Χ Χ’Χ ΧΧΧ Χ ΧΧΧͺΧ¨.
---
ΧΧ§ΧΧ©ΧΧ¨ ΧΧ§ΧΧΧ’ ΧΧΧ ΧΧΧΧͺ ΧΧ¨ΧΧ ΧΧΧΧ¨ΧΧ
ΧΧΧΧ£ ΧΧΧ ΧΧͺΧΧΧ Χ’Χ Χ’ΧΧͺΧ§ΧΧ ΧΧΧ Χ©Χ€Χ Χ ΧͺΧΧΧͺ Χ’Χ ΧΧΧ `page_id`.
If you use `jekyll-redirect-from` and a customized [redirect.html layout](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html), this permalink will be redirected when viewed from different languages. untra-polyglot-e688c05/site/complex-permalink.ar.md 0000664 0000000 0000000 00000001400 15201735340 0022367 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Ψ±Ψ§Ψ¨Ψ· Ψ―Ψ§Ψ¦Ω
Ψ·ΩΩΩ Ψ¬Ψ―Ψ§Ω
permalink: a-really-long/permalink/
lang: ar
page_id: complex-permalink
description: ΩΨ°Ω Ψ§ΩΨ΅ΩΨΨ© ΨͺΩΨΆΨ ΩΩΩ ΩΩ
ΩΩ ΩΩ jekyll polyglot Ψ₯ΩΨ΄Ψ§Ψ‘ ΩΨ΅ΩΨ§ΩΨ© Ψ±ΩΨ§Ψ¨Ψ· Ψ―Ψ§Ψ¦Ω
Ψ© Ω
ΨΨ΅Ψ΅Ψ© Ω
ΨΉ Ψ§ΩΨΩΨ§ΨΈ ΨΉΩΩ ΩΩΩΩ Ψ§ΩΩ
ΩΩΨΉ.
---
ΩΨ°Ψ§ Ψ§ΩΨ±Ψ§Ψ¨Ψ· Ψ§ΩΨ―Ψ§Ψ¦Ω
Ψ·ΩΩΩ ΩΩ
ΨΉΩΨ― Ψ¬Ψ―Ψ§Ω.
ΩΩΨ°Ω Ψ§ΩΨ΅ΩΨΨ© ΩΨ³Ψ¨ΩΨ© ΩΩ
ΨͺΩΨ³ΩΨ© Ω
ΨΉ ΩΨ³Ψ ΩΩΩ ΩΨΊΨ© Ω
Ψ―ΨΉΩΩ
Ψ© Ψ¨ΩΨ§Ψ³Ψ·Ψ© `page_id`.
Ψ₯Ψ°Ψ§ ΩΩΨͺ ΨͺΨ³ΨͺΨΨ―Ω
`jekyll-redirect-from` ΩΨͺΨΨ·ΩΨ· [redirect.html Ω
ΨΨ΅Ψ΅](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html)Ψ Ψ³ΩΨͺΩ
Ψ₯ΨΉΨ§Ψ―Ψ© ΨͺΩΨ¬ΩΩ ΩΨ°Ψ§ Ψ§ΩΨ±Ψ§Ψ¨Ψ· Ψ§ΩΨ―Ψ§Ψ¦Ω
ΨΉΩΨ― ΨΉΨ±ΨΆΩ Ω
Ω ΩΨΊΨ§Ψͺ Ω
ΨΨͺΩΩΨ©.
untra-polyglot-e688c05/site/complex-permalink.de.md 0000664 0000000 0000000 00000001274 15201735340 0022366 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Eine wirklich lange permalink
permalink: eine-wirklich-lange/permalink/
lang: de
page_id: complex-permalink
description: diese Seite zeigt, wie jekyll polyglot benutzerdefinierte permanente Links erstellen und verwalten kann, wΓ€hrend die Site-Struktur beibehalten wird.
---
Permalink ist wirklich lang und komplex.
En deze pagina is gerelativeerd en gecoΓΆrdineerd met kopieΓ«n voor elke ondersteunde taal `page_id`.
Wenn Sie `jekyll-redirect-from` und ein benutzerdefiniertes [redirect.html-Layout](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html) verwenden, wird dieser Permalink umgeleitet wenn sie aus verschiedenen Sprachen betrachtet werden.
untra-polyglot-e688c05/site/complex-permalink.en.md 0000664 0000000 0000000 00000001157 15201735340 0022400 0 ustar 00root root 0000000 0000000 ---
layout: page
title: A really long permalink
permalink: a-really-long/permalink/
lang: en
page_id: complex-permalink
description: this page demonstrates how jekyll polyglot can create and maintain customized permalinks while retaining site structure.
---
This permalink is really long and complex.
And this page is relativized and coordinated with copies for each supported language by `page_id`.
If you use `jekyll-redirect-from` and a customized [redirect.html layout](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html), this permalink will be redirected when viewed from different languages.
untra-polyglot-e688c05/site/complex-permalink.es.md 0000664 0000000 0000000 00000001216 15201735340 0022401 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Un muy largo permalink
permalink: una-muy-larga/permalink/
lang: es
page_id: complex-permalink
description: esta pΓ‘gina demuestra cΓ³mo jekyll polyglot puede crear y mantener enlaces permanentes personalizados mientras se mantiene la estructura del sitio.
---
Este enlace permanente es muy largo y complejo.
Y esta pΓ‘gina estΓ‘ relativizada y coordinada con copias para cada idioma soportado por `page_id`.
Si utiliza `jekyll-redirect-from` y un [diseΓ±o de redirect.html](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html), este enlace permanente serΓ‘ redirigido cuando se ve desde diferentes idiomas. untra-polyglot-e688c05/site/complex-permalink.fr.md 0000664 0000000 0000000 00000001212 15201735340 0022375 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Un très long permalink
permalink: un-tres-long/permalink/
lang: fr
page_id: complex-permalink
description: cette page dΓ©montre comment jekyll polyglot peut crΓ©er et maintenir des liens permanents personnalisΓ©s tout en conservant la structure du site.
---
Ce permalien est vraiment long et complexe.
Et cette page est relativisΓ©e et coordonnΓ©e avec des copies pour chaque langue supportΓ©e par `page_id`.
Si vous utilisez `jekyll-redirect-from` et une mise en page [redirect.html](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html), ce lien permanent sera redirigΓ© vu dans diffΓ©rentes langues.
untra-polyglot-e688c05/site/complex-permalink.hi.md 0000664 0000000 0000000 00000002373 15201735340 0022377 0 ustar 00root root 0000000 0000000 ---
layout: page
title: ΰ€ΰ€ ΰ€΅ΰ€Ύΰ€Έΰ₯ΰ€€ΰ€΅ ΰ€ΰ₯ΰ€ ΰ€²ΰ€ΰ€¬ΰ€Ύ ΰ€ͺΰ€°ΰ₯ΰ€ΰ€Ύΰ€²ΰ€Ώΰ€ΰ€
permalink: a-really-long/permalink/
lang: hi
page_id: complex-permalink
description: ΰ€―ΰ€Ή ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ ΰ€ͺΰ₯ΰ€°ΰ€¦ΰ€°ΰ₯ΰ€Άΰ€Ώΰ€€ ΰ€ΰ€°ΰ€€ΰ€Ύ ΰ€Ήΰ₯ ΰ€ΰ€Ώ jekyll polyglot ΰ€Έΰ€Ύΰ€ΰ€ ΰ€Έΰ€ΰ€°ΰ€ΰ€¨ΰ€Ύ ΰ€ΰ₯ ΰ€¬ΰ€¨ΰ€Ύΰ€ ΰ€°ΰ€ΰ€€ΰ₯ ΰ€Ήΰ₯ΰ€ ΰ€ΰ₯ΰ€Έΰ₯ ΰ€
ΰ€¨ΰ₯ΰ€ΰ₯ΰ€²ΰ€Ώΰ€€ ΰ€ͺΰ€°ΰ₯ΰ€ΰ€Ύΰ€²ΰ€Ώΰ€ΰ€ ΰ€¬ΰ€¨ΰ€Ύ ΰ€ΰ€° ΰ€¬ΰ€¨ΰ€Ύΰ€ ΰ€°ΰ€ ΰ€Έΰ€ΰ€€ΰ€Ύ ΰ€Ήΰ₯ΰ₯€
---
ΰ€―ΰ€Ή ΰ€ͺΰ€°ΰ₯ΰ€ΰ€Ύΰ€²ΰ€Ώΰ€ΰ€ ΰ€΅ΰ€Ύΰ€Έΰ₯ΰ€€ΰ€΅ ΰ€ΰ₯ΰ€ ΰ€²ΰ€ΰ€¬ΰ€Ύ ΰ€ΰ€° ΰ€ΰ€ΰ€Ώΰ€² ΰ€Ήΰ₯ΰ₯€
ΰ€ΰ€° ΰ€―ΰ€Ή ΰ€ͺΰ₯ΰ€·ΰ₯ΰ€ `page_id` ΰ€¦ΰ₯ΰ€΅ΰ€Ύΰ€°ΰ€Ύ ΰ€ͺΰ₯ΰ€°ΰ€€ΰ₯ΰ€―ΰ₯ΰ€ ΰ€Έΰ€ΰ€°ΰ₯ΰ€₯ΰ€Ώΰ€€ ΰ€ΰ€Ύΰ€·ΰ€Ύ ΰ€ΰ₯ ΰ€²ΰ€Ώΰ€ ΰ€ͺΰ₯ΰ€°ΰ€€ΰ€Ώΰ€―ΰ₯ΰ€ ΰ€ΰ₯ ΰ€Έΰ€Ύΰ€₯ ΰ€Έΰ€Ύΰ€ͺΰ₯ΰ€ΰ₯ΰ€·ΰ₯ΰ€ΰ₯ΰ€€ ΰ€ΰ€° ΰ€Έΰ€ΰ€¨ΰ₯ΰ€΅ΰ€Ώΰ€€ ΰ€Ήΰ₯ΰ₯€
ΰ€―ΰ€¦ΰ€Ώ ΰ€ΰ€ͺ `jekyll-redirect-from` ΰ€ΰ€° ΰ€ΰ€ ΰ€
ΰ€¨ΰ₯ΰ€ΰ₯ΰ€²ΰ€Ώΰ€€ [redirect.html ΰ€²ΰ₯ΰ€ΰ€ΰ€](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html) ΰ€ΰ€Ύ ΰ€ΰ€ͺΰ€―ΰ₯ΰ€ ΰ€ΰ€°ΰ€€ΰ₯ ΰ€Ήΰ₯ΰ€, ΰ€€ΰ₯ ΰ€―ΰ€Ή ΰ€ͺΰ€°ΰ₯ΰ€ΰ€Ύΰ€²ΰ€Ώΰ€ΰ€ ΰ€΅ΰ€Ώΰ€ΰ€Ώΰ€¨ΰ₯ΰ€¨ ΰ€ΰ€Ύΰ€·ΰ€Ύΰ€ΰ€ ΰ€Έΰ₯ ΰ€¦ΰ₯ΰ€ΰ₯ ΰ€ΰ€Ύΰ€¨ΰ₯ ΰ€ͺΰ€° ΰ€ͺΰ₯ΰ€¨ΰ€°ΰ₯ΰ€¨ΰ€Ώΰ€°ΰ₯ΰ€¦ΰ₯ΰ€Άΰ€Ώΰ€€ ΰ€ΰ€Ώΰ€―ΰ€Ύ ΰ€ΰ€Ύΰ€ΰ€ΰ€Ύΰ₯€
untra-polyglot-e688c05/site/complex-permalink.it.md 0000664 0000000 0000000 00000001212 15201735340 0022402 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Un permalink molto lungo
permalink: un-permalink-molto-lungo/permalink/
lang: it
page_id: complex-permalink
description: questa pagina dimostra come jekyll polyglot puΓ² creare e mantenere permalink personalizzati mantenendo la struttura del sito.
---
Questo permalink Γ¨ molto lungo e complesso.
E questa pagina Γ¨ relativizzata e coordinata con copie per ogni lingua supportata tramite `page_id`.
Se usi `jekyll-redirect-from` e un [layout redirect.html personalizzato](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html), questo permalink verrΓ reindirizzato quando visualizzato da lingue diverse.
untra-polyglot-e688c05/site/complex-permalink.ja.md 0000664 0000000 0000000 00000001430 15201735340 0022362 0 ustar 00root root 0000000 0000000 ---
layout: page
title: ιεΈΈγ«ι·γγγΌγγͺγ³γ―
permalink: a-really-long/permalink/
lang: ja
page_id: complex-permalink
description: γγγγΌγΈγ―γjekyll polyglotγγ΅γ€γζ§ι γηΆζγγͺγγγ«γΉγΏγγ€γΊγγγγγΌγγͺγ³γ―γδ½ζγ»ηΆζγγζΉζ³γη€Ίγγ¦γγΎγγ
---
γγγγΌγγͺγ³γ―γ―ιεΈΈγ«ι·γγ¦θ€ιγ§γγ
γγγ¦γγγγΌγΈγ―`page_id`γ«γγ£γ¦εγ΅γγΌγθ¨θͺγγ³γγΌγ¨ηΈε―Ύεγ»θͺΏζ΄γγγ¦γγΎγγ
`jekyll-redirect-from`γ¨γ«γΉγΏγγ€γΊγγγ[redirect.htmlγ¬γ€γ’γ¦γ](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html)γδ½Ώη¨γγγ¨γγγγγΌγγͺγ³γ―γ―η°γͺγθ¨θͺγγ葨瀺γγγγ¨γγ«γͺγγ€γ¬γ―γγγγΎγγ
untra-polyglot-e688c05/site/complex-permalink.ko.md 0000664 0000000 0000000 00000001262 15201735340 0022404 0 ustar 00root root 0000000 0000000 ---
layout: page
title: λ§€μ° κΈ΄ νΌλ§λ§ν¬
permalink: a-really-long-korean/permalink/
lang: ko
page_id: complex-permalink
description: μ΄ νμ΄μ§λ Jekyll Polyglotκ° μ¬μ΄νΈ ꡬ쑰λ₯Ό μ μ§νλ©΄μ μ¬μ©μ μ μλ μꡬ λ§ν¬λ₯Ό λ§λ€κ³ μ μ§ κ΄λ¦¬νλ λ°©λ²
---
μ΄ νΌλ§λ§ν¬λ λ§€μ° κΈΈκ³ λ³΅μ‘ν©λλ€
κ·Έλ¦¬κ³ μ΄ νμ΄μ§λ `page_id` μ μν΄ μ§μλλ μΈμ΄λ³ μΉ΄νΌμ μλνλμ΄ μ‘°μ λ©λλ€.
`jekyll-redirect-from`κ³Ό μ¬μ©μ μ μλ [redirect.html λ μ΄μμ](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html)μ μ¬μ©νλ©΄ μ΄ κ³ μ λ§ν¬κ° 리λλ μ
λ©λλ€. λ€λ₯Έ μΈμ΄λ‘ λ³Ό λ. untra-polyglot-e688c05/site/complex-permalink.nl.md 0000664 0000000 0000000 00000001235 15201735340 0022404 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Een werkelijk lange permalink
permalink: een-hele-lange/permalink/
lang: nl
page_id: complex-permalink
description: deze pagina demonstreert hoe jekyll polyglot aangepaste permanente koppelingen kan maken en onderhouden terwijl de site structuur behouden blijft.
---
Deze permalink is werkelijk lang en complex.
En deze pagina wordt gerelativeerd en gecoΓΆrdineerd met kopieΓ«n voor elke ondersteunde taal door `page_id`.
Als u `jekyll-redirect-from` en een aangepaste [redirect.html](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html) gebruikt, wordt deze permalink omgeleid wanneer bekeken vanuit verschillende talen.
untra-polyglot-e688c05/site/complex-permalink.pt-BR.md 0000664 0000000 0000000 00000001200 15201735340 0022707 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Um permalink bem longo
permalink: um-longo/permalink/
lang: pt-BR
page_id: complex-permalink
description: esta pΓ‘gina demonstra como o jekyll polyglot pode criar e manter links permanentes personalizados enquanto mantΓ©m a estrutura do site.
---
Esse permalink Γ© realmente longo e complexo.
E essa pΓ‘gina estΓ‘ relativizada e coordenada com cΓ³pias para cada idioma suportado por `page_id`.
Se vocΓͺ usar `jekyll-redirect-from` e um [layout de redirect.html](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html), esse permalink serΓ‘ redirecionado quando visualizado em diferentes idiomas.
untra-polyglot-e688c05/site/complex-permalink.ru.md 0000664 0000000 0000000 00000001755 15201735340 0022430 0 ustar 00root root 0000000 0000000 ---
layout: page
title: A really long permalink
permalink: a-really-long-russian/permalink/
lang: ru
page_id: complex-permalink
description: ΡΡΠ° ΡΡΡΠ°Π½ΠΈΡΠ° Π΄Π΅ΠΌΠΎΠ½ΡΡΡΠΈΡΡΠ΅Ρ, ΠΊΠ°ΠΊ jekyll polyglot ΠΌΠΎΠΆΠ΅Ρ ΡΠΎΠ·Π΄Π°Π²Π°ΡΡ ΠΈ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΈΠ²Π°ΡΡ Π½Π°ΡΡΡΠ°ΠΈΠ²Π°Π΅ΠΌΡΠ΅ ΠΏΠΎΡΡΠΎΡΠ½Π½ΡΠ΅ ΡΡΡΠ»ΠΊΠΈ ΠΏΡΠΈ ΡΠΎΡ
ΡΠ°Π½Π΅Π½ΠΈΠΈ ΡΡΡΡΠΊΡΡΡΡ ΡΠ°ΠΉΡΠ°.
---
ΠΠ΅ΠΉΡΡΠ²ΠΈΡΠ΅Π»ΡΠ½ΠΎ Π΄Π»ΠΈΠ½Π½Π°Ρ ΠΏΠΎΡΡΠΎΡΠ½Π½Π°Ρ ΡΡΡΠ»ΠΊΠ°.
Π ΡΡΠ° ΡΡΡΠ°Π½ΠΈΡΠ° ΡΠ΅Π»ΡΡΠΈΠ²ΠΈΠ·ΠΈΡΡΠ΅ΡΡΡ ΠΈ ΠΊΠΎΠΎΡΠ΄ΠΈΠ½ΠΈΡΡΠ΅ΡΡΡ Ρ ΠΊΠΎΠΏΠΈΡΠΌΠΈ Π΄Π»Ρ ΠΊΠ°ΠΆΠ΄ΠΎΠ³ΠΎ ΠΏΠΎΠ΄Π΄Π΅ΡΠΆΠΈΠ²Π°Π΅ΠΌΠΎΠ³ΠΎ ΡΠ·ΡΠΊΠ° Ρ ΠΏΠΎΠΌΠΎΡΡΡ `page_id`.
ΠΡΠ»ΠΈ Π²Ρ ΠΈΡΠΏΠΎΠ»ΡΠ·ΡΠ΅ΡΠ΅ `jekyll-redirect-from` ΠΈ Π½Π°ΡΡΡΠΎΠ΅Π½Π½ΡΠΉ ΠΌΠ°ΠΊΠ΅Ρ [redirect.html](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html), ΡΡΠ° ΠΏΠΎΡΡΠΎΡΠ½Π½Π°Ρ ΡΡΡΠ»ΠΊΠ° Π±ΡΠ΄Π΅Ρ ΠΏΠ΅ΡΠ΅Π½Π°ΠΏΡΠ°Π²Π»Π΅Π½Π°. ΠΏΡΠΈ ΠΏΡΠΎΡΠΌΠΎΡΡΠ΅ Ρ ΡΠ°Π·Π½ΡΡ
ΡΠ·ΡΠΊΠΎΠ². untra-polyglot-e688c05/site/complex-permalink.tr.md 0000664 0000000 0000000 00000001272 15201735340 0022421 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Γok uzun bir kalΔ±cΔ± baΔlantΔ±
permalink: cok-uzun-bir/permalink/
lang: tr
page_id: complex-permalink
description: bu sayfa jekyll polyglot'un site yapΔ±sΔ±nΔ± korurken ΓΆzelleΕtirilmiΕ kalΔ±cΔ± baΔlantΔ±larΔ± nasΔ±l oluΕturup sΓΌrdΓΌrebileceΔini gΓΆsterir.
---
Bu kalΔ±cΔ± baΔlantΔ± Γ§ok uzun ve karmaΕΔ±k.
Ve bu sayfa `page_id` ile desteklenen her dil iΓ§in kopyalarla gΓΆreceliΕtiriliyor ve koordine ediliyor.
`jekyll-redirect-from` ve ΓΆzelleΕtirilmiΕ bir [redirect.html dΓΌzeni](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html) kullanΔ±rsanΔ±z, bu kalΔ±cΔ± baΔlantΔ± farklΔ± dillerden gΓΆrΓΌntΓΌlendiΔinde yΓΆnlendirilecektir.
untra-polyglot-e688c05/site/complex-permalink.uk.md 0000664 0000000 0000000 00000001753 15201735340 0022417 0 ustar 00root root 0000000 0000000 ---
layout: page
title: ΠΡΠΆΠ΅ Π΄ΠΎΠ²Π³Π΅ ΠΏΠΎΡΠΈΠ»Π°Π½Π½Ρ
permalink: a-really-long/permalink/
lang: uk
page_id: complex-permalink
description: ΡΡ ΡΡΠΎΡΡΠ½ΠΊΠ° Π΄Π΅ΠΌΠΎΠ½ΡΡΡΡΡ, ΡΠΊ jekyll polyglot ΠΌΠΎΠΆΠ΅ ΡΡΠ²ΠΎΡΡΠ²Π°ΡΠΈ ΡΠ° ΠΏΡΠ΄ΡΡΠΈΠΌΡΠ²Π°ΡΠΈ ΠΊΠ°ΡΡΠΎΠΌΡΠ·ΠΎΠ²Π°Π½Ρ ΠΏΠΎΡΡΡΠΉΠ½Ρ ΠΏΠΎΡΠΈΠ»Π°Π½Π½Ρ, Π·Π±Π΅ΡΡΠ³Π°ΡΡΠΈ ΡΡΡΡΠΊΡΡΡΡ ΡΠ°ΠΉΡΡ.
---
Π¦Π΅ ΠΏΠΎΡΡΡΠΉΠ½Π΅ ΠΏΠΎΡΠΈΠ»Π°Π½Π½Ρ Π΄ΡΠΉΡΠ½ΠΎ Π΄ΠΎΠ²Π³Π΅ ΡΠ° ΡΠΊΠ»Π°Π΄Π½Π΅.
Π ΡΡ ΡΡΠΎΡΡΠ½ΠΊΠ° ΡΠ΅Π»ΡΡΠΈΠ²ΡΠ·ΠΎΠ²Π°Π½Π° ΡΠ° ΠΊΠΎΠΎΡΠ΄ΠΈΠ½ΡΡΡΡΡΡ Π· ΠΊΠΎΠΏΡΡΠΌΠΈ Π΄Π»Ρ ΠΊΠΎΠΆΠ½ΠΎΡ ΠΏΡΠ΄ΡΡΠΈΠΌΡΠ²Π°Π½ΠΎΡ ΠΌΠΎΠ²ΠΈ Π·Π° Π΄ΠΎΠΏΠΎΠΌΠΎΠ³ΠΎΡ `page_id`.
Π―ΠΊΡΠΎ Π²ΠΈ Π²ΠΈΠΊΠΎΡΠΈΡΡΠΎΠ²ΡΡΡΠ΅ `jekyll-redirect-from` ΡΠ° ΠΊΠ°ΡΡΠΎΠΌΡΠ·ΠΎΠ²Π°Π½ΠΈΠΉ [layout redirect.html](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html), ΡΠ΅ ΠΏΠΎΡΡΡΠΉΠ½Π΅ ΠΏΠΎΡΠΈΠ»Π°Π½Π½Ρ Π±ΡΠ΄Π΅ ΠΏΠ΅ΡΠ΅Π½Π°ΠΏΡΠ°Π²Π»Π΅Π½ΠΎ ΠΏΡΠΈ ΠΏΠ΅ΡΠ΅Π³Π»ΡΠ΄Ρ Π· ΡΡΠ·Π½ΠΈΡ
ΠΌΠΎΠ².
untra-polyglot-e688c05/site/complex-permalink.zh-CN.md 0000664 0000000 0000000 00000001227 15201735340 0022713 0 ustar 00root root 0000000 0000000 ---
layout: page
title: δΈζ‘θΆ
ιΏηζ°ΈδΉ
ιΎζ₯
permalink: yi-tiao-chao-chang-de-yong-jiu-lian-jie/permalink/
lang: zh-CN
page_id: complex-permalink
description: ζ¬ι‘΅ι’ζΌη€ΊδΊε¦δ½δ½Ώη¨ Jekyll Polyglot εε»Ίεη»΄ζ€θͺεδΉηζ°ΈδΉ
ιΎζ₯οΌεζΆδΏηη«ηΉη»ζγ
---
θΏδΈͺζ°ΈδΉ
ιΎζ₯ηηθΆ
ιΏθΆ
ε€ζ
θ―₯ι‘΅ι’ιθΏ `page_id` εη°δΊηΈε―Ήεηζ URL εεθ°οΌδ»₯δΎΏδΈΊζ―η§ζ―ζηθ―θ¨ζδΎε―ζ¬γ
ε¦ζζ¨δ½Ώη¨ `jekyll-redirect-from` εΉΆδΈθͺεδΉδΊ [redirect.html εΈε±](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html)οΌθΏδΈͺζ°ΈδΉ
ιΎζ₯ε°ε¨δΈεθ―θ¨δΈζ₯ηζΆθ’«ιεεγ
untra-polyglot-e688c05/site/index.html 0000664 0000000 0000000 00000001707 15201735340 0020024 0 ustar 00root root 0000000 0000000 ---
layout: default
title: Home
---
{% for post in paginator.posts %}
{{ post.date | date_to_string }}
{{ post.content }}
{% endfor %}
`,
* or to a parent if there are multiple elements to show.
*/
.message {
margin-bottom: 1rem;
padding: 1rem;
color: #717171;
background-color: #f9f9f9;
}
/*
* Container
*
* Center the page content.
*/
.container {
max-width: 42rem;
padding-left: 1rem;
padding-right: 1rem;
margin-left: auto;
margin-right: auto;
}
/*
* Masthead
*
* Super small header above the content for site name and short description.
*/
.masthead {
padding-top: 1rem;
padding-bottom: 1rem;
margin-bottom: 3rem;
}
.masthead-title {
margin-top: 0;
margin-bottom: 0;
color: #505050;
}
.masthead-title a {
color: #505050;
}
.masthead-title small {
font-size: 75%;
font-weight: 400;
color: #c0c0c0;
letter-spacing: 0;
}
/*
* Posts and pages
*
* Each post is wrapped in `.post` and is used on default and post layouts. Each
* page is wrapped in `.page` and is only used on the page layout.
*/
.page,
.post {
margin-bottom: 4em;
}
/* Blog post or page title */
.page-title,
.post-title,
.post-title a {
color: #303030;
}
.page-title,
.post-title {
margin-top: 0;
}
/* Meta data line below post title */
.post-date {
display: block;
margin-top: -.5rem;
margin-bottom: 1rem;
color: #9a9a9a;
}
/* Related posts */
.related {
padding-top: 2rem;
padding-bottom: 2rem;
border-top: 1px solid #eee;
}
.related-posts {
padding-left: 0;
list-style: none;
}
.related-posts h3 {
margin-top: 0;
}
.related-posts li small {
font-size: 75%;
color: #999;
}
.related-posts li a:hover {
color: #268bd2;
text-decoration: none;
}
.related-posts li a:hover small {
color: inherit;
}
/*
* Pagination
*
* Super lightweight (HTML-wise) blog pagination. `span`s are provide for when
* there are no more previous or next posts to show.
*/
.pagination {
overflow: hidden; /* clearfix */
margin-left: -1rem;
margin-right: -1rem;
font-family: "PT Sans", Helvetica, Arial, sans-serif;
color: #ccc;
text-align: center;
}
/* Pagination items can be `span`s or `a`s */
.pagination-item {
display: block;
padding: 1rem;
border: 1px solid #eee;
}
.pagination-item:first-child {
margin-bottom: -1px;
}
/* Only provide a hover state for linked pagination items */
a.pagination-item:hover {
background-color: #f5f5f5;
}
@media (min-width: 30em) {
.pagination {
margin: 3rem 0;
}
.pagination-item {
float: left;
width: 50%;
}
.pagination-item:first-child {
margin-bottom: 0;
border-top-left-radius: 4px;
border-bottom-left-radius: 4px;
}
.pagination-item:last-child {
margin-left: -1px;
border-top-right-radius: 4px;
border-bottom-right-radius: 4px;
}
}
untra-polyglot-e688c05/site/public/css/syntax.css 0000664 0000000 0000000 00000006627 15201735340 0022143 0 ustar 00root root 0000000 0000000 .highlight .hll { background-color: #ffc; }
.highlight .c { color: #999; } /* Comment */
.highlight .err { color: #a00; background-color: #faa } /* Error */
.highlight .k { color: #069; } /* Keyword */
.highlight .o { color: #555 } /* Operator */
.highlight .cm { color: #09f; font-style: italic } /* Comment.Multiline */
.highlight .cp { color: #099 } /* Comment.Preproc */
.highlight .c1 { color: #999; } /* Comment.Single */
.highlight .cs { color: #999; } /* Comment.Special */
.highlight .gd { background-color: #fcc; border: 1px solid #c00 } /* Generic.Deleted */
.highlight .ge { font-style: italic } /* Generic.Emph */
.highlight .gr { color: #f00 } /* Generic.Error */
.highlight .gh { color: #030; } /* Generic.Heading */
.highlight .gi { background-color: #cfc; border: 1px solid #0c0 } /* Generic.Inserted */
.highlight .go { color: #aaa } /* Generic.Output */
.highlight .gp { color: #009; } /* Generic.Prompt */
.highlight .gs { } /* Generic.Strong */
.highlight .gu { color: #030; } /* Generic.Subheading */
.highlight .gt { color: #9c6 } /* Generic.Traceback */
.highlight .kc { color: #069; } /* Keyword.Constant */
.highlight .kd { color: #069; } /* Keyword.Declaration */
.highlight .kn { color: #069; } /* Keyword.Namespace */
.highlight .kp { color: #069 } /* Keyword.Pseudo */
.highlight .kr { color: #069; } /* Keyword.Reserved */
.highlight .kt { color: #078; } /* Keyword.Type */
.highlight .m { color: #f60 } /* Literal.Number */
.highlight .s { color: #d44950 } /* Literal.String */
.highlight .na { color: #4f9fcf } /* Name.Attribute */
.highlight .nb { color: #366 } /* Name.Builtin */
.highlight .nc { color: #0a8; } /* Name.Class */
.highlight .no { color: #360 } /* Name.Constant */
.highlight .nd { color: #99f } /* Name.Decorator */
.highlight .ni { color: #999; } /* Name.Entity */
.highlight .ne { color: #c00; } /* Name.Exception */
.highlight .nf { color: #c0f } /* Name.Function */
.highlight .nl { color: #99f } /* Name.Label */
.highlight .nn { color: #0cf; } /* Name.Namespace */
.highlight .nt { color: #2f6f9f; } /* Name.Tag */
.highlight .nv { color: #033 } /* Name.Variable */
.highlight .ow { color: #000; } /* Operator.Word */
.highlight .w { color: #bbb } /* Text.Whitespace */
.highlight .mf { color: #f60 } /* Literal.Number.Float */
.highlight .mh { color: #f60 } /* Literal.Number.Hex */
.highlight .mi { color: #f60 } /* Literal.Number.Integer */
.highlight .mo { color: #f60 } /* Literal.Number.Oct */
.highlight .sb { color: #c30 } /* Literal.String.Backtick */
.highlight .sc { color: #c30 } /* Literal.String.Char */
.highlight .sd { color: #c30; font-style: italic } /* Literal.String.Doc */
.highlight .s2 { color: #c30 } /* Literal.String.Double */
.highlight .se { color: #c30; } /* Literal.String.Escape */
.highlight .sh { color: #c30 } /* Literal.String.Heredoc */
.highlight .si { color: #a00 } /* Literal.String.Interpol */
.highlight .sx { color: #c30 } /* Literal.String.Other */
.highlight .sr { color: #3aa } /* Literal.String.Regex */
.highlight .s1 { color: #c30 } /* Literal.String.Single */
.highlight .ss { color: #fc3 } /* Literal.String.Symbol */
.highlight .bp { color: #366 } /* Name.Builtin.Pseudo */
.highlight .vc { color: #033 } /* Name.Variable.Class */
.highlight .vg { color: #033 } /* Name.Variable.Global */
.highlight .vi { color: #033 } /* Name.Variable.Instance */
.highlight .il { color: #f60 } /* Literal.Number.Integer.Long */
.css .o,
.css .o + .nt,
.css .nt + .nt { color: #999; }
untra-polyglot-e688c05/site/public/favicon.ico 0000664 0000000 0000000 00000000473 15201735340 0021425 0 ustar 00root root 0000000 0000000 PNG
IHDR όν£ pHYs H H FΙk> vpAg ϊ ͺIDATHΗcTRTd %`’©ι£
X0
fΝαμζ)~pίή€T©'{x{c*8zθP\Bω>`d$ |pχή=d²©
Hφy`Τ` κΠετΑ6`>΅`dZ°hΑΜ$xχή½Υ+WBΨ³fΜΐͺ`ΓΊuDYπώύ{¬nyρό9ρύϋw¬
?z)Θ8Ϊ²΅b μ69» "zTXtSoftware xΪsLΙOJUπΜMLO
JML© /Τ ©M IENDB` untra-polyglot-e688c05/site/robots.txt 0000664 0000000 0000000 00000000111 15201735340 0020064 0 ustar 00root root 0000000 0000000 ---
layout: content
---
User-agent: *
Sitemap: {{ site.url }}/sitemap.xml untra-polyglot-e688c05/site/sample.md 0000664 0000000 0000000 00000000357 15201735340 0017632 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Sample rich text data
permalink: sample/
---
{{ site.data["sample"][1] }}
`, `<meta>` tags for SEO. Polyglot's `{% raw %}{% I18n_Headers %}{% endraw %}` is designed to live alongside it: let jekyll-seo-tag handle everything except the canonical URL, and let polyglot handle the canonical and hreflang alternates (which it can do correctly across languages):
{% highlight liquid %}
{% raw %}
{% seo canonical=false %}
{% I18n_Headers %}
{% endraw %}
{% endhighlight %}
The `canonical=false` option requires jekyll-seo-tag v2.9.0 or later.
### Fallback canonical for untranslated pages
By default, a page that has no translation in the active language still gets a canonical pointing at its translated URL. For better SEO, you can have fallback pages point their canonical URL at the default language version instead. Add to your `_config.yml`:
{% highlight yaml %}
fallback_canonical_to_default_lang: true
{% endhighlight %}
With this enabled:
- Pages with a real translation: canonical points to the translated URL (e.g. `/es/sobre-nosotros/`).
- Fallback pages (no translation): canonical points to the default language URL (e.g. `/about/` instead of `/es/about/`).
This consolidates SEO authority on the original content and prevents search engines from indexing duplicate fallback pages across languages.
## Using polyglot with jekyll-redirect-from
The [jekyll-redirect-from](https://github.com/jekyll/jekyll-redirect-from) plugin lets pages declare old URLs they should redirect from. Polyglot integrates with it in two ways:
**Automatic cross-language redirects via `page_id`.** When two pages share a `page_id` but have different permalinks, polyglot will automatically add the other-language permalinks to the page's `redirect_from`. No manual configuration needed β just make sure both pages have the same `page_id` in their front matter.
**Language-scoped `redirect_from`.** When a page in a non-default language declares its own `redirect_from`, polyglot automatically prefixes the paths with the page's language code, so `/old-path` becomes `/fr/old-path` on a French page. Paths that already start with the language code are left alone.
Include a customized [redirect.html layout](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html) with the site.
## Localizing Netlify _redirects
_New in 1.13.0._
When you deploy to [Netlify](https://www.netlify.com/) with a [`_redirects` file](https://docs.netlify.com/manage/routing/redirects/overview/#syntax-for-the-_redirects-file), Polyglot can automatically generate language-prefixed copies of each rule so they work on all of your localized URLs.
Enable it in `_config.yml`:
{% highlight yaml %}
localize_redirects: true
exclude_from_redirect_localization:
- /signin
- /app
{% endhighlight %}
With this, a single rule like:
{% highlight text %}
/github https://github.com/org/repo 302
{% endhighlight %}
is expanded into language-prefixed copies for each configured language:
{% highlight text %}
/github https://github.com/org/repo 302
/fr/github https://github.com/org/repo 302
/de/github https://github.com/org/repo 302
/sv/github https://github.com/org/repo 302
{% endhighlight %}
External destination URLs are preserved as-is. Paths listed under `exclude_from_redirect_localization` are not localized, which is useful for authentication endpoints or single-page-app routes that should only exist at the root. untra-polyglot-e688c05/site/seo.pt-BR.md 0000664 0000000 0000000 00000015001 15201735340 0020052 0 ustar 00root root 0000000 0000000 ---
layout: page
title: Receitas de SEO
permalink: seo/
lang: pt-BR
description: These additions can help improve the SEO of your multi-language jekyll blog when using Polyglot.
---
# Receitas para Otimização de Mecanismos de Busca usando Polyglot
Se vocΓͺ instalou a gema `jekyll-polyglot`, essas adiçáes ao cabeΓ§alho do seu site podem facilmente fornecer ao seu blog jekyll bΓ΄nus de SEO fornecidos pelo Google.
## Declaração de Idioma HTML
De acordo com o [WHATWG HTML Living Standard](https://html.spec.whatwg.org/multipage/dom.html#the-lang-and-xml:lang-attributes), vocΓͺ deve declarar o idioma da pΓ‘gina usando o atributo `lang` no elemento HTML raiz. Adicione isso ao seu layout:
{% highlight html %}{% raw %}
<html lang="{{ site.active_lang }}">
{% endraw %}
{% endhighlight %}
Isso permite que navegadores, mecanismos de busca e tecnologias assistivas (leitores de tela, ferramentas de tradução) processem seu conteúdo corretamente.
## Multi-language SEO usando hreflang alternate tags
VocΓͺ pode facilmente adicionar [tags alternadas](https://developers.google.com/search/docs/specialty/international/localized-versions?hl=pt-BR) `hreflang="{{site.active_lang}}"` ao seu site, obtendo SEO com pesquisas multilΓngues do Google. Quando o navegador usa um idioma nΓ£o suportado, o site retorna para a versΓ£o padrΓ£o com `hreflang="x-default"`.
Certifique-se de incluir [tags canΓ΄nicas](https://developers.google.com/search/docs/specialty/international/managing-multi-regional-sites?hl=pt-BR) ao identificar conteΓΊdo em pΓ‘ginas semelhantes do mesmo idioma.
{% highlight html %}
{% raw %}
{% if page.lang == site.default_lang %}
<link rel="canonical"
href="http://yoursite.com{{page.permalink}}" />
{% else %}
<link rel="canonical"
href="http://yoursite.com/{{page.lang}}{{page.permalink}}" />
{% endif %}
<link rel="alternate"
hreflang="{{site.default_lang}}"
href="http://yoursite.com{{page.permalink}}" />
<link rel="alternate"
hreflang="x-default"
href="http://yoursite.com{{page.permalink}}" />
{% for lang in site.languages %}
{% if lang == site.default_lang %}
{% continue %}
{% endif %}
<link rel="alternate"
hreflang="{{lang}}"
href="http://yoursite.com/{{lang}}{{page.permalink}}" />
{% endfor %}
{% endraw %}
{% endhighlight %}
## Todas as anteriores (hreflang e canonical)
VocΓͺ pode obter o link canonical, links alternate hreflang e fallback x-default com uma ΓΊnica tag adicionada ao seu `head.html`:
{% highlight html %}
{% raw %}
{% I18n_Headers %}
{% endraw %}
{% endhighlight %}
Nota: VocΓͺ ainda deve adicionar `<html lang="{{ site.active_lang }}">` ao elemento raiz do seu layout separadamente, conforme descrito acima.
Com esse SEO, cada clique em uma pΓ‘gina de um idioma do site contarΓ‘ para o total de cliques de todos os idiomas do site.
## Usando polyglot com jekyll-seo-tag
[jekyll-seo-tag](https://github.com/jekyll/jekyll-seo-tag) Γ© outro plugin do Jekyll que emite tags `<title>` e `<meta>` para SEO. O `{% raw %}{% I18n_Headers %}{% endraw %}` do Polyglot foi projetado para conviver com ele: deixe o jekyll-seo-tag cuidar de tudo, exceto da URL canΓ΄nica, e deixe o polyglot cuidar do canonical e dos hreflang alternates (algo que ele consegue fazer corretamente entre idiomas):
{% highlight liquid %}
{% raw %}
{% seo canonical=false %}
{% I18n_Headers %}
{% endraw %}
{% endhighlight %}
A opção `canonical=false` requer jekyll-seo-tag v2.9.0 ou posterior.
### Canonical de fallback para pΓ‘ginas nΓ£o traduzidas
Por padrΓ£o, uma pΓ‘gina que nΓ£o possui tradução no idioma ativo ainda recebe um canonical apontando para sua URL traduzida. Para melhorar o SEO, vocΓͺ pode fazer com que as pΓ‘ginas de fallback apontem sua URL canΓ΄nica para a versΓ£o no idioma padrΓ£o. Adicione ao seu `_config.yml`:
{% highlight yaml %}
fallback_canonical_to_default_lang: true
{% endhighlight %}
Com isso habilitado:
- PÑginas com tradução real: o canonical aponta para a URL traduzida (por exemplo, `/es/sobre-nosotros/`).
- PÑginas de fallback (sem tradução): o canonical aponta para a URL no idioma padrão (por exemplo, `/about/` em vez de `/es/about/`).
Isso consolida a autoridade de SEO no conteΓΊdo original e evita que mecanismos de busca indexem pΓ‘ginas de fallback duplicadas entre idiomas.
## Usando polyglot com jekyll-redirect-from
O plugin [jekyll-redirect-from](https://github.com/jekyll/jekyll-redirect-from) permite que pΓ‘ginas declarem URLs antigas das quais devem ser redirecionadas. O polyglot integra-se a ele de duas formas:
**Redirecionamentos automΓ‘ticos entre idiomas via `page_id`.** Quando duas pΓ‘ginas compartilham um `page_id` mas possuem permalinks diferentes, o polyglot adicionarΓ‘ automaticamente os permalinks dos outros idiomas ao `redirect_from` da pΓ‘gina. Nenhuma configuração manual Γ© necessΓ‘ria β apenas garanta que ambas as pΓ‘ginas tenham o mesmo `page_id` no front matter.
**`redirect_from` com escopo de idioma.** Quando uma pΓ‘gina em um idioma nΓ£o padrΓ£o declara seu prΓ³prio `redirect_from`, o polyglot automaticamente prefixa os caminhos com o cΓ³digo de idioma da pΓ‘gina, de modo que `/old-path` se torna `/fr/old-path` em uma pΓ‘gina em francΓͺs. Caminhos que jΓ‘ comeΓ§am com o cΓ³digo de idioma sΓ£o mantidos como estΓ£o.
Inclua um [layout redirect.html personalizado](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html) no seu site.
## Localizando os _redirects do Netlify
_Novo na versΓ£o 1.13.0._
Quando vocΓͺ faz deploy no [Netlify](https://www.netlify.com/) com um [arquivo `_redirects`](https://docs.netlify.com/manage/routing/redirects/overview/#syntax-for-the-_redirects-file), o Polyglot pode gerar automaticamente cΓ³pias prefixadas por idioma de cada regra, para que elas funcionem em todas as suas URLs localizadas.
Habilite no `_config.yml`:
{% highlight yaml %}
localize_redirects: true
exclude_from_redirect_localization:
- /signin
- /app
{% endhighlight %}
Com isso, uma ΓΊnica regra como:
{% highlight text %}
/github https://github.com/org/repo 302
{% endhighlight %}
Γ© expandida em cΓ³pias prefixadas por idioma para cada idioma configurado:
{% highlight text %}
/github https://github.com/org/repo 302
/fr/github https://github.com/org/repo 302
/de/github https://github.com/org/repo 302
/sv/github https://github.com/org/repo 302
{% endhighlight %}
URLs de destino externas são preservadas como estão. Caminhos listados em `exclude_from_redirect_localization` não são localizados, o que é útil para endpoints de autenticação ou rotas de single-page-app que devem existir apenas na raiz. untra-polyglot-e688c05/site/seo.zh-CN.md 0000664 0000000 0000000 00000014172 15201735340 0020055 0 ustar 00root root 0000000 0000000 ---
layout: page
title: SEO ζΉζ‘
permalink: seo/
lang: zh-CN
description: θΏδΊθ‘₯ε
ε―δ»₯εΈε©ζι«δ½Ώη¨ Polyglot ζΆε€θ―θ¨ Jekyll εε’η SEOγ
---
# δ½Ώη¨ Polyglot ηζη΄’εΌζδΌεοΌSEOοΌζΉζ‘
ε¦ζδ½ ε·²η»εθ£
δΊ `jekyll-polyglot` ε
οΌζθΏδΊε
εΉε ε
₯ε°δ½ ηη½η«η `head` ζ ηΎδΈοΌε―δ»₯θ©δ½ η Jekyll θ½»ζΎε°θ·εζ΄ε€ηι’ε Google η SEO ε ζγ
## HTML θ―θ¨ε£°ζ
ζ Ήζ [WHATWG HTML θ§θ](https://html.spec.whatwg.org/multipage/dom.html#the-lang-and-xml:lang-attributes)οΌδ½ εΊθ―₯ε¨ζ Ή HTML ε
η΄ δΈδ½Ώη¨ `lang` ε±ζ§ζ₯ε£°ζι‘΅ι’θ―θ¨γε¨δ½ ηεΈε±δΈζ·»ε ε¦δΈε
εΉοΌ
{% highlight html %}{% raw %}
<html lang="{{ site.active_lang }}">
{% endraw %}
{% endhighlight %}
θΏδ½Ώζ΅θ§ε¨γζη΄’εΌζεθΎ
ε©ζζ―οΌε±εΉι
θ―»ε¨γηΏ»θ―ε·₯ε
·οΌθ½ε€ζ£η‘ε€ηδ½ ηε
εΉγ
## δ½Ώη¨ hreflang ζΏδ»£ζ ηΎεη°ε€θ―θ¨ SEO
δ½ ε―δ»₯θ½»ζΎε°δΈΊδ½ ηη½η«ζ·»ε `hreflang="{{site.active_lang}}"` [alternate ζ ηΎ](https://developers.google.com/search/docs/specialty/international/localized-versions?hl=zh-CN)οΌδ»₯εη° Google ε€θ―θ¨ζη΄’η SEOγε½ζ΅θ§ε¨δ½Ώη¨δΊδΈεΉι
ηθ―θ¨ζΆοΌε―δ»₯ιθΏ `hreflang="x-default"` ειε°η«ηΉηι»θ€θ―θ¨ηζ¬γ
ε¨δΈΊεδΈθ―θ¨ηηΈδΌΌι‘΅ι’ζ θ―ε
εΉζΆοΌθ―·ε‘εΏ
ε
ε« [canonical ζ ηΎ](https://developers.google.com/search/docs/specialty/international/managing-multi-regional-sites?hl=zh-CN)γ
{% highlight html %}
{% raw %}
{% if page.lang == site.default_lang %}
<link rel="canonical"
href="http://yoursite.com{{page.permalink}}" />
{% else %}
<link rel="canonical"
href="http://yoursite.com/{{page.lang}}{{page.permalink}}" />
{% endif %}
<link rel="alternate"
hreflang="{{site.default_lang}}"
href="http://yoursite.com{{page.permalink}}" />
<link rel="alternate"
hreflang="x-default"
href="http://yoursite.com{{page.permalink}}" />
{% for lang in site.languages %}
{% if lang == site.default_lang %}
{% continue %}
{% endif %}
<link rel="alternate"
hreflang="{{lang}}"
href="http://yoursite.com/{{lang}}{{page.permalink}}" />
{% endfor %}
{% endraw %}
{% endhighlight %}
## δΈζ₯ε°δ½οΌhreflang ε canonicalοΌ
δ½ ε―δ»₯ιθΏζε¦δΈηζ ηΎη΄ζ₯ζ·»ε ε°δ½ η `head.html` ζδ»ΆδΈοΌδ»₯θ·ε canonical ιΎζ₯γalternate hreflang ιΎζ₯ε x-default ειοΌ
{% highlight html %}
{% raw %}
{% I18n_Headers %}
{% endraw %}
{% endhighlight %}
注ζοΌδ½ δ»ηΆιθ¦ζη
§δΈθΏ°θ―΄ζοΌε¨εΈε±ηζ Ήε
η΄ δΈεη¬ζ·»ε `<html lang="{{ site.active_lang }}">`γ
θ₯ιη¨ε¦δΈη SEO ηη₯οΌζ―欑对η«ηΉδΈεεθ―θ¨ε
εΉηηΉε»οΌι½δΌθ‘ε
₯ε°η«ηΉηεηΉε»δΈγ
## ε¨ polyglot δΈδ½Ώη¨ jekyll-seo-tag
[jekyll-seo-tag](https://github.com/jekyll/jekyll-seo-tag) ζ―ε¦δΈδΈͺη¨δΊ SEO η Jekyll ζδ»ΆοΌεδΌθΎεΊ `<title>` ε `<meta>` ζ ηΎγPolyglot η `{% raw %}{% I18n_Headers %}{% endraw %}` ε¨θΎθ‘δΈε―δ»₯δΈεε
±εοΌθ© jekyll-seo-tag ε€η canonical URL δΉε€ηζζε
εΉοΌη± polyglot ζ₯ε€η canonical ε hreflang alternate ιΎζ₯οΌpolyglot θ½ζ£η‘ε°θ·¨θ―θ¨ηζε们οΌοΌ
{% highlight liquid %}
{% raw %}
{% seo canonical=false %}
{% I18n_Headers %}
{% endraw %}
{% endhighlight %}
`canonical=false` ιι‘Ήιθ¦ jekyll-seo-tag v2.9.0 ζζ΄ι«ηζ¬γ
### ζͺηΏ»θ―ι‘΅ι’ηει canonical
ι»θ€ζ
ε΅δΈοΌθ₯ζδΈͺι‘΅ι’ε¨ε½εζ΄»ε¨θ―θ¨δΈζ²‘ζηΏ»θ―οΌε
Ά canonical δ»δΌζεεε¨θ―₯θ―θ¨δΈη URLγδΈΊδΊθ·εΎζ΄ε₯½η SEOοΌδ½ ε―δ»₯θ©ειι‘΅ι’η canonical URL ζει»θ€θ―θ¨ηζ¬γε¨ `_config.yml` δΈζ·»ε οΌ
{% highlight yaml %}
fallback_canonical_to_default_lang: true
{% endhighlight %}
ε―η¨εοΌ
- ζηεηΏ»θ―ηι‘΅ι’οΌcanonical ζεηΏ»θ―εη URLοΌδΎε¦ `/es/sobre-nosotros/`οΌγ
- ειι‘΅ι’οΌζ²‘ζηΏ»θ―οΌοΌcanonical ζει»θ€θ―θ¨η URLοΌδΎε¦ `/about/` θι `/es/about/`οΌγ
θΏθ½ε° SEO ζιιδΈε°εε§ε
εΉδΈοΌεΉΆιΏε
ζη΄’εΌζδΈΊεθ―θ¨ι΄ιε€ηειι‘΅ι’ε»Ίη«η΄’εΌγ
## ε¨ polyglot δΈδ½Ώη¨ jekyll-redirect-from
[jekyll-redirect-from](https://github.com/jekyll/jekyll-redirect-from) ζδ»Άε
θΈι‘΅ι’ε£°ζε们εΊθ―₯δ»εͺδΊζ§ URL ιεεθΏζ₯γPolyglot δ»₯δΈ€η§ζΉεΌδΈειζοΌ
**ιθΏ `page_id` εη°θ·¨θ―θ¨θͺε¨ιεεγ** ε½δΈ€δΈͺι‘΅ι’ζ₯ζηΈεη `page_id` δ½ε
·ζδΈεη permalink ζΆοΌpolyglot δΌθͺε¨ε°ε
Άδ»θ―θ¨ηζ¬η permalink ζ·»ε ε°θ―₯ι‘΅ι’η `redirect_from` δΈγζ ιδ»»δ½ζε¨ι
η½ββεͺθ¦η‘δΏδΈ€δΈͺι‘΅ι’ε¨ front matter δΈζ₯ζηΈεη `page_id` ε³ε―γ
**ζθ―θ¨δ½η¨εη `redirect_from`γ** ε½δΈδΈͺιι»θ€θ―θ¨ηι‘΅ι’ε£°ζδΊθͺε·±η `redirect_from` ζΆοΌpolyglot δΌθͺε¨δΈΊθΏδΊθ·―εΎε δΈθ―₯ι‘΅ι’ηθ―θ¨δ»£η εηΌοΌδΎε¦ε¨ζ³θ―ι‘΅ι’δΈ `/old-path` δΌεδΈΊ `/fr/old-path`γε·²η»δ»₯θ―θ¨δ»£η εΌε€΄ηθ·―εΎδΌδΏζδΈεγ
θ―·ε¨δ½ ηη«ηΉδΈε
ε«δΈδΈͺθͺεδΉη [redirect.html εΈε±](https://github.com/untra/polyglot/blob/main/site/_layouts/redirect.html)γ
## ζ¬ε°ε Netlify _redirects
_θͺ 1.13.0 θ΅·ζ°ε’γ_
ε½δ½ ι¨η½²ε° [Netlify](https://www.netlify.com/) εΉΆδ½Ώη¨ [`_redirects` ζδ»Ά](https://docs.netlify.com/manage/routing/redirects/overview/#syntax-for-the-_redirects-file) ζΆοΌPolyglot ε―δ»₯θͺε¨δΈΊζ―ζ‘θ§εηζεΈ¦θ―θ¨εηΌηε―ζ¬οΌδ½Ώε们ε¨δ½ ζζζ¬ε°εη URL δΈι½θ½ηζγ
ε¨ `_config.yml` δΈε―η¨οΌ
{% highlight yaml %}
localize_redirects: true
exclude_from_redirect_localization:
- /signin
- /app
{% endhighlight %}
ε―η¨εοΌεθΏζ ·δΈζ‘θ§εοΌ
{% highlight text %}
/github https://github.com/org/repo 302
{% endhighlight %}
δΌιε―Ήζ―η§ε·²ι
η½ηθ―θ¨ζ©ε±δΈΊεΈ¦θ―θ¨εηΌηε―ζ¬οΌ
{% highlight text %}
/github https://github.com/org/repo 302
/fr/github https://github.com/org/repo 302
/de/github https://github.com/org/repo 302
/sv/github https://github.com/org/repo 302
{% endhighlight %}
ε€ι¨ηζ URL δΌεζ ·δΏηγεε¨ `exclude_from_redirect_localization` δΈηθ·―εΎδΈδΌθ’«ζ¬ε°εοΌθΏε―ΉδΊεͺεΊε¨ζ Ήθ·―εΎδΈεε¨ηθ€θ―η«―ηΉζει‘΅εΊη¨θ·―η±ιεΈΈζη¨γ untra-polyglot-e688c05/site/sitemap.xml 0000664 0000000 0000000 00000007247 15201735340 0020220 0 ustar 00root root 0000000 0000000 ---
layout: content
---
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml">
{% for lang in site.languages %}
{% for node in site.pages %}
{% comment %}<!-- very lazy check to see if page is in the exclude list - this means excluded pages are not gonna be in the sitemap at all, write exceptions as necessary -->{% endcomment %}
{% unless site.exclude_from_localization contains node.path %}
{% comment %}<!-- assuming if there's not layout assigned, then not include the page in the sitemap, you may want to change this -->{% endcomment %}
{% if node.layout %}
<url>
<loc>{% if lang == site.default_lang %}{{ node.url | absolute_url }}{% else %}{{ node.url | prepend: lang | prepend: '/' | absolute_url }}{% endif %}</loc>
{% if node.last_modified_at and node.last_modified_at != node.date %}<lastmod>{{ node.last_modified_at | date: '%Y-%m-%dT%H:%M:%S%:z' }}</lastmod>{% elsif node.date %}<lastmod>{{ node.date | date: '%Y-%m-%dT%H:%M:%S%:z' }}</lastmod>{% endif %}
{% comment %}<!-- hreflang links for cross-language SEO -->{% endcomment %}
{% if node.permalink_lang %}
{% for alt_lang in site.languages %}
{% if node.permalink_lang[alt_lang] %}
<xhtml:link rel="alternate" hreflang="{{ alt_lang }}" href="{% if alt_lang == site.default_lang %}{{ node.permalink_lang[alt_lang] | absolute_url }}{% else %}{{ node.permalink_lang[alt_lang] | prepend: alt_lang | prepend: '/' | absolute_url }}{% endif %}"/>
{% endif %}
{% endfor %}
<xhtml:link rel="alternate" hreflang="x-default" href="{{ node.permalink_lang[site.default_lang] | absolute_url }}"/>
{% else %}
{% for alt_lang in site.languages %}
<xhtml:link rel="alternate" hreflang="{{ alt_lang }}" href="{% if alt_lang == site.default_lang %}{{ node.url | absolute_url }}{% else %}{{ node.url | prepend: alt_lang | prepend: '/' | absolute_url }}{% endif %}"/>
{% endfor %}
<xhtml:link rel="alternate" hreflang="x-default" href="{{ node.url | absolute_url }}"/>
{% endif %}
</url>
{% endif %}
{% endunless %}
{% endfor %}
{% comment %}<!-- This loops through all site collections including posts -->{% endcomment %}
{% for collection in site.collections %}
{% for node in site[collection.label] %}
<url>
<loc>{% if lang == site.default_lang %}{{ node.url | absolute_url }}{% else %}{{ node.url | prepend: lang | prepend: '/' | absolute_url }}{% endif %}</loc>
{% if node.last_modified_at and node.last_modified_at != node.date %}<lastmod>{{ node.last_modified_at | date: '%Y-%m-%dT%H:%M:%S%:z' }}</lastmod>{% elsif node.date %}<lastmod>{{ node.date | date: '%Y-%m-%dT%H:%M:%S%:z' }}</lastmod>{% endif %}
{% comment %}<!-- hreflang links for cross-language SEO -->{% endcomment %}
{% for alt_lang in site.languages %}
<xhtml:link rel="alternate" hreflang="{{ alt_lang }}" href="{% if alt_lang == site.default_lang %}{{ node.url | absolute_url }}{% else %}{{ node.url | prepend: alt_lang | prepend: '/' | absolute_url }}{% endif %}"/>
{% endfor %}
<xhtml:link rel="alternate" hreflang="x-default" href="{{ node.url | absolute_url }}"/>
</url>
{% endfor %}
{% endfor %}
{% endfor %}
</urlset> untra-polyglot-e688c05/spec/ 0000775 0000000 0000000 00000000000 15201735340 0016010 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/spec/fixture/ 0000775 0000000 0000000 00000000000 15201735340 0017476 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/spec/fixture/_.config.yml 0000664 0000000 0000000 00000000422 15201735340 0021701 0 ustar 00root root 0000000 0000000 # Where things are
source: .
destination: ./_site
include: ['pages']
collections:
pages:
output: true
posts:
output: true
#Polyglot
languages: ["en", "es", "fr"]
default_lang: "en"
exclude_from_localization: ["javascript", "images", "css", "public"]
untra-polyglot-e688c05/spec/fixture/_layouts/ 0000775 0000000 0000000 00000000000 15201735340 0021335 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/spec/fixture/_layouts/content.html 0000664 0000000 0000000 00000000016 15201735340 0023672 0 ustar 00root root 0000000 0000000 {{ content }}
untra-polyglot-e688c05/spec/fixture/_layouts/post.html 0000664 0000000 0000000 00000000214 15201735340 0023205 0 ustar 00root root 0000000 0000000 ---
---
<!DOCTYPE html>
<html lang="{{ page.lang }}">
<head>
<title>{{ page.title }}
{{ content }}
untra-polyglot-e688c05/spec/fixture/_posts/ 0000775 0000000 0000000 00000000000 15201735340 0021005 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/spec/fixture/_posts/2020-01-01-test-post.md 0000664 0000000 0000000 00000000125 15201735340 0024304 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Test Post
lang: en
---
Test content for the English version.
untra-polyglot-e688c05/spec/fixture/_posts/fr/ 0000775 0000000 0000000 00000000000 15201735340 0021414 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/spec/fixture/_posts/fr/2020-01-01-test-post.md 0000664 0000000 0000000 00000000140 15201735340 0024710 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Article de Test
lang: fr
---
Contenu de test pour la version francaise.
untra-polyglot-e688c05/spec/fixture/pages/ 0000775 0000000 0000000 00000000000 15201735340 0020575 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/spec/fixture/pages/en.about.md 0000664 0000000 0000000 00000000073 15201735340 0022632 0 ustar 00root root 0000000 0000000 ---
title: About
permalink: about
lang: en
---
# about us
untra-polyglot-e688c05/spec/fixture/pages/en.menu.md 0000664 0000000 0000000 00000000130 15201735340 0022456 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Menu
permalink: the-menu
lang: en
page_id: menu
---
# the menu
untra-polyglot-e688c05/spec/fixture/pages/es.menu.md 0000664 0000000 0000000 00000000112 15201735340 0022463 0 ustar 00root root 0000000 0000000 ---
title: Menu
permalink: el-menu
lang: es
page_id: menu
---
# el menΓΊ
untra-polyglot-e688c05/spec/fixture/pages/es.samba.md 0000664 0000000 0000000 00000000115 15201735340 0022605 0 ustar 00root root 0000000 0000000 ---
title: samba
permalink: samba
lang: es
lang-exclusive: [es]
---
# samba
untra-polyglot-e688c05/spec/fixture/pages/fr.members.md 0000664 0000000 0000000 00000000123 15201735340 0023153 0 ustar 00root root 0000000 0000000 ---
title: membres
permalink: members
lang: fr
lang-exclusive: [fr]
---
# membres
untra-polyglot-e688c05/spec/fixture/pages/fr.menu.md 0000664 0000000 0000000 00000000135 15201735340 0022470 0 ustar 00root root 0000000 0000000 ---
layout: post
title: Menu
permalink: le-menu
lang: fr
page_id: menu
---
# français menu
untra-polyglot-e688c05/spec/fixture/sitemap.xml 0000664 0000000 0000000 00000007250 15201735340 0021666 0 ustar 00root root 0000000 0000000 ---
layout: content
---
{% for lang in site.languages %}
{% for node in site.pages %}
{% comment %}{% endcomment %}
{% unless site.exclude_from_localization contains node.path %}
{% comment %}{% endcomment %}
{% if node.layout %}
{% if lang == site.default_lang %}{{ node.url | absolute_url }}{% else %}{{ node.url | prepend: lang | prepend: '/' | absolute_url }}{% endif %}
{% if node.last_modified_at and node.last_modified_at != node.date %}{{ node.last_modified_at | date: '%Y-%m-%dT%H:%M:%S%:z' }} {% elsif node.date %}{{ node.date | date: '%Y-%m-%dT%H:%M:%S%:z' }} {% endif %}
{% comment %}{% endcomment %}
{% if node.permalink_lang %}
{% for alt_lang in site.languages %}
{% if node.permalink_lang[alt_lang] %}
{% endif %}
{% endunless %}
{% endfor %}
{% comment %}{% endcomment %}
{% for collection in site.collections %}
{% for node in site[collection.label] %}
{% if lang == site.default_lang %}{{ node.url | absolute_url }}{% else %}{{ node.url | prepend: lang | prepend: '/' | absolute_url }}{% endif %}
{% if node.last_modified_at and node.last_modified_at != node.date %}{{ node.last_modified_at | date: '%Y-%m-%dT%H:%M:%S%:z' }} {% elsif node.date %}{{ node.date | date: '%Y-%m-%dT%H:%M:%S%:z' }} {% endif %}
{% comment %}{% endcomment %}
{% for alt_lang in site.languages %}
{% endfor %}
{% endfor %}
{% endfor %}
untra-polyglot-e688c05/spec/jekyll/ 0000775 0000000 0000000 00000000000 15201735340 0017302 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/spec/jekyll/polyglot/ 0000775 0000000 0000000 00000000000 15201735340 0021153 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/spec/jekyll/polyglot/hooks/ 0000775 0000000 0000000 00000000000 15201735340 0022276 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/spec/jekyll/polyglot/hooks/coordinate_spec.rb 0000664 0000000 0000000 00000013403 15201735340 0025765 0 ustar 00root root 0000000 0000000 require 'rspec/helper'
require 'ostruct'
require 'fileutils'
require 'tmpdir'
require_relative '../../../../lib/jekyll/polyglot/hooks/coordinate'
Dir.mktmpdir do |_|
FileUtils.mkdir_p 'css'
FileUtils.mkdir_p 'images'
FileUtils.mkdir_p 'javascript'
describe 'hook_coordinate' do
before do
@config = Jekyll::Configuration::DEFAULTS.dup
@langs = ['en', 'fr', 'es']
@default_lang = 'en'
@exclude_from_localization = ['javascript', 'images', 'css/', 'README.md']
@config['langs'] = @langs
@config['default_lang'] = @default_lang
@config['exclude_from_localization'] = @exclude_from_localization
@parallel_localization = @config['parallel_localization'] || true
@site = Site.new(
Jekyll.configuration(
'languages' => @langs,
'default_lang' => @default_lang,
'exclude_from_localization' => @exclude_from_localization,
'source' => File.expand_path('../../../../fixture', __FILE__)
)
)
@site.prepare
@collection = Jekyll::Collection.new(@site, "fixture")
@site.data = { 'foo' => 'databar', 'baz' => 'databaz', 'strings' => {
'banana' => 'banana'
} }
@site.data['en'] = { 'foo' => 'enbar', 'strings' => {
'apple' => 'apple', 'ice cream' => 'ice cream'
} }
@site.data['fr'] = { 'foo' => 'frbar', 'strings' => {
'ice cream' => 'crème glacée'
} }
end
it 'should have trailing / on all dir entries in exclude_from_localization' do
expect(@site.exclude_from_localization).to eq(["javascript/", "images/", "css/", "README.md"])
end
it 'should merge the site.data.active_lang to the site.data' do
hook_coordinate(@site)
expect(@site.data['foo']).to eq('enbar')
expect(@site.data['baz']).to eq('databaz')
expect(@site.data['strings']['ice cream']).to eq('ice cream')
expect(@site.data['strings']['apple']).to eq('apple')
expect(@site.data['strings']['banana']).to eq('banana')
end
it 'should fall back to the default_lang when using translated site data' do
@site.active_lang = 'fr'
hook_coordinate(@site)
expect(@site.data['foo']).to eq('frbar')
expect(@site.data['baz']).to eq('databaz')
expect(@site.data['strings']['ice cream']).to eq('crème glacée') # Populated from @site.data['strings'][@site.active_lang]['ice cream']
expect(@site.data['strings']['apple']).to eq('apple') # Populated from @site.data['strings'][@site.default_lang]['apple']
expect(@site.data['strings']['banana']).to eq('banana') # Populated from @site.data['strings']['apple']
end
it "site.process triggers :polyglot, :post_write hook" do
hook_called = false
Jekyll::Hooks.register(:polyglot, :post_write) do |_site|
hook_called = true
end
@site.process
expect(hook_called).to be true
end
describe @coordinate_documents do
it 'test fixtures in the default lang' do
expect(@site.source).to end_with('spec/fixture')
@site.process_language 'en'
expect(@site.pages).to have_attributes(size: 3) # 2 pages + sitemap.xml
end
it 'should include files in the default_lang without active_lang' do
@site.process_language 'fr'
expect(@site.pages).to have_attributes(size: 4) # 3 pages + sitemap.xml
expect(@site.pages.map(&:name)).to include('en.about.md')
end
it 'should include files in the active_lang' do
@site.process_language 'fr'
expect(@site.pages).to have_attributes(size: 4) # 3 pages + sitemap.xml
expect(@site.pages.map(&:name)).to include('fr.menu.md', 'fr.members.md')
end
it 'should not include files in the default_lang with the active_lang' do
@site.process_language 'fr'
print(@site.pages.map(&:name))
expect(@site.pages.map(&:name)).not_to include('en.menu.md')
end
it 'should not include files in a different lang from the active_lang' do
@site.process_language 'fr'
expect(@site.pages.map(&:name)).not_to include('es.menu.md')
end
it 'should not be included if the active_lang is not part of the lang-exclusive' do
@site.process_language 'fr'
expect(@site.pages.map(&:name)).not_to include('es.samba.md')
end
it 'should respect permalinks when page_id is specified' do
@site.process_language 'en'
expect(@site.pages.select { |doc| doc.name == 'en.about.md' }.first.permalink).to eq('about')
expect(@site.pages.select { |doc| doc.name == 'en.menu.md' }.first.permalink).to eq('the-menu')
@site.process_language 'es'
expect(@site.pages.select { |doc| doc.name == 'es.menu.md' }.first.permalink).to eq('el-menu')
expect(@site.pages.select { |doc| doc.name == 'es.samba.md' }.first.permalink).to eq('samba')
@site.process_language 'fr'
expect(@site.pages.select { |doc| doc.name == 'fr.menu.md' }.first.permalink).to eq('le-menu')
expect(@site.pages.select { |doc| doc.name == 'fr.members.md' }.first.permalink).to eq('members')
end
it 'should contain permalink_lang when page_id is specified' do
@site.process_language 'en'
menu_permalink_lang = @site.pages.select { |doc| doc.name == 'en.menu.md' }.first.data['permalink_lang']
expect(menu_permalink_lang).to have_attributes(size: 3)
expect(menu_permalink_lang.keys).to match_array(@site.config['languages'])
expect(menu_permalink_lang['en']).to eq('the-menu')
expect(menu_permalink_lang['es']).to eq('el-menu')
expect(menu_permalink_lang['fr']).to eq('le-menu')
end
end
end
end
untra-polyglot-e688c05/spec/jekyll/polyglot/hooks/polyglot_hook_spec.rb 0000664 0000000 0000000 00000005717 15201735340 0026540 0 ustar 00root root 0000000 0000000 require 'jekyll'
require 'rspec/helper'
describe 'Polyglot Custom Hook' do
before do
@config = Jekyll::Configuration::DEFAULTS.dup
@langs = ['en', 'es', 'fr']
@default_lang = 'en'
@exclude_from_localization = ['javascript/', 'images/', 'css/']
@config['languages'] = @langs
@config['default_lang'] = @default_lang
@config['exclude_from_localization'] = @exclude_from_localization
@config['source'] = File.expand_path('../../fixture', __dir__)
@config['destination'] = File.join(@config['source'], '_site')
@site = Site.new(@config)
@site.prepare
end
describe ':polyglot, :post_write hook' do
it 'should trigger the hook with site parameter' do
hook_triggered = false
received_site = nil
# Register the hook
Jekyll::Hooks.register :polyglot, :post_write do |site|
hook_triggered = true
received_site = site
end
# Process the site to trigger the hook
@site.process
# Verify the hook was triggered and received the site parameter
expect(hook_triggered).to be true
expect(received_site).to eq(@site)
expect(received_site).to be_a(Site)
end
it 'should trigger the hook with correct site properties' do
hook_triggered = false
received_site = nil
# Register the hook
Jekyll::Hooks.register :polyglot, :post_write do |site|
hook_triggered = true
received_site = site
end
# Process the site to trigger the hook
@site.process
# Verify the hook was triggered and site has expected properties
expect(hook_triggered).to be true
expect(received_site).to eq(@site)
expect(received_site.default_lang).to eq(@default_lang)
expect(received_site.languages).to eq(@langs)
expect(received_site.active_lang).to eq(@default_lang)
end
it 'should allow multiple hooks to be registered' do
hook1_triggered = false
hook2_triggered = false
received_sites = []
# Register multiple hooks
Jekyll::Hooks.register :polyglot, :post_write do |site|
hook1_triggered = true
received_sites << site
end
Jekyll::Hooks.register :polyglot, :post_write do |site|
hook2_triggered = true
received_sites << site
end
# Process the site to trigger the hooks
@site.process
# Verify both hooks were triggered
expect(hook1_triggered).to be true
expect(hook2_triggered).to be true
expect(received_sites.length).to eq(2)
expect(received_sites.all? { |site| site == @site }).to be true
end
it 'should trigger hook after all language processing is complete' do
hook_triggered = false
# Register a hook that tracks when it's called
Jekyll::Hooks.register :polyglot, :post_write do |_site|
hook_triggered = true
end
# Process the site
@site.process
# Verify hook was triggered
expect(hook_triggered).to be true
end
end
end
untra-polyglot-e688c05/spec/jekyll/polyglot/hooks/redirects_spec.rb 0000664 0000000 0000000 00000017175 15201735340 0025634 0 ustar 00root root 0000000 0000000 require 'rspec/helper'
require 'fileutils'
require 'tmpdir'
describe 'hook_redirects' do
let(:tmpdir) { Dir.mktmpdir }
let(:dest_dir) { File.join(tmpdir, '_site') }
before do
FileUtils.mkdir_p(dest_dir)
@config = Jekyll::Configuration::DEFAULTS.dup
@langs = ['en', 'es', 'fr', 'de']
@default_lang = 'en'
end
after do
FileUtils.rm_rf(tmpdir)
end
def create_site(config_overrides = {})
site_config = {
'languages' => @langs,
'default_lang' => @default_lang,
'source' => tmpdir,
'destination' => dest_dir
}.merge(config_overrides)
site = Site.new(Jekyll.configuration(site_config))
site.prepare
site
end
def write_redirects(content)
File.write(File.join(tmpdir, '_redirects'), content)
end
def read_output_redirects
path = File.join(dest_dir, '_redirects')
return nil unless File.exist?(path)
File.read(path)
end
describe 'when localize_redirects is disabled (default)' do
it 'should not modify the _redirects file' do
write_redirects("/github https://github.com/org/repo 302\n")
# Copy file to dest to simulate Jekyll build
FileUtils.cp(File.join(tmpdir, '_redirects'), dest_dir)
site = create_site
hook_redirects(site)
output = read_output_redirects
expect(output).to eq("/github https://github.com/org/repo 302\n")
end
end
describe 'when localize_redirects is enabled' do
it 'should generate localized redirects for each language' do
write_redirects("/github https://github.com/org/repo 302\n")
FileUtils.cp(File.join(tmpdir, '_redirects'), dest_dir)
site = create_site('localize_redirects' => true)
hook_redirects(site)
output = read_output_redirects
expect(output).to include("/github https://github.com/org/repo 302")
expect(output).to include("/es/github https://github.com/org/repo 302")
expect(output).to include("/fr/github https://github.com/org/repo 302")
expect(output).to include("/de/github https://github.com/org/repo 302")
# Should not include default language prefix
expect(output).not_to include("/en/github")
end
it 'should preserve comments' do
write_redirects("# This is a comment\n/github https://github.com/org/repo 302\n")
FileUtils.cp(File.join(tmpdir, '_redirects'), dest_dir)
site = create_site('localize_redirects' => true)
hook_redirects(site)
output = read_output_redirects
expect(output).to include("# This is a comment")
# Comment should not be duplicated with language prefixes
expect(output.scan('# This is a comment').length).to eq(1)
end
it 'should preserve empty lines' do
write_redirects("/github https://github.com/org/repo 302\n\n/docs https://docs.example.com 301\n")
FileUtils.cp(File.join(tmpdir, '_redirects'), dest_dir)
site = create_site('localize_redirects' => true)
hook_redirects(site)
output = read_output_redirects
# Original empty line should be preserved
expect(output).to include("\n\n")
end
it 'should handle redirects without status codes' do
write_redirects("/github https://github.com/org/repo\n")
FileUtils.cp(File.join(tmpdir, '_redirects'), dest_dir)
site = create_site('localize_redirects' => true)
hook_redirects(site)
output = read_output_redirects
expect(output).to include("/github https://github.com/org/repo")
expect(output).to include("/es/github https://github.com/org/repo")
end
it 'should not localize paths that already have language prefix' do
write_redirects("/es/old-page /es/new-page 301\n")
FileUtils.cp(File.join(tmpdir, '_redirects'), dest_dir)
site = create_site('localize_redirects' => true)
hook_redirects(site)
output = read_output_redirects
# Should only have the original line, not /es/es/old-page or /fr/es/old-page
expect(output.strip).to eq("/es/old-page /es/new-page 301")
end
end
describe 'exclude_from_redirect_localization' do
it 'should not localize excluded paths' do
write_redirects("/github https://github.com/org/repo 302\n/signin https://app.example.com/signin 302\n")
FileUtils.cp(File.join(tmpdir, '_redirects'), dest_dir)
site = create_site(
'localize_redirects' => true,
'exclude_from_redirect_localization' => ['/signin']
)
hook_redirects(site)
output = read_output_redirects
# /github should be localized
expect(output).to include("/es/github https://github.com/org/repo 302")
# /signin should NOT be localized
expect(output).not_to include("/es/signin")
expect(output).not_to include("/fr/signin")
# But original /signin should still be present
expect(output).to include("/signin https://app.example.com/signin 302")
end
it 'should handle multiple exclusions' do
write_redirects("/github https://github.com 302\n/signin https://app.example.com/signin 302\n/app https://app.example.com 302\n")
FileUtils.cp(File.join(tmpdir, '_redirects'), dest_dir)
site = create_site(
'localize_redirects' => true,
'exclude_from_redirect_localization' => ['/signin', '/app']
)
hook_redirects(site)
output = read_output_redirects
expect(output).to include("/es/github")
expect(output).not_to include("/es/signin")
expect(output).not_to include("/es/app")
end
end
describe 'edge cases' do
it 'should handle missing _redirects file gracefully' do
site = create_site('localize_redirects' => true)
# Should not raise an error
expect { hook_redirects(site) }.not_to raise_error
end
it 'should skip lines that do not start with /' do
write_redirects("invalid-line\n/valid https://example.com 302\n")
FileUtils.cp(File.join(tmpdir, '_redirects'), dest_dir)
site = create_site('localize_redirects' => true)
hook_redirects(site)
output = read_output_redirects
expect(output).to include("invalid-line")
expect(output).to include("/es/valid")
# invalid-line should not be localized
expect(output).not_to include("/es/invalid-line")
end
it 'should handle splat redirects' do
write_redirects("/old/* /new/:splat 301\n")
FileUtils.cp(File.join(tmpdir, '_redirects'), dest_dir)
site = create_site('localize_redirects' => true)
hook_redirects(site)
output = read_output_redirects
expect(output).to include("/old/* /new/:splat 301")
# Both source and destination should be localized
expect(output).to include("/es/old/* /es/new/:splat 301")
end
it 'should localize internal destination paths' do
write_redirects("/foo /bar 301\n")
FileUtils.cp(File.join(tmpdir, '_redirects'), dest_dir)
site = create_site('localize_redirects' => true)
hook_redirects(site)
output = read_output_redirects
expect(output).to include("/foo /bar 301")
expect(output).to include("/es/foo /es/bar 301")
expect(output).to include("/fr/foo /fr/bar 301")
expect(output).to include("/de/foo /de/bar 301")
end
it 'should not localize external destination URLs' do
write_redirects("/github https://github.com/org/repo 302\n")
FileUtils.cp(File.join(tmpdir, '_redirects'), dest_dir)
site = create_site('localize_redirects' => true)
hook_redirects(site)
output = read_output_redirects
# External URL should not be prefixed with language
expect(output).to include("/es/github https://github.com/org/repo 302")
expect(output).not_to include("/es/github /es/https://")
expect(output).not_to include("https://es/")
end
end
end
untra-polyglot-e688c05/spec/jekyll/polyglot/hooks/subprocess_spec.rb 0000664 0000000 0000000 00000003305 15201735340 0026026 0 ustar 00root root 0000000 0000000 require 'rspec/helper'
describe 'site process error handling' do
before do
@config = Jekyll::Configuration::DEFAULTS.dup
@langs = ['en', 'fr', 'es']
@default_lang = 'en'
@exclude_from_localization = ['javascript', 'images', 'css/', 'README.md']
@config['langs'] = @langs
@config['default_lang'] = @default_lang
@config['exclude_from_localization'] = @exclude_from_localization
@parallel_localization = @config['parallel_localization'] || true
@site = Site.new(
Jekyll.configuration(
'languages' => @langs,
'default_lang' => @default_lang,
'exclude_from_localization' => @exclude_from_localization,
'source' => File.expand_path('../../../../fixture', __FILE__)
)
)
@site.prepare
@collection = Jekyll::Collection.new(@site, "fixture")
@site.data['en'] = { 'foo' => 'enbar', 'strings' => {
'apple' => 'apple', 'ice cream' => 'ice cream'
} }
@site.data['fr'] = { 'foo' => 'frbar', 'strings' => {
'ice cream' => 'crème glacée'
} }
end
after do
# Clear the hooks to prevent test pollution
Jekyll::Hooks.instance_variable_get(:@registry)[:site][:post_write]&.clear
end
it "site.process throws FatalError if a subprocess fails" do
@thistestonly = false
semaphore = Mutex.new
Jekyll::Hooks.register(:site, :post_write) do |_site|
semaphore.synchronize {
unless @thistestonly
@thistestonly = true
raise 'fail fr intentionally'
end
}
end
expect { @site.process }.to raise_error(RuntimeError)
end
end
untra-polyglot-e688c05/spec/jekyll/polyglot/patches/ 0000775 0000000 0000000 00000000000 15201735340 0022602 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/spec/jekyll/polyglot/patches/jekyll/ 0000775 0000000 0000000 00000000000 15201735340 0024074 5 ustar 00root root 0000000 0000000 untra-polyglot-e688c05/spec/jekyll/polyglot/patches/jekyll/site_spec.rb 0000664 0000000 0000000 00000244061 15201735340 0026406 0 ustar 00root root 0000000 0000000 require 'jekyll'
require 'rspec/helper'
require 'rspec'
require 'tempfile'
TestPage = Struct.new(:data, :url, :relative_path)
describe Site do
before do
@config = Jekyll::Configuration::DEFAULTS.dup
@langs = ['en', 'sp', 'fr', 'de']
@default_lang = 'en'
@exclude_from_localization = ['javascript/', 'images/', 'css/', 'readme']
@config['langs'] = @langs
@config['default_lang'] = @default_lang
@config['exclude_from_localization'] = @exclude_from_localization
@parallel_localization = @config['parallel_localization'] || true
@site = Site.new(
Jekyll.configuration(
'languages' => @langs,
'default_lang' => @default_lang,
'exclude_from_localization' => @exclude_from_localization,
'source' => File.expand_path('fixtures', __dir__),
'url' => 'https://test.github.io'
)
)
@site.prepare
@baseurls = ['/polyglot', '/big-brother', '/bas3url2']
@urls = ['http://localhost:4000', 'https://test.github.io']
@document_url_regex = @site.document_url_regex
@relative_url_regex = @site.relative_url_regex
# @relativize_absolute_urls = @site.relativize_absolute_urls
# @relativize_urls = @site.relativize_urls
end
describe @document_url_regex do
it 'must match common default urls made by jekyll' do
@langs.each do |lang|
expect(@document_url_regex).to match "/#{lang}/foobar"
expect(@document_url_regex).to match ".#{lang}/foobar"
expect(@document_url_regex).to match "foobar.#{lang}/"
end
end
it 'expect not match natural unfortunate urls' do
expect(@document_url_regex).to_not match 'people/karen/foobar/'
expect(@document_url_regex).to_not match 'verbs/gasp/foobar'
expect(@document_url_regex).to_not match 'products/kefr/foobar.html'
expect(@document_url_regex).to_not match 'properties/beachside/foo'
end
it 'expect relativized_urls should handle different output' do
expected = 'expected'
collection_test = Jekyll::Collection.new(@site, 'test')
document = Jekyll::Document.new('about.en.md', site: @site, collection: collection_test)
document.output = expected
@site.relativize_urls(document, @relative_url_regex)
expect(document.output).to eq(expected)
# strings can be frozen and still relativized
document.output.freeze
@site.relativize_urls(document, @relative_url_regex)
expect(document.output).to eq(expected)
end
end
describe @parallel_localization do
it 'should default to true if parallel_localization if not set' do
expect(@parallel_localization).to eq(true)
end
it 'should be false if explicitly set' do
@config['parallel_localization'] = false
@parallel_localization = @config['parallel_localization']
expect(@parallel_localization).to eq(false)
end
end
describe @relative_url_regex do
it 'must match certain strings with any simple baseurl' do
@baseurls.each do |baseurl|
@site.baseurl = baseurl
@relative_url_regex = @site.relative_url_regex
expect(@relative_url_regex).to match "href=\"#{baseurl}/about/\""
expect(@relative_url_regex).to match "href=\"#{baseurl}/about-the-product/\""
expect(@relative_url_regex).to match "href=\"#{baseurl}/2016/all-new-flavors/\""
expect(@relative_url_regex).to match "href=\"#{baseurl}/words-1-with-2-numbers-34/\""
expect(@relative_url_regex).to match "href=\"#{baseurl}/\""
expect(@relative_url_regex).to match "href=\"#{baseurl}/purchase/product/1234-business\""
expect(@relative_url_regex).to match "href=\"#{baseurl}/#about\""
expect(@relative_url_regex).to match "href=\"#{baseurl}/about/#team\""
end
end
it 'must match with an empty baseurl' do
@relative_url_regex = @site.relative_url_regex
expect(@relative_url_regex).to match 'href="/about/"'
expect(@relative_url_regex).to match 'href="/about-the-product/"'
expect(@relative_url_regex).to match 'href="/2016/all-new-flavors/"'
expect(@relative_url_regex).to match 'href="/2016/words-1-with-2-numbers-34/"'
expect(@relative_url_regex).to match 'href="/"'
expect(@relative_url_regex).to match 'href="/purchase/product/1234-business"'
expect(@relative_url_regex).to match 'href="/#about"'
expect(@relative_url_regex).to match 'href="/about/#team"'
end
it 'must not match external urls' do
@relative_url_regex = @site.relative_url_regex
expect(@relative_url_regex).to_not match 'href="http://github.com"'
expect(@relative_url_regex).to_not match 'href="https://talk.jekyllrb.com'
expect(@relative_url_regex).to_not match 'href="http://google.com"'
expect(@relative_url_regex).to_not match 'href="https://untra.github.io/polyglot"'
end
it 'must not match excluded urls' do
@site.exclude += @exclude_from_localization
@relative_url_regex = @site.relative_url_regex
expect(@relative_url_regex).to_not match 'href="/images/my-vacation-photo.jpg"'
expect(@relative_url_regex).to_not match 'href="/css/stylesheet.css"'
expect(@relative_url_regex).to_not match 'href="/readme"'
expect(@relative_url_regex).to_not match 'href="/javascript/65487-app.js"'
end
it 'must not match excluded urls with a set baseurl' do
@baseurls.each do |baseurl|
@site.baseurl = baseurl
@site.exclude += @exclude_from_localization
@relative_url_regex = @site.relative_url_regex
expect(@relative_url_regex).to_not match "href=\"#{baseurl}/javascript/65487-app.js\""
expect(@relative_url_regex).to_not match "href=\"#{baseurl}/images/my-vacation-photo.jpg\""
expect(@relative_url_regex).to_not match "href=\"#{baseurl}/css/stylesheet.css\""
end
end
it 'must not match localized urls' do
@relative_url_regex = @site.relative_url_regex
@langs.each do |lang|
expect(@relative_url_regex).to_not match "href=\"#{lang}/about/\""
expect(@relative_url_regex).to_not match "href=\"#{lang}/\""
expect(@relative_url_regex).to_not match "href=\"#{lang}/purchase/product/1234-business\""
expect(@relative_url_regex).to_not match "href=\"#{lang}/#about\""
expect(@relative_url_regex).to_not match "href=\"#{lang}/about/#team\""
end
end
it 'must not match localized urls with a set baseurl' do
@baseurls.each do |baseurl|
@site.baseurl = baseurl
@site.exclude += @exclude_from_localization
@relative_url_regex = @site.relative_url_regex
expect(@relative_url_regex).to_not match "href=\"#{baseurl}/javascript/65487-app.js\""
expect(@relative_url_regex).to_not match "href=\"#{baseurl}/images/my-vacation-photo.jpg\""
expect(@relative_url_regex).to_not match "href=\"#{baseurl}/css/stylesheet.css\""
end
end
it 'must not match excluded urls with glob patterns' do
# Test with glob pattern in exclude_from_localization
@site.config['exclude_from_localization'] = ['*.sublime-workspace', '*.pdf', '.github']
@site.prepare
@site.exclude += @site.exclude_from_localization
@relative_url_regex = @site.relative_url_regex
# These should NOT match because they match the glob pattern
expect(@relative_url_regex).to_not match 'href="/my-project.sublime-workspace"'
expect(@relative_url_regex).to_not match 'href="/another-project.sublime-workspace"'
expect(@relative_url_regex).to_not match 'href="/menu.pdf"'
expect(@relative_url_regex).to_not match 'href="https://untra.github.io"'
# These should still match because they don't match the glob pattern
expect(@relative_url_regex).to match 'href="/about/"'
expect(@relative_url_regex).to match 'href="/contact/"'
end
it 'must not match excluded urls with glob patterns and baseurl' do
# Test with glob pattern in exclude_from_localization and baseurl
@site.config['exclude_from_localization'] = ['*.sublime-workspace']
@site.prepare
@site.exclude += @site.exclude_from_localization
@baseurls.each do |baseurl|
@site.baseurl = baseurl
@relative_url_regex = @site.relative_url_regex
# These should NOT match because they match the glob pattern
expect(@relative_url_regex).to_not match "href=\"#{baseurl}/my-project.sublime-workspace\""
expect(@relative_url_regex).to_not match "href=\"#{baseurl}/another-project.sublime-workspace\""
# These should still match because they don't match the glob pattern
expect(@relative_url_regex).to match "href=\"#{baseurl}/about/\""
expect(@relative_url_regex).to match "href=\"#{baseurl}/contact/\""
end
end
it 'disabled relativization must match ferh relative url with baseurl' do
@baseurls.each do |baseurl|
@site.baseurl = baseurl
@urls.each do |url|
@site.config['url'] = url
@relative_url_regex = @site.relative_url_regex(true)
expect(@relative_url_regex).to match "ferh=\"#{baseurl}/about/\""
expect(@relative_url_regex).to match "ferh=\"#{baseurl}/about-the-product/\""
expect(@relative_url_regex).to match "ferh=\"#{baseurl}/2016/all-new-flavors/\""
expect(@relative_url_regex).to match "ferh=\"#{baseurl}/words-1-with-2-numbers-34/\""
expect(@relative_url_regex).to match "ferh=\"#{baseurl}/\""
expect(@relative_url_regex).to match "ferh=\"#{baseurl}/purchase/product/1234-business\""
expect(@relative_url_regex).to match "ferh=\"#{baseurl}/#about\""
expect(@relative_url_regex).to match "ferh=\"#{baseurl}/about/#team\""
end
end
end
end
describe @derive_lang_from_path do
before(:each) do
config = Jekyll.configuration(
'site' => @site,
'languages' => ['en', 'es', 'pt-br'], # fr not included
'default_lang' => @default_lang,
'exclude_from_localization' => @exclude_from_localization,
'source' => File.expand_path('fixtures', __dir__),
'lang_from_path' => true
)
@site = Site.new(config)
@site.prepare
end
it 'should derive lang from any part of the path' do
collection_en = Jekyll::Collection.new(@site, 'en')
collection_es = Jekyll::Collection.new(@site, 'es')
collection_pt_br = Jekyll::Collection.new(@site, 'pt-br')
collection_wrong = Jekyll::Collection.new(@site, 'wrong')
specs = {
'en' => [
Jekyll::Document.new('about.en.md', site: @site, collection: collection_en),
Jekyll::Document.new('fr/about.en.md', site: @site, collection: collection_en)
],
'es' => [
Jekyll::Document.new('pages/es/acercade.es.md', site: @site, collection: collection_es),
Jekyll::Document.new('french-touch/restaurant/fr/es/acerade.md', site: @site, collection: collection_es)
],
'pt-br' => [
Jekyll::Document.new('about.pt-br.md', site: @site, collection: collection_pt_br),
Jekyll::Document.new('international/restaurant/pt-br/sobre.md', site: @site, collection: collection_pt_br),
# With case-insensitive matching, pt-BR in path should match pt-br in config
Jekyll::Document.new('missing/pt-BR/sobre.md', site: @site, collection: collection_pt_br)
],
nil => [
Jekyll::Document.new('apropos.fr.md', site: @site, collection: collection_wrong), # not included in languages
Jekyll::Document.new('taken/blues/newspaper.md', site: @site, collection: collection_wrong), # no matches
Jekyll::Document.new('es-en-pt-br/wordswordswords.html', site: @site, collection: collection_wrong) # wont split
]
}
specs.each do |lang, docs|
docs.each do |document|
expect(@site.lang_from_path).to eq(true)
derived = @site.derive_lang_from_path document
if lang.nil?
expect(derived).to be_nil
else
expect(derived).to eq(lang)
end
end
end
end
end
describe @absolute_url_regex do
it 'must match absolute url' do
@urls.each do |url|
@site.config['url'] = url
@site.prepare
@absolute_url_regex = @site.absolute_url_regex(url)
expect(@absolute_url_regex).to match "href=\"#{url}/javascript/65487-app.js\""
expect(@absolute_url_regex).to match "href=\"#{url}/images/my-vacation-photo.jpg\""
expect(@absolute_url_regex).to match "href=\"#{url}/css/stylesheet.css\""
end
end
it 'must match absolute url' do
@urls.each do |url|
@site.config['url'] = url
@absolute_url_regex = @site.absolute_url_regex(url)
expect(@absolute_url_regex).to match "href=\"#{url}/javascript/65487-app.js\""
expect(@absolute_url_regex).to match "href=\"#{url}/images/my-vacation-photo.jpg\""
expect(@absolute_url_regex).to match "href=\"#{url}/css/stylesheet.css\""
end
end
it 'must not match absolute url for another project' do
@urls.each do |url|
@site.config['url'] = url
@absolute_url_regex = @site.absolute_url_regex(url)
expect(@absolute_url_regex).to_not match 'href="http://test_github.io/javascript/65487-app.js'
expect(@absolute_url_regex).to_not match 'href="http://test_github.io/images/my-vacation-photo.jpg'
expect(@absolute_url_regex).to_not match 'href="http://github.io/css/stylesheet.css'
end
end
it 'must not match whitespaced urls' do
@urls.each do |url|
@site.config['url'] = url
@absolute_url_regex = @site.absolute_url_regex(url)
expect(@absolute_url_regex).to_not match "href=\" #{url}/javascript/65487-app.js\""
expect(@absolute_url_regex).to_not match "href=\" #{url}/images/my-vacation-photo.jpg\""
expect(@absolute_url_regex).to_not match "href=\" #{url}/css/stylesheet.css\" "
end
end
it 'must match absolute url with baseurl' do
@baseurls.each do |baseurl|
@site.baseurl = baseurl
@urls.each do |url|
@site.config['url'] = url
@absolute_url_regex = @site.absolute_url_regex(url)
expect(@absolute_url_regex).to match " href=\"#{url}#{baseurl}/javascript/65487-app.js\""
expect(@absolute_url_regex).to match " href=\"#{url}#{baseurl}/images/my-vacation-photo.jpg\""
expect(@absolute_url_regex).to match " href=\"#{url}#{baseurl}/css/stylesheet.css\""
end
end
end
it 'disabled relativization must match ferh absolute url with baseurl' do
@baseurls.each do |baseurl|
@site.baseurl = baseurl
@urls.each do |url|
@site.config['url'] = url
@absolute_url_regex = @site.absolute_url_regex(url, true)
expect(@absolute_url_regex).to match "ferh=\"#{url}#{baseurl}/javascript/65487-app.js\""
expect(@absolute_url_regex).to match "ferh=\"#{url}#{baseurl}/images/my-vacation-photo.jpg\""
expect(@absolute_url_regex).to match "ferh=\"#{url}#{baseurl}/css/stylesheet.css\""
end
end
end
it 'negative lookbehind for hreflang excludes default lang and x-default but not canonical' do
@baseurls.each do |baseurl|
@site.baseurl = baseurl
@urls.each do |url|
@site.config['url'] = url
@absolute_url_regex = @site.absolute_url_regex(url)
# Canonical URLs SHOULD be matched so they get language prefix on translated pages
expect(@absolute_url_regex).to match "