Giter VIP home page Giter VIP logo

website's People

Contributors

abn avatar alejandro-angulo avatar b-kamphorst avatar branchvincent avatar finswimmer avatar hozn avatar jenskeiner avatar johnthagen avatar juhoautio avatar lafrenierejm avatar mkniewallner avatar neersighted avatar onerandomusername avatar pabloemidio avatar pre-commit-ci[bot] avatar radoering avatar riconnon avatar sdispater avatar secrus avatar sryabkov avatar tenzer avatar wagnerluis1982 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

website's Issues

Can't build website locally

The local development instructions don't work for me.

When I run make site, eventually I get the following error:

[Errno 2] No such file or directory: 'content/docs/1.2'

A similar issue #36 was reported and closed without a documented solution.

Full terminal output:

$ make site
npm install
npm WARN deprecated [email protected]: Modern JS already guarantees Array#sort() is a stable sort, so this library is deprecated. See the compatibility table on MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort#browser_compatibility
npm WARN deprecated @babel/[email protected]: 🚨 This package has been deprecated in favor of separate inclusion of a polyfill and regenerator-runtime (when needed). See the @babel/polyfill docs (https://babeljs.io/docs/en/babel-polyfill) for more information.
npm WARN deprecated [email protected]: core-js@<3.23.3 is no longer maintained and not recommended for usage due to the number of issues. Because of the V8 engine whims, feature detection in old core-js versions could cause a slowdown up to 100x even if nothing is polyfilled. Some versions have web compatibility issues. Please, upgrade your dependencies to the actual version of core-js.

added 876 packages, and audited 877 packages in 10s

99 packages are looking for funding
  run `npm fund` for details

17 vulnerabilities (1 low, 6 moderate, 10 high)

To address issues that do not require attention, run:
  npm audit fix

To address all issues possible (including breaking changes), run:
  npm audit fix --force

Some issues need review, and may require choosing
a different dependency.

Run `npm audit` for details.
poetry install
The currently activated Python version 3.8.10 is not supported by the project (^3.10).
Trying to find and use a compatible version. 
Using python3 (3.10.10)
Creating virtualenv website-S2P53JhW-py3.10 in /home/isme/.cache/pypoetry/virtualenvs
Installing dependencies from lock file

Package operations: 23 installs, 1 update, 0 removals

  β€’ Installing idna (3.3)
  β€’ Installing sniffio (1.3.0)
  β€’ Installing anyio (3.6.1)
  β€’ Installing certifi (2022.6.15)
  β€’ Installing distlib (0.3.6)
  β€’ Installing filelock (3.8.0)
  β€’ Installing h11 (0.12.0)
  β€’ Installing platformdirs (2.5.2)
  β€’ Updating setuptools (65.7.0 -> 65.3.0)
  β€’ Installing cfgv (3.3.1)
  β€’ Installing crashtest (0.3.1)
  β€’ Installing httpcore (0.15.0)
  β€’ Installing identify (2.5.3)
  β€’ Installing nodeenv (1.7.0)
  β€’ Installing pylev (1.4.0)
  β€’ Installing pyyaml (6.0)
  β€’ Installing rfc3986 (1.5.0)
  β€’ Installing toml (0.10.2)
  β€’ Installing virtualenv (20.16.4)
  β€’ Installing cleo (1.0.0a5)
  β€’ Installing httpx (0.23.0)
  β€’ Installing pre-commit (2.20.0)
  β€’ Installing tomli (2.0.1)
  β€’ Installing tomli-w (1.0.0)
poetry run ./bin/website configure 
The currently activated Python version 3.8.10 is not supported by the project (^3.10).
Trying to find and use a compatible version. 
Using python3 (3.10.10)
poetry run ./bin/website docs pull 
The currently activated Python version 3.8.10 is not supported by the project (^3.10).
Trying to find and use a compatible version. 
Using python3 (3.10.10)

  Pulling documentation for version 1.3 as 1.3
Cloning into '.'...
fatal: cannot change to 'https://github.com/python-poetry/poetry.git': No such file or directory
error: failed to initialize sparse-checkout
fatal: not a git repository (or any of the parent directories): .git
fatal: not a git repository (or any of the parent directories): .git

  Pulling documentation for version 1.2 as 1.2
Cloning into '.'...
fatal: cannot change to 'https://github.com/python-poetry/poetry.git': No such file or directory
error: failed to initialize sparse-checkout
fatal: not a git repository (or any of the parent directories): .git
fatal: not a git repository (or any of the parent directories): .git

[Errno 2] No such file or directory: 'content/docs/1.2'
make: *** [Makefile:26: content/docs] Error 1
$ python --version
Python 3.10.10
$ node --version
v18.14.0
$ poetry run bin/website docs pull
The currently activated Python version 3.8.10 is not supported by the project (^3.10).
Trying to find and use a compatible version. 
Using python3 (3.10.10)

  Pulling documentation for version 1.3 as 1.3
Cloning into '.'...
fatal: cannot change to 'https://github.com/python-poetry/poetry.git': No such file or directory
error: failed to initialize sparse-checkout
fatal: not a git repository (or any of the parent directories): .git
fatal: not a git repository (or any of the parent directories): .git

  Pulling documentation for version 1.2 as 1.2
Cloning into '.'...
fatal: cannot change to 'https://github.com/python-poetry/poetry.git': No such file or directory
error: failed to initialize sparse-checkout
fatal: not a git repository (or any of the parent directories): .git
fatal: not a git repository (or any of the parent directories): .git

[Errno 2] No such file or directory: 'content/docs/1.2'

Environment:

  • OS: Ubuntu 20.04
  • Node version: v18.14.0
  • Python version: 3.10.10

Errors while setting up local dev environment

What did I do ?

I followed the instructions as given on the readme:

  1. Forked this repository
  2. Cloned your fork locally
  3. Ran make site

What's the error ?

make: poetry: Command not found
Makefile:19: recipe for target 'content/docs' failed

Which machine am I using ?

I am on a Zorin OS (debian based) machine.

Extra information

Following is the output of running make site:

╰─❯ make site                                                                         ─╯
npm install
npm WARN deprecated [email protected]: core-js@<3.4 is no longer maintained and not recommended for usage due to the number of issues. Because of the V8 engine whims, feature detection in old core-js versions could cause a slowdown up to 100x even if nothing is polyfilled. Please, upgrade your dependencies to the actual version of core-js.
npm WARN deprecated @babel/[email protected]: 🚨 This package has been deprecated in favor of separate inclusion of a polyfill and regenerator-runtime (when needed). See the @babel/polyfill docs (https://babeljs.io/docs/en/babel-polyfill) for more information.

added 859 packages, and audited 860 packages in 47s

86 packages are looking for funding
  run `npm fund` for details

22 vulnerabilities (13 moderate, 9 high)

To address issues that do not require attention, run:
  npm audit fix

Some issues need review, and may require choosing
a different dependency.

Run `npm audit` for details.
npm notice 
npm notice New minor version of npm available! 8.3.1 -> 8.15.0
npm notice Changelog: https://github.com/npm/cli/releases/tag/v8.15.0
npm notice Run npm install -g [email protected] to update!
npm notice 
poetry install
make: poetry: Command not found
Makefile:19: recipe for target 'content/docs' failed
make: *** [content/docs] Error 127

Missing official documentation for creating Dockerfiles and CI pipelines

I wanted to migrate my pipenv project to poetry. I managed to do this for local setup, however I had troubles configuring my dockerfile, as your website has absolutely no documentation about working with CI and containers (other than installation guide).

I have found this amazing stackoverflow answer: https://stackoverflow.com/a/54763270/17101184 and I'm wondering why this info isn't available in the official documentation. Your documentation describes each configuration flag in detail, but gives no guide for common usage cases, like working in docker (recommending flags like POETRY_VIRTUALENVS_CREATE=false).

current version?

I want to get started with poetry, but I am unsure which is the current version.
The website offers docs for master, 1.1 and 1.2 in one part, without saying something about the state of each.

In another part it says 1.1 is "stable" and "master" is development, but not what 1.2 is.

Digging a bit deeper 1.2 seems to be on the way to be released, or is it already?

Can someone explain/help me? Thanks in advance!

Search broken because app is blocked by Algolia

It seems that something is wrong with the algolia account. Requests to the provider return 403:

{
    "message": "This operation cannot be processed, the application is blocked. Contact us to unblock it.",
    "status": 403
}

This of course results in the search not working as no search results are available

image

Dropdown menu and dark and light theme switch not work

image

  • The dropdown button is not working which makes the user cannot choose docs version (1.1 or master)
  • dark and light theme switch are not working also

Test in Windows 10 Brave Browser and Edge Browser, also on Android

Keep documentation for old versions

Currently, the official website provides a version selection button for 3 versions of the documentation: master, 1.5 and 1.4.

Some Linux distribution uses older versions in their packages. For instance the latest Debian stable, released this June, uses version 1.3.2.
Please keep older versions of the documentation accessible on the official website.

Alternative installation methods are presented as steps

EDIT: I misread the docs! There are two alternative installation methods, not three.

To install poetry with pipx, there are two alternative installation methods, depending on how much control you need over versioning. You only want to use one of these alternatives. However, these two alternatives look like two steps, which you're supposed to do one after the other.

Screenshot of Poetry docs with alternative pipx installation methods which are numbered 1, 2, 3

It's a similar story for the 'With the official installer' tab.

Perhaps, instead of:

β”œ1
β”œ2
β””3

We could organise it as:

β”œ1
β””2
 β”œOption A
 β””Option B

Cannot retrive poetry docs with `poerty run .bin/website docs pull`

Hello I try to build the website locally, but cannot pull the docs:

website [🐍 v3.10.3(website-DvCDHzbR-py3.10)]
❯❯❯ poetry run ./bin/website docs pull

  Pulling documentation for version 1.1 as 1.1
Cloning into '.'...
fatal: cannot change to 'https://github.com/python-poetry/poetry.git': No such file or directory
error: failed to initialize sparse-checkout
fatal: not a git repository (or any of the parent directories): .git
fatal: not a git repository (or any of the parent directories): .git

  Pulling documentation for version master
Cloning into '.'...
fatal: cannot change to 'https://github.com/python-poetry/poetry.git': No such file or directory
error: failed to initialize sparse-checkout
fatal: not a git repository (or any of the parent directories): .git
fatal: not a git repository (or any of the parent directories): .git

I try this at Windows 10 and WSL Ubuntu 20.04
Any advice on building website locally, Thank you ❀️

Configure Hugo to allow copying code blocks to clipboard

  • I have searched the issues of this repo and believe that this is not a duplicate.

Issue

Many static site generators support a copy-to-clipboard button for code blocks. For example, see a Material for Mkdocs example:

GitHub also supports this, for example hover over the code blocks here:

This is especially useful for new users who want to quickly copy out commands such as the installation command that doesn't all fit on the screen at once.

It doesn't seem like this is something that Hugo supports out of the box unfortunately, but there are several guides on it:

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.