Open, look at and save a file
The Editor page shows the files of a Project in your browser. You read a document, fix a line or upload a file without opening another program.
Before you start
- The editor must be switched on for your organization. When you do not see Editor in the menu, ask your administrator.
- You need access to the Project whose files you want to see.
Open a file
- Choose Editor in the main menu.
- Pick a Project at the top. Your permissions decide which files you can see and change.
- Choose the root: Project for the folder of the Project itself, or System for the whole environment.
- Click a file in the tree. It opens in Edit; Preview shows it as it looks and Diff compares it with the last saved version.
Right-click a file or folder, or use the File menu, for New file, New folder, Rename, Create a copy, Delete and Copy path. Upload files… adds files to the selected folder, and files can be dragged into the tree. Save writes your changes.
Right-click a file or folder (on a touch screen, press and hold it; on a keyboard, press the Menu key or Shift+F10), or use the file menu, to create a new file or folder, rename, create a copy, delete or copy a path. Uploads go to the selected folder.
Look at a file
Markdown, pictures, PDF, audio, video, CSV and Office documents get a preview. A long CSV shows its first rows and says how many it shows. Anything else can be downloaded instead.
Change how the editor looks
Word wrap, the Minimap, text size, indentation and fullscreen sit in the view menu. On a computer the menu bar stays visible; on a phone the same choices are in Actions.
On a phone
The editor fills the screen and keeps the same Project picker at the top. Files and Save stay in a single touch row, and Actions holds the rest.
Keep or lose unsaved changes
Unsaved changes stay visible while a save runs. Closing an edited tab asks first, and so does changing the root.
Warning: Switching to another Project in the picker does not ask and drops unsaved changes. Save first.
Choose a Project icon
- Open the Project drawer and its Overview tab.
- Select the pencil button in the Icon row (tooltip: Choose icon) and pick an image. It then appears on Project cards and pills.
Read the commit history
The Git section of the Project drawer shows the newest few commits of the Project.
- Choose Show all in the commits section. The whole history unfolds right there, fifty commits at a time, and the next fifty are read when you scroll to the end of the list.
- Choose Show less to fold it back. The last line says when the history has ended.
A read that fails is named in the same section with Retry, which reads that page again.
Work on a connected computer
The files of a Project can live on a connected computer. The editor then shows them straight from that computer, so keep Chetty running on it; while it is offline the editor says the connection is not available instead of the files. When the editor asks you to update Chetty on that computer, ask your administrator.
What the editor can open
- Text files up to 2 MiB. A bigger file says it is too large to edit; a binary file says it cannot be edited here.
- Pictures, PDF and media up to 50 MiB, Office documents up to 20 MiB.
- Uploads are offered only under Project, not under System.
- A folder on the server that is not a Git repository says so in place of the commit history. A Project in a managed environment or on a connected computer shows nothing about Git in that case.
When saving fails
If another change replaced the file in the meantime, the editor says so. Look at the latest version, put your edits into it and save again.
Download a file
Download saves the file to your computer. Large files are streamed, so a long download may take a while.