gitbook icon indicating copy to clipboard operation
gitbook copied to clipboard

Invalid URL in the path, should start with a domain

Open liaochangjian opened this issue 1 year ago • 9 comments

Bug description

when I Start my local development server. and Then open the space in your web browser, using http://localhost:3000/.

prompt : Invalid URL in the path, should start with a domain

I can't enter the main pages.

help me please.

liaochangjian avatar Jun 05 '24 07:06 liaochangjian

Hi @liaochangjian - this could definitely be documented a bit more. You'll need to include the published space url (of a space you have permissions in) after the local version - for instance, you could put something like:

http://localhost:3000/docs.gitbook.com

addisonschultz avatar Jun 05 '24 12:06 addisonschultz

Hi @liaochangjian - this could definitely be documented a bit more. You'll need to include the published space url (of a space you have permissions in) after the local version - for instance, you could put something like:

http://localhost:3000/docs.gitbook.com

how to make this space, that is, a convenient cms for updating content is not publicly available?

POMXARK avatar Jun 15 '24 09:06 POMXARK

@POMXARK - you'll still need to publish the space, but you could do so using a private/share link!

addisonschultz avatar Jun 17 '24 08:06 addisonschultz

what's the proper way to render my "local" gitbook content by using the server locally ?

edsiper avatar Jul 12 '24 16:07 edsiper

Hey @edsiper The content needs to be published in some way first - afterwards, you can direct traffic to the local version as so: https://github.com/GitbookIO/gitbook?tab=readme-ov-file#set-up

For instance:

Then open the space in your web browser, using http://localhost:3000// (example: http://localhost:3000/docs.gitbook.com).

addisonschultz avatar Jul 16 '24 01:07 addisonschultz

@addisonschultz, how will the service know where my local GIT repository exists in my filesystem ?

edsiper avatar Jul 25 '24 02:07 edsiper

@edsiper It's linked to the published version - meaning the editing experience doesn't change (online in the editor, or through GitSync)

TLDR; it's linked to the published part, not the content part

addisonschultz avatar Jul 25 '24 08:07 addisonschultz

There is no local installation guide available, I totally dont konw how to make it possiabe to creat custom page. Or it seems no longer support after gitbook cilent was deprecated. We can only edit them via gitbook webapp? When I try to build my local page client via main branch, I can not make it work at all.🥲

hoshiizumiya avatar Aug 04 '24 10:08 hoshiizumiya

I filed issue "OSS User Experience" #2419 to discuss local. offline mode and others

edsiper avatar Aug 05 '24 22:08 edsiper

Closing this as #2419 contains the most up to date information on fixing the developer experience of this repo

addisonschultz avatar Jul 01 '25 11:07 addisonschultz