semvec/pypi-packages huggingface dataset:
channel-app 0.0.96
Channel app for Sales Channels
Requires Python: >=3.5

# Sphinx Documentation Management

Follow the steps below to manage the Sphinx documentation:

```
cd docs
make clean # If clean is not run, 'make html' only builds the differences 
make html
```

Then you can access the documentation via `docs/build/html/index.html`

Link on how to publish the docs on ReadTheDocs:
https://sphinx-rtd-tutorial.readthedocs.io/en/latest/read-the-docs.html


## Multiple Languages

Documentation is written in Turkish but the docstring language is obviously in English.
Because of this, translation gets very complex. If we follow the steps below, it would make the
translation process simpler. Because in the current scenario, 
docstring texts are also put in .po files, if source language 
is Turkish, .po files will contain both Turkish and English text.

If I were to make this documentation support multiple languages, I would first translate it to English,
store the original Turkish language docs somewhere, use the main language as English and generate 
translation files from English and set target language as Turkish. 
I would then paste the translations to Turkish language files, build and complete.
If new languages are requested, I would set that target language, fill the .po files, build and complete.


### Multiple Language Command Steps
Run all the commands below in the `docs/` folder.

Documentation has its separate requirements.txt file you must install them to run some of the commands below.
It is also recommended to pin the Sphinx version in the `docs/requirements.txt`
```
pip install -r requirements.txt
```

You can update the main language by updating `docs/conf.py`

```python
language = 'tr'
# language = 'en'
```

Extract translatable messages into .pot files.
```
make gettext
```

Set English and German as the target language and generate .po files from the .pot files.
```
sphinx-intl update -p build/gettext -l en -l de
```

Now you can access the .po files from `docs/locale/<language>/LC_MESSAGES/*` 

After the translation is done, you need to run `make html` with specific parameters so that
documentation is built into the target language.

```
make -e SPHINXOPTS="-D language='de'" html
```
simple-homepage 0.0.6
Command line utility that helps you create a simple static homepage for your browser
Requires Python: >=3.8,<3.11

# simple-homepage

[![Release](https://img.shields.io/github/v/release/fpgmaas/simple-homepage)](https://img.shields.io/github/v/release/fpgmaas/simple-homepage)
[![Build status](https://img.shields.io/github/workflow/status/fpgmaas/simple-homepage/merge-to-main)](https://img.shields.io/github/workflow/status/fpgmaas/simple-homepage/merge-to-main)
[![Docs](https://img.shields.io/badge/docs-gh--pages-blue)](https://fpgmaas.github.io/simple-homepage/)
[![Code style with black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Imports with isort](https://img.shields.io/badge/%20imports-isort-%231674b1)](https://pycqa.github.io/isort/)
[![License](https://img.shields.io/github/license/fpgmaas/simple-homepage)](https://img.shields.io/github/license/fpgmaas/simple-homepage)

`simple-homepage` is a command line utility that helps you create a simple static homepage for your browser. The documentation can be found [here](https://fpgmaas.github.io/simple-homepage/).

### Light ([Link to demo](https://fpgmaas.github.io/simple-homepage/demo/light/homepage.html))


<img src="static/screenshot-light.png" alt="Example light homepage" width="500"/>

### Dark ([Link to demo](https://fpgmaas.github.io/simple-homepage/demo/dark/homepage.html))

<img src="static/screenshot-dark.png" alt="Example dark homepage" width="500"/>

## Quick start

To get started, first install the package:

```
pip install simple-homepage
```

Then, navigate to a directory in which you want to create your homepage, and run

```
homepage init
```

or, for the dark version of the homepage:

```
homepage init --dark
```

Then, modify `settings.yaml` to your liking, and run

```
homepage build
```

Your custom homepage is now available under `public/homepage.html`.

## Acknowledgements

Inspiration for this project comes from [this](https://www.reddit.com/r/startpages/comments/hca1dj/simple_light_startpage/) post on Reddit by [/u/akauro](https://www.reddit.com/user/akauro/).

---

Repository initiated with [fpgmaas/cookiecutter-poetry](https://github.com/fpgmaas/cookiecutter-poetry).