share

Sharing Files

Use sharing to make a file or directory visible to the world.

Publishing Files

You can make individual files and folders public. First, do either of the following:

• With the file open, click the info icon , then in the menu that drops down, click Share.
• In the Files listing for your project, check the box in the leftmost column for your file, and click Share.

After either of these steps, you may enter a description for the file being shared, then click Make item public and your file is shared.

Using the Share Server

After clicking Make item public as above, a URL will be displayed under Shared publicly. With that link, your file is available read-only on the CoCalc lightweight share server. A CoCalc login is not needed to access files on the share server. Files on the share server are indexed by Google unless you click the checkbox next to "Unlisted: Only allow those with a link to view this."

Directly sharing files from your project

You have another choice after making a file public as in the first section above. For instances when you simply want to copy files between projects, use the exact URL of the file in your project as shown at the top of your browser. This link is slower to load, but other users can easily copy files to their own CoCalc projects by doing the following:

• Log into CoCalc and open the project link to a shared file.
• Open the Files list for the shared project, i.e. in the tab for the shared file, click the Files button at upper left.
• Click Copy, then under In the project, select the destination project and under Destination select the destination folder for the copy of the shared file.

Note that, unlike URLs for the share server, the project containing the shared file must be running for project URL's to work. Since it can take several seconds for a project to start running, this can introduce an additional delay when viewing such files.

File-sharing Tips

• If your document depends on auxiliary files (e.g., images embedded in a markdown file) make sure these auxiliary files are also published. A convenient way to do this is to have auxiliary files in a common folder and share that folder.

• Serving raw files - you can host arbitrary html, etc. through the share server. Files can be viewed in "raw" form, i.e. without CoCalc controls, by opening in the share server and clicking "Raw" at upper right, or by removing the parameter setting ?viewer=share from the share server URL for the file.

NOTE: If you would like to collaborate and chat with other people on documents in your project, go the project Settings tab and "Add people to project".