@jjlmoya/utils-nautical 1.5.0 → 1.7.0

package/src/tool/tideCalculator/i18n/tr.ts

@@ -0,0 +1,203 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { TideCalculatorUI, TideCalculatorLocaleContent } from '../index';
+
+const slug = 'gelgit-hesaplayici-tr';
+const title = 'Gelgit Yüksekliği Hesaplayıcı';
+const description =
+  'Nautik "On İkide Bir" (Rule of Twelfths) kuralını kullanarak gelgit döngüsünün herhangi bir noktasındaki su derinliğini tahmin edin. Kıyı planlaması ve amatör denizci belgesi çalışmaları için idealdir.';
+
+const ui: TideCalculatorUI = {
+  parametersLabel: 'Parametreler',
+  highTideLabel: 'Tam Deniz (Yüksek Gel)',
+  lowTideLabel: 'Alçak Deniz (Düşük Gel)',
+  targetTimeLabel: 'Sorgu zamanı',
+  estimatedHeightLabel: 'Tahmini Yükseklik',
+  metersLabel: 'metre',
+  amplitudeLabel: 'Genlik (Amplitüd)',
+  durationLabel: 'Süre',
+  tableBreakdownLabel: 'On İkide Bir Dağılımı',
+  tableHourLabel: 'Zaman',
+  tableStateLabel: 'Durum',
+  tableStartLabel: 'Başlangıç',
+  tableEndLabel: 'Bitiş',
+  statusUpLabel: 'Yükseliyor',
+  statusDownLabel: 'Alçalıyor',
+  statusOutOfRange: 'Aralık dışı',
+  faqTitle: 'Sıkça Sorulan Sorular',
+  bibliographyTitle: 'Kaynakça',
+};
+
+const faq: TideCalculatorLocaleContent['faq'] = [
+  {
+    question: 'On İkide Bir Kuralı nedir ve ne için kullanılır?',
+    answer:
+      'On İkide Bir Kuralı, tam deniz ve alçak deniz arasındaki herhangi bir noktada gelgit yüksekliğini tahmin etmek için navigasyonda kullanılan basitleştirilmiş bir matematiksel yöntemdir. Gelgit akışının yaklaşık bir sinüzoidal eğriyi takip ettiği gözlemi temel alınarak, toplam genlik 6 saatlik bir süre boyunca 12 parçaya bölünür (1/12, 2/12, 3/12, 3/12, 2/12, 1/12).',
+  },
+  {
+    question: 'Bu yöntem gerçek navigasyon için güvenilir midir?',
+    answer:
+      'Hızlı planlama ve eğitim amaçları için çok yararlı bir teorik tahmin yöntemidir. Ancak, hava basıncı veya rüzgar gibi deniz seviyesini birkaç desimetre değiştirebilen meteorolojik faktörleri hesaba katmaz. Gerçek navigasyon için daima resmi gelgit tablolarına başvurun.',
+  },
+  {
+    question: 'Gelgit yüksekliğini hesaplamak için hangi verilere ihtiyacım var?',
+    answer:
+      'Sorgulamak istediğiniz ana en yakın tam deniz ve alçak denizin zamanına ve yüksekliğine (metre cinsinden) ihtiyacınız vardır. Bu veriler gelgit almanaklarında veya marin hava durumu uygulamalarında bulunur.',
+  },
+  {
+    question: 'Gelgit neden her zaman aynı hızda yükselmez?',
+    answer:
+      'Büyük su kütlelerinin eylemsizliği ve okyanus havzalarının konfigürasyonu nedeniyle. Gelgit, alçak denizden sonra yavaşça yükselmeye başlar, orta saatlerde (3/12 ve 4/12 saatleri) maksimum hıza ulaşır ve tam denize yaklaştıkça tekrar yavaşlar.',
+  },
+  {
+    question: 'Atmosfer basıncı gelgiti nasıl etkiler?',
+    answer:
+      'Yüksek basınç (antisiklon) suyu aşağı iterek gerçek yüksekliği azaltır. Alçak basınç (depresyon) suyun daha fazla yükselmesine izin verir. Genel bir kural olarak, ortalamadan 1 hPa\'lık bir sapma, deniz seviyesinde yaklaşık 1 cm\'lik bir değişime karşılık gelir.',
+  },
+  {
+    question: 'Gelgit genliği (tidal range) nedir?',
+    answer:
+      'Bir tam deniz ile hemen öncesindeki veya sonrasındaki alçak deniz arasındaki dikey yükseklik farkıdır. Bu ölçüm ayın evrelerine (syzygy - ilk dördün/son dördün) ve coğrafi konuma göre değişir.',
+  },
+];
+
+const howTo: TideCalculatorLocaleContent['howTo'] = [
+  {
+    name: 'Tam deniz ve alçak denizi belirleyin',
+    text: 'İlgilendiğiniz gelgit döngüsü için zaman ve yükseklik bilgilerini almak üzere gelgit almanağınıza başvurun.',
+  },
+  {
+    name: 'Verileri hesaplayıcıya girin',
+    text: 'Tam deniz ve alçak deniz zamanını ve yüksekliğini girin. Araç, süreyi ve genliği otomatik olarak belirleyecektir.',
+  },
+  {
+    name: 'Sorgu zamanını ayarlayın',
+    text: 'Su seviyesini bilmek istediğiniz zamanı ayarlayın. Grafikte vurgulanan tam noktayı göreceksiniz.',
+  },
+  {
+    name: 'On ikide bir tablosunu analiz edin',
+    text: 'Su seviyesinin tüm dönem boyunca nasıl dalgalanacağını anlamak için saat bazlı dağılımı inceleyin.',
+  },
+];
+
+const bibliography: TideCalculatorLocaleContent['bibliography'] = [
+  {
+    name: 'Puertos del Estado - Tide Prediction',
+    url: 'https://portus.puertos.es/#/',
+  },
+  {
+    name: 'Instituto Hidrografico de la Marina',
+    url: 'https://armada.defensa.gob.es/ihm/',
+  },
+];
+
+const seo: TideCalculatorLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: 'Gelgitte Uzmanlaşmak: Navigasyonda On İkide Bir Kuralı',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: 'Kıyı navigasyonu ve sınırlı derinliğe sahip limanlara giriş, her an su derinliği hakkında kesin bilgi gerektirir. Günümüzde gerçek zamanlı veri sağlayan dijital uygulamalar ve GPS mevcut olsa da, <strong>On İkide Bir Kuralı</strong> her türlü tekne kaptanı eğitiminde temel bir araç olmaya devam etmektedir. Bu kural, karmaşık hesap makineleri olmadan bir gelgit döngüsünün herhangi bir noktasında gelgit yüksekliğini yaklaşık olarak hesaplamanıza olanak tanıyan matematiksel bir tahmin yöntemidir.',
+  },
+  {
+    type: 'title',
+    text: 'On İkide Bir Kuralı tam olarak nedir?',
+    level: 3,
+  },
+  {
+    type: 'paragraph',
+    html: 'On İkide Bir Kuralı, gelgit akışının sabit olmadığı gözlemine dayanır. Su, tam deniz ile alçak deniz arasındaki yaklaşık altı saat boyunca aynı hızda yükselmez veya alçalmaz. Bunun yerine, hareket sinüzoidal bir eğriyi takip eder. İlk saat boyunca gelgit yavaş hareket eder; orta saatlerde hızlanır ve bir sonraki uç noktaya yaklaştıkça tekrar yavaşlar.',
+  },
+  {
+    type: 'table',
+    headers: ['Döngü Saati', 'Oran', 'Akış Durumu'],
+    rows: [
+      ['<strong>1. Saat</strong>', 'Genliğin 1/12\'si', 'Yavaş başlangıç (Durgun su başı)'],
+      ['<strong>2. Saat</strong>', 'Genliğin 2/12\'si', 'Hızlanan akış'],
+      ['<strong>3. Saat</strong>', 'Genliğin 3/12\'si', 'Maksimum akış (Güçlü akıntı)'],
+      ['<strong>4. Saat</strong>', 'Genliğin 3/12\'si', 'Sürekli akış'],
+      ['<strong>5. Saat</strong>', 'Genliğin 2/12\'si', 'Belirgin yavaşlama'],
+      ['<strong>6. Saat</strong>', 'Genliğin 1/12\'si', 'Son yavaşlama (Durgun suya doğru)'],
+    ],
+  },
+  {
+    type: 'title',
+    text: 'Teknik sınırlamalar: Gerçek gelgiti etkileyen faktörler',
+    level: 3,
+  },
+  {
+    type: 'glossary',
+    items: [
+      { term: 'Atmosfer basıncı', definition: 'Alçak basınç deniz seviyesini yükseltir; yüksek basınç ise düşürür. Genel kural olarak, ortalamadan her 1 hPa\'lık fark için ~1 cm değişim olur.' },
+      { term: 'Kıyı rüzgarı', definition: 'Karaya doğru esen sürekli rüzgarlar, suyu gelgit tablolarında tahmin edilen seviyelerin üzerine yığabilir.' },
+      { term: 'Yerel topografya', definition: 'Kıyı şekli, deniz tabanı derinliği ve nehir ağızlarının varlığı gelgit akışını önemli ölçüde geciktirebilir veya hızlandırabilir.' },
+    ],
+  },
+  {
+    type: 'tip',
+    title: 'Güvenlik Notu',
+    html: 'Bu araç matematiksel bir tahmin yöntemi kullanmaktadır. Meteorolojik faktörleri veya yerel topografyayı hesaba katmaz. Gerçek navigasyon için daima resmi gelgit tablolarına başvurun.',
+  },
+  {
+    type: 'title',
+    text: 'Yeni denizciler için temel kavramlar',
+    level: 3,
+  },
+  {
+    type: 'glossary',
+    items: [
+      {
+        term: 'Gelgit genliği',
+        definition: 'Tam deniz ile alçak deniz arasındaki dikey fark. Bazı bölgelerde birkaç metre olabilir; Akdeniz\'de ise neredeyse ihmal edilebilir düzeydedir.',
+      },
+      {
+        term: 'Gelgit süresi',
+        definition: 'Bir tam deniz ile bir sonraki alçak deniz arasındaki zaman aralığı. Tipik olarak yaklaşık 6 saat 12 dakikadır.',
+      },
+      {
+        term: 'Harita düzlemi (Chart datum)',
+        definition: 'Deniz haritalarındaki tüm derinliklerin ölçüldüğü referans seviyesidir. Gerçek derinlikler neredeyse hiçbir zaman belirtilenlerden daha az değildir.',
+      },
+    ],
+  },
+];
+
+const schemas: TideCalculatorLocaleContent['schemas'] = [
+  {
+    '@context': 'https://schema.org',
+    '@type': 'SoftwareApplication',
+    name: title,
+    description,
+    applicationCategory: 'UtilityApplication',
+    operatingSystem: 'Web',
+    offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  } as WithContext<SoftwareApplication>,
+  {
+    '@context': 'https://schema.org',
+    '@type': 'FAQPage',
+    mainEntity: faq.map((item) => ({
+      '@type': 'Question',
+      name: item.question,
+      acceptedAnswer: { '@type': 'Answer', text: item.answer },
+    })),
+  } as WithContext<FAQPage>,
+  {
+    '@context': 'https://schema.org',
+    '@type': 'HowTo',
+    name: `Nasıl kullanılır: ${title}`,
+    step: howTo.map((s) => ({ '@type': 'HowToStep', name: s.name, text: s.text })),
+  } as WithContext<HowTo>,
+];
+
+export const content: TideCalculatorLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faq,
+  bibliography,
+  howTo,
+  schemas,
+};

package/src/tool/tideCalculator/i18n/zh.ts

@@ -0,0 +1,203 @@
+import type { WithContext, FAQPage, HowTo, SoftwareApplication } from 'schema-dts';
+import type { TideCalculatorUI, TideCalculatorLocaleContent } from '../index';
+
+const slug = 'tide-height-calculator';
+const title = '潮汐高度计算器';
+const description =
+  '使用航海“十二分之一法则”估算潮汐周期中任意点的水深。是海岸规划和航海执照学习的理想工具。';
+
+const ui: TideCalculatorUI = {
+  parametersLabel: '参数',
+  highTideLabel: '高潮',
+  lowTideLabel: '低潮',
+  targetTimeLabel: '查询时间',
+  estimatedHeightLabel: '估算高度',
+  metersLabel: '米',
+  amplitudeLabel: '潮差',
+  durationLabel: '持续时间',
+  tableBreakdownLabel: '十二分之一法则详解',
+  tableHourLabel: '时间',
+  tableStateLabel: '状态',
+  tableStartLabel: '开始',
+  tableEndLabel: '结束',
+  statusUpLabel: '上涨',
+  statusDownLabel: '下降',
+  statusOutOfRange: '超出范围',
+  faqTitle: '常见问题',
+  bibliographyTitle: '参考文献统计',
+};
+
+const faq: TideCalculatorLocaleContent['faq'] = [
+  {
+    question: '什么是十二分之一法则（Rule of Twelfths），它有什么用途？',
+    answer:
+      '十二分之一法则是航海中常用的一种简化的数学方法，用于估算满潮和干潮之间任意时间点的潮水高度。它基于潮汐流近似遵循正弦曲线的观察，将 6 小时的总潮差分为 12 份（1/12, 2/12, 3/12, 3/12, 2/12, 1/12）。',
+  },
+  {
+    question: '这种方法在实际航行中可靠吗？',
+    answer:
+      '这是一种非常实用的理论估算方法，适用于快速规划和教学目的。然而，它不考虑大气压力或风等气象因素，这些因素可能会改变海平面数分米。对于实际航行，请始终参考官方潮汐表。',
+  },
+  {
+    question: '计算潮汐高度需要哪些数据？',
+    answer:
+      '您需要离您查询时刻最近的高潮和低潮的时间及高度（以米为单位）。这些数据可以在潮汐年鉴或海洋天气应用程序中找到。',
+  },
+  {
+    question: '为什么潮汐并不总是以恒定的速度上涨？',
+    answer:
+      '这是由于巨大水体的惯性和海洋盆地的构造。潮汐在低潮后开始缓慢上升，在中间小时（第 3 和第 4 个 1/12 小时）达到最大速度，并在接近高潮时再次放缓。',
+  },
+  {
+    question: '大气压力如何影响潮汐？',
+    answer:
+      '高压（反气旋）将水向下推，降低实际高度。低压（气旋）则允许海水上升得更高。作为一般规则，气压相对于平均值变化 1 hPa，对应海平面约 1 cm 的变化。',
+  },
+  {
+    question: '什么是潮差（tidal range）？',
+    answer:
+      '它是高潮与紧接其前后的低潮之间的垂直高度差。该测量值会根据月相（大潮和小潮）以及地理位置而变化。',
+  },
+];
+
+const howTo: TideCalculatorLocaleContent['howTo'] = [
+  {
+    name: '识别高潮和低潮',
+    text: '查阅您的潮汐年鉴，获取您感兴趣的潮汐周期的时刻和高度。',
+  },
+  {
+    name: '在计算器中输入数据',
+    text: '输入高潮和低潮的时间和高度。工具将自动确定持续时间和潮差。',
+  },
+  {
+    name: '设置查询时间',
+    text: '调整您想要了解水位的时间。您将在图表上看到突出显示的准确点。',
+  },
+  {
+    name: '分析十二分之一法则表格',
+    text: '查看逐小时详解，以了解水位在整个期间内将如何波动。',
+  },
+];
+
+const bibliography: TideCalculatorLocaleContent['bibliography'] = [
+  {
+    name: 'Puertos del Estado - Tide Prediction',
+    url: 'https://portus.puertos.es/#/',
+  },
+  {
+    name: 'Instituto Hidrografico de la Marina',
+    url: 'https://armada.defensa.gob.es/ihm/',
+  },
+];
+
+const seo: TideCalculatorLocaleContent['seo'] = [
+  {
+    type: 'title',
+    text: '掌握潮汐：航海中的十二分之一法则',
+    level: 2,
+  },
+  {
+    type: 'paragraph',
+    html: '沿岸航行和进入水深有限的港口需要随时准确了解水深。虽然现在已有提供实时数据的数字应用程序和 GPS，但<strong>十二分之一法则</strong>仍然是任何业余或专业航海人员培训中的基础工具。这一法则是数学估算方法，让您无需复杂计算器即可近似计算潮汐周期中任意点的潮汐高度。',
+  },
+  {
+    type: 'title',
+    text: '究竟什么是十二分之一法则？',
+    level: 3,
+  },
+  {
+    type: 'paragraph',
+    html: '十二分之一法则是基于潮汐流非恒定的观察。在满潮和干潮之间的约六小时内，水位的上涨或下降速度并不一致。相反，其运动遵循正弦曲线。在第一个小时内潮汐移动缓慢；在中间小时内加速，并在接近下一个极端点时再次放缓。',
+  },
+  {
+    type: 'table',
+    headers: ['周期小时', '比例', '流动态征'],
+    rows: [
+      ['<strong>第 1 小时</strong>', '潮差的 1/12', '缓慢开始（平潮期）'],
+      ['<strong>第 2 小时</strong>', '潮差的 2/12', '流速加快'],
+      ['<strong>第 3 小时</strong>', '潮差 of 3/12', '最大流速（强潮汐）'],
+      ['<strong>第 4 小时</strong>', '潮差 of 3/12', '持续流速'],
+      ['<strong>第 5 小时</strong>', '潮差的 2/12', '显著减速'],
+      ['<strong>第 6 小时</strong>', '潮差的 1/12', '最后放缓（趋向平潮）'],
+    ],
+  },
+  {
+    type: 'title',
+    text: '技术限制：影响实际潮汐的因素',
+    level: 3,
+  },
+  {
+    type: 'glossary',
+    items: [
+      { term: '大气压力', definition: '低压使海平面升高；高压使其降低。一般规则是，气压相对于平均值每变化 1 hPa，海平面变动约 1 cm。' },
+      { term: '沿岸风', definition: '持续的向岸风会将海水推高，超过潮汐表预测的水平。' },
+      { term: '局部地形', definition: '海岸形状、海床深度以及河口的存在会显著延迟或加速潮汐流。' },
+    ],
+  },
+  {
+    type: 'tip',
+    title: '安全提示',
+    html: '本工具使用数学估算方法。它不考虑气象因素或局部地形。对于实际航行，请始终参考官方潮汐表。',
+  },
+  {
+    type: 'title',
+    text: '新手海员的关键概念',
+    level: 3,
+  },
+  {
+    type: 'glossary',
+    items: [
+      {
+        term: '潮差 (Tidal range)',
+        definition: '高潮与低潮之间的垂直高度差。在某些海湾可达数米；在地中海则几乎可以忽略不计。',
+      },
+      {
+        term: '潮汐持续时间',
+        definition: '高潮与下一次低潮之间的时间间隔。通常约为 6 小时 12 分钟（半日潮周期）。',
+      },
+      {
+        term: '海图基准面 (Chart datum)',
+        definition: '测量航海图上所有深度的参考基准。实际水深几乎从不低于所示水深。',
+      },
+    ],
+  },
+];
+
+const schemas: TideCalculatorLocaleContent['schemas'] = [
+  {
+    '@context': 'https://schema.org',
+    '@type': 'SoftwareApplication',
+    name: title,
+    description,
+    applicationCategory: 'UtilityApplication',
+    operatingSystem: 'Web',
+    offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  } as WithContext<SoftwareApplication>,
+  {
+    '@context': 'https://schema.org',
+    '@type': 'FAQPage',
+    mainEntity: faq.map((item) => ({
+      '@type': 'Question',
+      name: item.question,
+      acceptedAnswer: { '@type': 'Answer', text: item.answer },
+    })),
+  } as WithContext<FAQPage>,
+  {
+    '@context': 'https://schema.org',
+    '@type': 'HowTo',
+    name: `使用方法： ${title}`,
+    step: howTo.map((s) => ({ '@type': 'HowToStep', name: s.name, text: s.text })),
+  } as WithContext<HowTo>,
+];
+
+export const content: TideCalculatorLocaleContent = {
+  slug,
+  title,
+  description,
+  ui,
+  seo,
+  faq,
+  bibliography,
+  howTo,
+  schemas,
+};

package/src/tool/tideCalculator/index.ts

@@ -37,6 +37,18 @@ export const tideCalculator: NauticalToolEntry<TideCalculatorUI> = {
     es: () => import('./i18n/es').then((m) => m.content),
     en: () => import('./i18n/en').then((m) => m.content),
     fr: () => import('./i18n/fr').then((m) => m.content),
+    de: () => import('./i18n/de').then((m) => m.content),
+    id: () => import('./i18n/id').then((m) => m.content),
+    it: () => import('./i18n/it').then((m) => m.content),
+    ja: () => import('./i18n/ja').then((m) => m.content),
+    ko: () => import('./i18n/ko').then((m) => m.content),
+    nl: () => import('./i18n/nl').then((m) => m.content),
+    pl: () => import('./i18n/pl').then((m) => m.content),
+    pt: () => import('./i18n/pt').then((m) => m.content),
+    ru: () => import('./i18n/ru').then((m) => m.content),
+    sv: () => import('./i18n/sv').then((m) => m.content),
+    tr: () => import('./i18n/tr').then((m) => m.content),
+    zh: () => import('./i18n/zh').then((m) => m.content),
   },
 };