semvec/pypi-packages huggingface dataset:
ali-phinx-rtd-theme 1.1.2a1
Read the Docs theme for Sphinx
License: MIT
Requires Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,>=2.7

**************************
Read the Docs Sphinx Theme
**************************

.. image:: https://img.shields.io/pypi/v/sphinx_rtd_theme.svg
   :target: https://pypi.python.org/pypi/sphinx_rtd_theme
   :alt: Pypi Version
.. image:: https://circleci.com/gh/readthedocs/sphinx_rtd_theme.svg?style=svg
   :alt: Build Status
   :target: https://circleci.com/gh/readthedocs/sphinx_rtd_theme
.. image:: https://img.shields.io/pypi/l/sphinx_rtd_theme.svg
   :target: https://pypi.python.org/pypi/sphinx_rtd_theme/
   :alt: License
.. image:: https://readthedocs.org/projects/sphinx-rtd-theme/badge/?version=latest
  :target: http://sphinx-rtd-theme.readthedocs.io/en/latest/?badge=latest
  :alt: Documentation Status

This Sphinx_ theme was designed to provide a great reader experience for
documentation users on both desktop and mobile devices. This theme is used
primarily on `Read the Docs`_ but can work with any Sphinx project. You can find
a working demo of the theme in the `theme documentation`_

.. _Sphinx: http://www.sphinx-doc.org
.. _Read the Docs: http://www.readthedocs.org
.. _theme documentation: https://sphinx-rtd-theme.readthedocs.io/en/stable/

Installation
============

This theme is distributed on PyPI_ and can be installed with ``pip``:

.. code:: console

   $ pip install sphinx-rtd-theme

To use the theme in your Sphinx project, you will need to edit
your ``conf.py`` file's ``html_theme`` setting:

.. code:: python

    html_theme = "sphinx_rtd_theme"

.. admonition:: See also:

    `Supported browsers`_
        Officially supported and tested browser/operating system combinations

    `Supported dependencies`_
        Supported versions of Python, Sphinx, and other dependencies.

    `Example documentation`_
        A full example of this theme output, with localized strings enabled.

.. _PyPI: https://pypi.python.org/pypi/sphinx_rtd_theme
.. _Supported browsers: https://sphinx-rtd-theme.readthedocs.io/en/stable/development.html#supported-browsers
.. _Supported dependencies: https://sphinx-rtd-theme.readthedocs.io/en/stable/development.html#supported-dependencies
.. _Example documentation:  https://sphinx-rtd-theme.readthedocs.io/en/stable/

Configuration
=============

This theme is highly customizable on both the page level and on a global level.
To see all the possible configuration options, read the documentation on
`configuring the theme`_.

.. _configuring the theme: https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html

Contributing
============

If you would like to help modify or translate the theme, you'll find more
information on contributing in our `contributing guide`_.

.. _contributing guide: https://sphinx-rtd-theme.readthedocs.io/en/stable/contributing.html
dirstory 0.1.1
Navigate through the directories via command line as in file manager!
License: MIT
Requires Python: >=3.7

# DIRectory hiSTORY

#### Navigate through the directories via command line as in file manager!

Have you ever wanted a back and forward button in your terminal to navigate back and forth?
Dirstory allows it!

### Short description

Dirstory allows you to move in previously visited directories just like in file manager.
It's very similar to navigating back and forth between web pages in your web browser.

## Table of contents

<!-- toc -->

- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
- [Contribution guidelines](#contribution-guidelines)

<!-- tocstop -->

## Requirements

- bash
- pip

## Installation

To install dirstory, you need to firstly install the cli and then run the post-install script via
command `dirstory install` to make the dirstory work properly.

### Installation of the cli

From PyPi:

```bash
$ pip install --user dirstory
```

Or you can install dirstory from the git repository:

```bash
$ pip install --user git+https://github.com/nikromen/dirstory
```

### Running the post-install script

After successful installation of the cli, run this command:

```bash
$ dirstory install
```

#### Note: what dirstory's post install script does

Please note that dirstory needs to add additional functionality to the built-in shell command
`cd` to trace in which directories have you been to redirect you there later.

If you already added some functionality to the built-in `cd` command, it's very likely that dirstory
or your script won't work. In that case, please check out the
[redefinition of the `cd` command that dirstory does](https://github.com/nikromen/dirstory/blob/main/dirstory/scripts/_dirstorypatch)
and you will need to merge this script with yours.

##### How to find location of [\_dirstorypatch](https://github.com/nikromen/dirstory/blob/main/dirstory/scripts/_dirstorypatch)

See the location of this script in your `~/.bashrc` file. There should be a block added by
dirstory with line: `source /some/path/to/the/_dirstorypatch`. You can edit this to make your
and dirstory's script work properly.

## Usage

dirstory consist of two main commands

- [b](#b)
- [f](#f)

### b

```
Goes to a previously visited directories.

Options:
    INTEGER     Goes back by N steps.
    -l INTEGER  Show last N directiories where you were.
    --help      Show this message and exit.
```

### f

```
Goes to a previously backed directories.

Options:
    INTEGER     Goes forward by N steps.
    -l INTEGER  Show last N directiories which you backed.
    --help      Show this message and exit.
```

---

If you want to go back by one step, just simply use:

```bash
$ b
```

and similarly to go forward by one step:

```bash
$ f
```

## Contribution guideline

TODO