HovercraftAPI v0.2.0: 3Dダイナミックトランジション

HovercraftAPIは、Markdownファイルから印象的なHovercraftプレゼンテーションを簡単に作成するためのPythonツールです。v0.2.0では、多くの画期的な新機能が追加され、プレゼンテーション作成の可能性が無限に広がりました。

## デモ動画

<blockquote class="twitter-tweet" data-media-max-width="800"><p lang="ja" dir="ltr">いけた！！3Dダイナミックトランジション＋マーメイドの図の挿入までできるスライド作成APIがほぼ完了！！！<a href="https://twitter.com/hashtag/HovercraftAPI?src=hash&amp;ref_src=twsrc%5Etfw">#HovercraftAPI</a> <a href="https://t.co/OKLxo5o3rF">https://t.co/OKLxo5o3rF</a> <a href="https://t.co/E37SCT3Avf">pic.twitter.com/E37SCT3Avf</a></p>&mdash; Maki@Sunwood AI Labs. (@hAru_mAki_ch) <a href="https://twitter.com/hAru_mAki_ch/status/1817900746194776276?ref_src=twsrc%5Etfw">July 29, 2024</a></blockquote> 

## インストール方法

HovercraftAPIのインストールは非常に簡単です。以下のコマンドを使用してください：

```bash
pip install hovercraft-api
```

## 主要機能

### LLMによる自動スライド変換

HovercraftAPI v0.2.0の最大の特徴は、LLM（大規模言語モデル）を活用して、通常のマークダウン形式の文書を自動的にスライド形式に変換する機能です。

```mermaid
%%{init:{'theme':'base'}}%%
graph LR
    A[マークダウン記事] --> B[LLM]
    B --> C[スライド形式マークダウン]
    C --> D[HovercraftAPI]
    D --> E[HTMLプレゼンテーション]
```

### 3Dダイナミックトランジション

v0.2.0の目玉機能として、3Dダイナミックトランジションが導入されました。スライドが3D空間内で動的に配置され、印象的なアニメーションで遷移します。

### Mermaidダイアグラムの強化

Mermaidダイアグラムのサポートが大幅に強化され、自動的にSVGに変換されるようになりました。さらに、これらのSVGにアニメーションを追加する機能も実装されています。

### コードブロックのサポート

Mermaid以外のコードブロックも適切に表示されるようになりました。

### カスタムCSSによるスタイリング

プレゼンテーションのスタイルをカスタムCSSで自由にカスタマイズできます。


## インストール

まずは、HovercraftAPIをインストールしましょう。コマンドラインで以下のコマンドを実行します。

```bash
pip install hovercraft-api
```

## 基本的な使い方

### コマンドラインインターフェース

基本的な使用方法：
```bash
hovercraftapi example/README.md -c css/mytheme.css
```

3Dダイナミックトランジションを有効にする場合：
```bash
hovercraft-api example/README.md -c css/mytheme.css --enable-dynamic-position
```

### Pythonスクリプト内での使用

```python
from hovercraft_api import HovercraftAPI

api = HovercraftAPI("your_markdown_file.md", css_file="path/to/your/custom.css", enable_dynamic_position=True)
api.generate_slides()
```

## 豊富なカスタマイズオプション

HovercraftAPI v0.2.0では、プレゼンテーションをより細かくコントロールするための多くのカスタマイズオプションが追加されました。

- `--grid-width`, `--grid-height`, `--grid-depth`: 3D空間のサイズを指定
- `--slide-width`, `--slide-height`: 各スライドのサイズを設定
- `--enable-dynamic-position`: 動的な位置決めを有効にする
- `--use-rotate-x`, `--use-rotate-y`, `--use-rotate-z`: 各軸での回転を有効にする

```mermaid
%%{init:{'theme':'base'}}%%
graph TD
    A[HovercraftAPI] --> B[グリッドサイズ設定]
    A --> C[スライドサイズ設定]
    A --> D[3Dダイナミックトランジション]
    A --> E[回転設定]
```

## 開発環境のセットアップ

HovercraftAPIはPoetryを使用して依存関係を管理しています。開発環境のセットアップは以下のコマンドで行えます：

```bash
poetry install
```

## プレビューと共有

### ローカルプレビュー

生成されたプレゼンテーションをローカルでプレビューするには：

```bash
python hovercraft_api/mermaid_server.py
```

### 共有

生成されたHTMLファイルとアセットをウェブサーバーにアップロードすることで、プレゼンテーションを他の人と共有できます。

## まとめ

HovercraftAPI v0.2.0は、通常の文書を魅力的で動的なプレゼンテーションに変換する革新的なツールです。LLMによる自動変換、3Dダイナミックトランジション、強化されたMermaidダイアグラムのサポート、そして豊富なカスタマイズオプションにより、プレゼンテーション作成のプロセスが大幅に効率化され、より創造的で印象的な表現が可能になりました。

是非HovercraftAPI v0.2.0を使って、あなたのプレゼンテーションを次のレベルに引き上げてください！

## リポジトリ

https://github.com/Sunwood-ai-labs/HovercraftAPI

## リリースノート

https://github.com/Sunwood-ai-labs/HovercraftAPI/releases/tag/v0.2.0

<script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>